Metadata-Version: 2.1
Name: httpie-digirm-auth
Version: 0.2.0
Summary: DigiRM plugin for HTTPie.
Home-page: https://github.com/kulack/httpie-digirm-auth
Download-URL: https://github.com/kulack/httpie-digirm-auth
Author: Fred A Kulack
Author-email: kulack@gmail.com
License: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Intended Audience :: Developers
Classifier: Environment :: Plugins
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Utilities
License-File: LICENSE
Requires-Dist: httpie >=3.2.2

httpie-digirm-auth
==================

`DigiRMAuth <https://github.com/kulack/httpie_digirm_auth>`_ auth plugin for `HTTPie <https://github.com/jkbr/httpie>`_.


Installation
------------

.. code-block:: bash

    $ httpie plugins install httpie-digirm-auth

    # OR

    $ pip install httpie-digirm-auth


You should now see:

* ``httpie-digirm-auth`` plugin in the ``httpie plugins list`` command
* ``drm`` under ``--auth-type`` in ``http --help`` output.


Usage
-----

.. code-block:: bash

    $ https --auth-type=drm --auth='api-key-id:api-key-secret' \
        remotemanager.digi.com/ws/v1/devices/inventory


You can omit the ``--auth`` parameter and specify the API key ID and secret in the ``~/.netrc`` file as if they were user names and passwords.

.. code-block:: bash

    $ https --auth-type=drm remotemanager.digi.com/ws/v1/devices/inventory


Compatibility
-------------

Currently only Digi Remote Manager API key authentication is supported. To use basic auth, simply use the built-in HTTPie basic auth plugin.

In that authentication schema the API key ID and API key secret are used in the ``X-API-KEY-ID`` and ``X-API-KEY-SECRET`` headers respectively.
