alecgunny / igwn-auth-utils

Mirror of Official IGWN Auth Utils repository

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

Development 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>