.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.48.1.
.TH OIDC-ADD "1" "February 2022" "oidc-add 4.2.6" "User Commands"
.SH NAME
oidc-add \- adds account configurations to oidc-agent
.SH SYNOPSIS
.B oidc-add
[\fI\,OPTION\/\fR...] \fI\,ACCOUNT_SHORTNAME | -a | -l | -x | -X | -R\/\fR
.SH DESCRIPTION
oidc\-add \fB\-\-\fR A client for adding and removing accounts to the oidc\-agent
.IP
General:
.TP
\fB\-a\fR, \fB\-\-loaded\fR
Lists the currently loaded account configurations
.TP
\fB\-\-always\-allow\-idtoken\fR Always allow id\-token requests without manual
approval by the user for this account
configuration.
.TP
\fB\-c\fR, \fB\-\-confirm\fR
Require user confirmation when an application
requests an access token for this configuration
.TP
\fB\-l\fR, \fB\-\-list\fR
Lists all configured account configurations
.TP
\fB\-p\fR, \fB\-\-print\fR
Prints the encrypted account configuration and
exits
.TP
\fB\-\-pw\-cmd\fR=\fI\,CMD\/\fR
Command from which the agent can read the
encryption password
.TP
\fB\-\-pw\-env\fR[=\fI\,OIDC_ENCRYPTION_PW\/\fR]
Reads the encryption password from the passed
environment variable (default:
OIDC_ENCRYPTION_PW), instead of prompting the
user
.TP
\fB\-\-pw\-file\fR=\fI\,FILE\/\fR
Uses the first line of FILE as the encryption
password.
.TP
\fB\-\-pw\-gpg\fR=\fI\,KEY_ID\/\fR, \fB\-\-pw\-pgp\fR=\fI\,KEY_ID\/\fR, \fB\-\-gpg\fR=\fI\,KEY_ID\/\fR, \fB\-\-pgp\fR=\fI\,KEY_ID\/\fR
Uses the passed GPG KEY for encryption
.TP
\fB\-\-pw\-keyring\fR
Stores the used encryption password in the
systems' keyring
.TP
\fB\-\-pw\-prompt\fR=\fI\,cli\/\fR|gui
Change the mode how oidc\-add should prompt for
passwords. The default is 'cli'.
.TP
\fB\-\-pw\-store\fR[=\fI\,TIME\/\fR]
Keeps the encryption password encrypted in memory
for TIME seconds. Default value for TIME: Forever
.TP
\fB\-r\fR, \fB\-\-remove\fR
The account configuration is removed, not added
.TP
\fB\-\-remote\fR
Use a remote central oidc\-agent, instead of a
local one.
.TP
\fB\-R\fR, \fB\-\-remove\-all\fR
Removes all account configurations currently
loaded
.TP
\fB\-\-seccomp\fR
Enables seccomp system call filtering; allowing
only predefined system calls.
.TP
\fB\-t\fR, \fB\-\-lifetime\fR=\fI\,TIME\/\fR
Set a maximum lifetime in seconds when adding the
account configuration
.TP
\fB\-x\fR, \fB\-\-lock\fR
Lock agent
.TP
\fB\-X\fR, \fB\-\-unlock\fR
Unlock agent
.IP
Verbosity:
.TP
\fB\-g\fR, \fB\-\-debug\fR
Sets the log level to DEBUG
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Enables verbose mode
.IP
Help:
.TP
\-?, \fB\-\-help\fR
Give this help list
.TP
\fB\-\-usage\fR
Give a short usage message
.TP
\fB\-V\fR, \fB\-\-version\fR
Print program version
.PP
Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.
.SH FILES
~/.config/oidc-agent/ or ~/.oidc-agent/
.RS
oidc-add reads account and client configurations in this directory.
.RE
.PP
.SH EXAMPLES
.PP
.nf
oidc-add example
.fi
.RS
Adds the 'example' account configuration to oidc-agent.
.RE
.PP
.nf
oidc-add example -r
.fi
.RS
Removes the 'example' account configuration from oidc-agent.
.RE
.PP
.nf
oidc-add example -t 300
.fi
.RS
Adds the 'example' account configuration to oidc-agent. It will be automatically
removed after 5 minutes (300s).
.RE
.PP
.nf
oidc-add -R
.fi
.RS
Removes all loaded account configurations from oidc-agent.
.RE
.PP
.RE
.PP
.nf
oidc-add -x
.fi
.RS
Locks the agent. Use \fB-X\fR to unlock.
.RE
.PP
.SH "REPORTING BUGS"
Report bugs to <https://github.com/indigo\-dc/oidc\-agent/issues>
.br
Subscribe to our mailing list to receive important updates about oidc\-agent:
<https://www.lists.kit.edu/sympa/subscribe/oidc\-agent\-user>.
.SH "SEE ALSO"
oidc-agent(1), oidc-gen(1), oidc-token(1)
.PP
Low-traffic mailing list with updates such as critical security incidents and new releases: https://www.lists.kit.edu/sympa/subscribe/oidc-agent-user
.PP
Full documentation can be found at https://indigo-dc.gitbooks.io/oidc-agent/user/oidc-add