PKG-INFO 5.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144
  1. Metadata-Version: 1.0
  2. Name: requests-kerberos
  3. Version: 0.6.1
  4. Summary: A Kerberos authentication handler for python-requests
  5. Home-page: https://github.com/requests/requests-kerberos
  6. Author: Ian Cordasco, Cory Benfield, Michael Komitee
  7. Author-email: graffatcolmingov@gmail.com
  8. License: UNKNOWN
  9. Description: requests Kerberos/GSSAPI authentication library
  10. ===============================================
  11. Requests is an HTTP library, written in Python, for human beings. This library
  12. adds optional Kerberos/GSSAPI authentication support and supports mutual
  13. authentication. Basic GET usage:
  14. .. code-block:: pycon
  15. >>> import requests
  16. >>> from requests_kerberos import HTTPKerberosAuth
  17. >>> r = requests.get("http://example.org", auth=HTTPKerberosAuth())
  18. ...
  19. The entire ``requests.api`` should be supported.
  20. Authentication Failures
  21. -----------------------
  22. Client authentication failures will be communicated to the caller by returning
  23. the 401 response.
  24. Mutual Authentication
  25. ---------------------
  26. By default, ``HTTPKerberosAuth`` will require mutual authentication from the
  27. server, and if a server emits a non-error response which cannot be
  28. authenticated, a ``requests_kerberos.errors.MutualAuthenticationError`` will be
  29. raised. If a server emits an error which cannot be authenticated, it will be
  30. returned to the user but with its contents and headers stripped.
  31. OPTIONAL
  32. ^^^^^^^^
  33. If you'd prefer to not require mutual authentication, you can set your
  34. preference when constructing your ``HTTPKerberosAuth`` object:
  35. .. code-block:: pycon
  36. >>> import requests
  37. >>> from requests_kerberos import HTTPKerberosAuth, OPTIONAL
  38. >>> kerberos_auth = HTTPKerberosAuth(mutual_authentication=OPTIONAL)
  39. >>> r = requests.get("http://example.org", auth=kerberos_auth)
  40. ...
  41. This will cause ``requests_kerberos`` to attempt mutual authentication if the
  42. server advertises that it supports it, and cause a failure if authentication
  43. fails, but not if the server does not support it at all.
  44. DISABLED
  45. ^^^^^^^^
  46. While we don't recommend it, if you'd prefer to never attempt mutual
  47. authentication, you can do that as well:
  48. .. code-block:: pycon
  49. >>> import requests
  50. >>> from requests_kerberos import HTTPKerberosAuth, DISABLED
  51. >>> kerberos_auth = HTTPKerberosAuth(mutual_authentication=DISABLED)
  52. >>> r = requests.get("http://example.org", auth=kerberos_auth)
  53. ...
  54. Logging
  55. -------
  56. This library makes extensive use of Python's logging facilities.
  57. Log messages are logged to the ``requests_kerberos`` and
  58. ``requests_kerberos.kerberos_`` named loggers.
  59. If you are having difficulty we suggest you configure logging. Issues with the
  60. underlying kerberos libraries will be made apparent. Additionally, copious debug
  61. information is made available which may assist in troubleshooting if you
  62. increase your log level all the way up to debug.
  63. History
  64. =======
  65. 0.6.1: 2014-11-14
  66. -----------------
  67. - Fix HTTPKerberosAuth not to treat non-file as a file
  68. - Prevent infinite recursion when GSSErrors occurs
  69. 0.6: 2014-11-04
  70. ---------------
  71. - Handle mutual authentication (see pull request 36_)
  72. All users should upgrade immediately. This has been reported to
  73. oss-security_ and we are awaiting a proper CVE identifier.
  74. **Update**: We were issued CVE-2014-8650
  75. - Distribute as a wheel.
  76. .. _36: https://github.com/requests/requests-kerberos/pull/36
  77. .. _oss-security: http://www.openwall.com/lists/oss-security/
  78. 0.5: 2014-05-14
  79. ---------------
  80. - Allow non-HTTP service principals with HTTPKerberosAuth using a new optional
  81. argument ``service``.
  82. - Fix bug in ``setup.py`` on distributions where the ``compiler`` module is
  83. not available.
  84. - Add test dependencies to ``setup.py`` so ``python setup.py test`` will work.
  85. 0.4: 2013-10-26
  86. ---------------
  87. - Minor updates in the README
  88. - Change requirements to depend on requests above 1.1.0
  89. 0.3: 2013-06-02
  90. ---------------
  91. - Work with servers operating on non-standard ports
  92. 0.2: 2013-03-26
  93. ---------------
  94. - Not documented
  95. 0.1: Never released
  96. -------------------
  97. - Initial Release
  98. Platform: UNKNOWN