Metadata-Version: 2.1
Name: htgettoken
Version: 2.0
Summary: UNKNOWN
Home-page: https://github.com/fermitools/htgettoken
Author: Dave Dykstra
Author-email: dwd@fnal.gov
License: BSD-3-Clause
Project-URL: Bug Tracker, https://github.com/fermitools/htgettoken/issues
Project-URL: Source Code, https://github.com/fermitools/htgettoken
Description: # htgettoken
        
        `htgettoken` gets OIDC bearer access tokens by interacting with a
        Hashicorp vault server configured for retrieving and storing OIDC
        refresh tokens using the
        [htvault-config package](https://github.com/fermitools/htvault-config).
        
        For details on its usage please see the
        [man page](https://htmlpreview.github.io/?https://github.com/fermitools/htgettoken/blob/master/htgettoken.html).
        
        Packaging for Red Hat Enterprise Linux systems is included.  Rpms are
        distributed in the
        [Open Science Grid yum repositories](https://opensciencegrid.org/docs/common/yum/#install-the-osg-repositories).
        After enabling the OSG repositories, do this as root to install it:
        ```
        yum install htgettoken
        ```
        
        htgettoken and Vault are also integrated with 
        [HTCondor](https://htcondor.readthedocs.io/en/latest/admin-manual/file-and-cred-transfer.html#using-vault-as-the-oauth-client).
        It is available in HTCondor versions 9.0.6 and later.
        
        See this
        [paper](https://github.com/fermitools/htgettoken/files/6063416/CHEP21_Paper_Htgettoken.pdf)
        submitted to
        [vCHEP 2021](https://indico.cern.ch/event/948465/)
        for a description of htgettoken, htvault-config, and their HTCondor
        integration.
        
        ## additional commands
        
        A few additional helpful commands are bundled with htgettoken.
        Click on each one below to see their man pages.
        
        - [htdecodetoken/httokendecode](https://htmlpreview.github.io/?https://github.com/fermitools/htgettoken/blob/master/htdecodetoken.html) --
          decodes JSON Web Tokens that it finds either according to a given
          filename or based on the
          [WLCG Bearer Token Discovery](https://zenodo.org/record/3937438#.YUDw7aBOlTY)
          standard if no filename is given.
        - [htdestroytoken](https://htmlpreview.github.io/?https://github.com/fermitools/htgettoken/blob/master/htdestroytoken.html) --
          removes bearer and vault tokens
        - [httokensh](https://htmlpreview.github.io/?https://github.com/fermitools/htgettoken/blob/master/httokensh.html) --
          keeps the bearer token renewed as long as a command it starts runs
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.5
Description-Content-Type: text/markdown
