igwn-auth-utils

Authorisation utilities for IGWN


License
BSD-3-Clause
Install
pip install igwn-auth-utils==0.2.0

Documentation

igwn-auth-utils

Python library functions to simplify using IGWN authorisation credentials.

https://igwn-auth-utils.readthedocs.io/

This project is primarily aimed at discovering X.509 credentials and SciTokens for use with HTTP(S) requests to IGWN-operated services.

Release status

PyPI version License DOI

Development status

Build status Code coverage Documentation Status

Installation

The best way to install the latest release is using conda with the conda-forge channel enabled:

conda install -c conda-forge igwn-auth-utils

The latest release can also be installed using pip:

python -m pip install igwn-auth-utils

Basic usage

To discover an X.509 user credential (proxy) location:

>>> from igwn_auth_utils import find_x509_credentials
>>> print(find_x509_credentials())
('/tmp/x509up_u1000', '/tmp/x509up_u1000')

To discover (and deserialise) a SciToken for a specific purpose (audience and scope):

>>> from igwn_auth_utils import find_scitoken
>>> print(find_scitoken("myservice", "read:/mydata"))
<scitokens.scitokens.SciToken object at 0x7fe99ab792e0>