General Usage

To obtain an access token for a specific account configuration you have to pass the shortname to oidc-token: oidc-token <shortname> This will print the access token to stdout. This enables several use cases:

  • print the token to stdout and copy-paste it where you need it.

  • put the token in an environment variable: export OIDC_AT=`oidc-token shortname` .

  • use the -c (or similar) option to put the token into an environment variable: eval `oidc-token -c <shortname>`

  • pipe the token to a programm that reads a token from stdin: oidc-token shortname | iReadATokenFromStdIn.

  • use the oidc-token directly in the needed command: curl -H 'Authorization: Bearer `oidc-token shortname`' example.com.

    • use the --auth-header option to simplify api calls: curl -H "$(oidc-token shortname)" example.com

Instead of using oidc-token <shortname> you also can do oidc-token <issuer_url>. While usually using the shortname is shorter there are also use cases for using the issuer url.

See also Tips for more usage tips.

Usage: oidc-token [OPTION...] ACCOUNT_SHORTNAME | ISSUER_URL

See Detailed Information About All Options for more information.

Last updated