NAME¶

oidc-add - adds account configurations to oidc-agent

SYNOPSIS¶

oidc-add [OPTION...] ACCOUNT_SHORTNAME | -a | -l | -x | -X | -R

DESCRIPTION¶

oidc-add -- A client for adding and removing accounts to the oidc-agent

General:

--always-allow-idtoken Always allow id-token requests without manual

approval by the user for this account configuration.

-a, --loaded

Lists the currently loaded account configurations

-c, --confirm

Require user confirmation when an application requests an access token for this configuration

-l, --list

Lists all configured account configurations

--pw-cmd=CMD

Command from which the agent can read the encryption password

--pw-env[=OIDC_ENCRYPTION_PW]

Reads the encryption password from the passed environment variable (default: OIDC_ENCRYPTION_PW), instead of prompting the user

--pw-file=FILE

Uses the first line of FILE as the encryption password.

--pw-gpg=KEY_ID, --pw-pgp=KEY_ID, --gpg=KEY_ID, --pgp=KEY_ID

Uses the passed GPG KEY for encryption

--pw-keyring

Stores the used encryption password in the systems' keyring

--pw-prompt=cli|gui

Change the mode how oidc-add should prompt for passwords. The default is 'cli'.

--pw-store[=TIME]

Keeps the encryption password encrypted in memory for TIME seconds. Default value for TIME: Forever

-p, --print

Prints the encrypted account configuration and exits

--remote

Use a remote central oidc-agent, instead of a local one.

-r, --remove

The account configuration is removed, not added

-R, --remove-all

Removes all account configurations currently loaded

--seccomp

Enables seccomp system call filtering; allowing only predefined system calls.

-t, --lifetime=TIME

Set a maximum lifetime in seconds when adding the account configuration

-x, --lock

Lock agent

-X, --unlock

Unlock agent

Verbosity:

-g, --debug

Sets the log level to DEBUG

-v, --verbose

Enables verbose mode

Help:

-?, --help

Give this help list

--usage

Give a short usage message

-V, --version

Print program version

Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options.

FILES¶

~/.config/oidc-agent/ or ~/.oidc-agent/

EXAMPLES¶

oidc-add example

oidc-add example -r

oidc-add example -t 300

oidc-add -R

oidc-add -x

REPORTING BUGS¶

Report bugs to <https://github.com/indigo-dc/oidc-agent/issues>
Subscribe to our mailing list to receive important updates about oidc-agent: <https://www.lists.kit.edu/sympa/subscribe/oidc-agent-user>.

SEE ALSO¶

oidc-agent(1), oidc-gen(1), oidc-token(1)

Low-traffic mailing list with updates such as critical security incidents and new releases: https://www.lists.kit.edu/sympa/subscribe/oidc-agent-user

Full documentation can be found at https://indigo-dc.gitbooks.io/oidc-agent/user/oidc-add