Skip to content

Latest commit

 

History

History
57 lines (36 loc) · 1.96 KB

README.rst

File metadata and controls

57 lines (36 loc) · 1.96 KB
Raw

httpie-gssapi

GSSAPI authentication plug-in for HTTPie.

This plug-in uses the requests-gssapi library, which is a more-modern replacement of the old requests-kerberos library.

Installation

$ pip install httpie-gssapi

This will add the gssapi authentication method under --auth-type in the $ http --help output.

Usage

Ensure you have a valid Kerberos token by running kinit.

$ http --auth-type=gssapi https://example.org

Note that supplying authentication credentials is not necessary, meaning the following two commands are equivalent:

$ http --auth-type=gssapi https://example.org
$ http --auth-type=gssapi --auth : https://example.org

Configuration Options

The following environment variables can be set to modify the GSSAPI authentication behavior:

  • HTTPIE_GSSAPI_MUTUAL_AUTH (default: required): determines whether mutual authentication from the server should be required. For more information, see Mutual Authentication. Possible values are: required, optional, disabled.
  • HTTPIE_GSSAPI_OPPORTUNISTIC_AUTH (default: no): enables or disables preemptively initiating the GSSAPI exchange. For more information, see Opportunistic Authentication. Possible values are: yes, true, 1; all other values default to no.
  • HTTPIE_GSSAPI_DELEGATE (default: no): enables or disables credential delegation. For more information, see Delegation. Possible values are: yes, true, 1; all other values default to no.