https://github.com/mprpic/httpie-gssapi

GSSAPI authentication plug-in for HTTPie
https://github.com/mprpic/httpie-gssapi

gssapi http httpie kerberos plugin python

Last synced: about 9 hours ago
JSON representation

GSSAPI authentication plug-in for HTTPie

• Host: GitHub
• URL: https://github.com/mprpic/httpie-gssapi
• Owner: mprpic
• License: mit
• Created: 2019-04-10T14:24:13.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2021-06-14T20:18:01.000Z (over 3 years ago)
• Last Synced: 2024-08-10T22:55:26.516Z (3 months ago)
• Topics: gssapi, http, httpie, kerberos, plugin, python
• Language: Python
• Size: 9.77 KB
• Stars: 0
• Watchers: 2
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
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

------------

.. code-block:: bash

    $ 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``.

.. code-block:: bash

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

Note that supplying authentication credentials is not necessary, meaning the following two

commands are equivalent:

.. code-block:: bash

    $ 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``.