| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144 |
- Metadata-Version: 1.0
- Name: requests-kerberos
- Version: 0.6.1
- Summary: A Kerberos authentication handler for python-requests
- Home-page: https://github.com/requests/requests-kerberos
- Author: Ian Cordasco, Cory Benfield, Michael Komitee
- Author-email: graffatcolmingov@gmail.com
- License: UNKNOWN
- Description: requests Kerberos/GSSAPI authentication library
- ===============================================
-
- Requests is an HTTP library, written in Python, for human beings. This library
- adds optional Kerberos/GSSAPI authentication support and supports mutual
- authentication. Basic GET usage:
-
-
- .. code-block:: pycon
-
- >>> import requests
- >>> from requests_kerberos import HTTPKerberosAuth
- >>> r = requests.get("http://example.org", auth=HTTPKerberosAuth())
- ...
-
- The entire ``requests.api`` should be supported.
-
- Authentication Failures
- -----------------------
-
- Client authentication failures will be communicated to the caller by returning
- the 401 response.
-
- Mutual Authentication
- ---------------------
-
- By default, ``HTTPKerberosAuth`` will require mutual authentication from the
- server, and if a server emits a non-error response which cannot be
- authenticated, a ``requests_kerberos.errors.MutualAuthenticationError`` will be
- raised. If a server emits an error which cannot be authenticated, it will be
- returned to the user but with its contents and headers stripped.
-
- OPTIONAL
- ^^^^^^^^
-
- If you'd prefer to not require mutual authentication, you can set your
- preference when constructing your ``HTTPKerberosAuth`` object:
-
- .. code-block:: pycon
-
- >>> import requests
- >>> from requests_kerberos import HTTPKerberosAuth, OPTIONAL
- >>> kerberos_auth = HTTPKerberosAuth(mutual_authentication=OPTIONAL)
- >>> r = requests.get("http://example.org", auth=kerberos_auth)
- ...
-
- This will cause ``requests_kerberos`` to attempt mutual authentication if the
- server advertises that it supports it, and cause a failure if authentication
- fails, but not if the server does not support it at all.
-
- DISABLED
- ^^^^^^^^
-
- While we don't recommend it, if you'd prefer to never attempt mutual
- authentication, you can do that as well:
-
- .. code-block:: pycon
-
- >>> import requests
- >>> from requests_kerberos import HTTPKerberosAuth, DISABLED
- >>> kerberos_auth = HTTPKerberosAuth(mutual_authentication=DISABLED)
- >>> r = requests.get("http://example.org", auth=kerberos_auth)
- ...
-
- Logging
- -------
-
- This library makes extensive use of Python's logging facilities.
-
- Log messages are logged to the ``requests_kerberos`` and
- ``requests_kerberos.kerberos_`` named loggers.
-
- If you are having difficulty we suggest you configure logging. Issues with the
- underlying kerberos libraries will be made apparent. Additionally, copious debug
- information is made available which may assist in troubleshooting if you
- increase your log level all the way up to debug.
-
-
- History
- =======
-
- 0.6.1: 2014-11-14
- -----------------
-
- - Fix HTTPKerberosAuth not to treat non-file as a file
-
- - Prevent infinite recursion when GSSErrors occurs
-
- 0.6: 2014-11-04
- ---------------
-
- - Handle mutual authentication (see pull request 36_)
-
- All users should upgrade immediately. This has been reported to
- oss-security_ and we are awaiting a proper CVE identifier.
-
- **Update**: We were issued CVE-2014-8650
-
- - Distribute as a wheel.
-
- .. _36: https://github.com/requests/requests-kerberos/pull/36
- .. _oss-security: http://www.openwall.com/lists/oss-security/
-
- 0.5: 2014-05-14
- ---------------
-
- - Allow non-HTTP service principals with HTTPKerberosAuth using a new optional
- argument ``service``.
-
- - Fix bug in ``setup.py`` on distributions where the ``compiler`` module is
- not available.
-
- - Add test dependencies to ``setup.py`` so ``python setup.py test`` will work.
-
- 0.4: 2013-10-26
- ---------------
-
- - Minor updates in the README
- - Change requirements to depend on requests above 1.1.0
-
- 0.3: 2013-06-02
- ---------------
-
- - Work with servers operating on non-standard ports
-
- 0.2: 2013-03-26
- ---------------
-
- - Not documented
-
- 0.1: Never released
- -------------------
-
- - Initial Release
-
- Platform: UNKNOWN
|