httpauth.h 2.9 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879
  1. /*
  2. * HTTP authentication
  3. * Copyright (c) 2010 Martin Storsjo
  4. *
  5. * This file is part of FFmpeg.
  6. *
  7. * FFmpeg is free software; you can redistribute it and/or
  8. * modify it under the terms of the GNU Lesser General Public
  9. * License as published by the Free Software Foundation; either
  10. * version 2.1 of the License, or (at your option) any later version.
  11. *
  12. * FFmpeg is distributed in the hope that it will be useful,
  13. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  15. * Lesser General Public License for more details.
  16. *
  17. * You should have received a copy of the GNU Lesser General Public
  18. * License along with FFmpeg; if not, write to the Free Software
  19. * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  20. */
  21. #ifndef AVFORMAT_HTTPAUTH_H
  22. #define AVFORMAT_HTTPAUTH_H
  23. /**
  24. * Authentication types, ordered from weakest to strongest.
  25. */
  26. typedef enum HTTPAuthType {
  27. HTTP_AUTH_NONE = 0, /**< No authentication specified */
  28. HTTP_AUTH_BASIC, /**< HTTP 1.0 Basic auth from RFC 1945
  29. * (also in RFC 2617) */
  30. HTTP_AUTH_DIGEST, /**< HTTP 1.1 Digest auth from RFC 2617 */
  31. } HTTPAuthType;
  32. typedef struct DigestParams {
  33. char nonce[300]; /**< Server specified nonce */
  34. char algorithm[10]; /**< Server specified digest algorithm */
  35. char qop[30]; /**< Quality of protection, containing the one
  36. * that we've chosen to use, from the
  37. * alternatives that the server offered. */
  38. char opaque[300]; /**< A server-specified string that should be
  39. * included in authentication responses, not
  40. * included in the actual digest calculation. */
  41. char stale[10]; /**< The server indicated that the auth was ok,
  42. * but needs to be redone with a new, non-stale
  43. * nonce. */
  44. int nc; /**< Nonce count, the number of earlier replies
  45. * where this particular nonce has been used. */
  46. } DigestParams;
  47. /**
  48. * HTTP Authentication state structure. Must be zero-initialized
  49. * before used with the functions below.
  50. */
  51. typedef struct HTTPAuthState {
  52. /**
  53. * The currently chosen auth type.
  54. */
  55. int auth_type;
  56. /**
  57. * Authentication realm
  58. */
  59. char realm[200];
  60. /**
  61. * The parameters specific to digest authentication.
  62. */
  63. DigestParams digest_params;
  64. /**
  65. * Auth ok, but needs to be resent with a new nonce.
  66. */
  67. int stale;
  68. } HTTPAuthState;
  69. void ff_http_auth_handle_header(HTTPAuthState *state, const char *key,
  70. const char *value);
  71. char *ff_http_auth_create_response(HTTPAuthState *state, const char *auth,
  72. const char *path, const char *method);
  73. #endif /* AVFORMAT_HTTPAUTH_H */