After installation the agent has to be started. Usually the agent is started on system startup and is then available on all terminals (see integration). Therefore, after installation the options are to restart your X-Sessio or to start the agent manually.
This starts the agent and sets the required environment variables.
For most OpenID Connect providers an agent account configuration can be created with one of the following calls. Make sure that you can run a web-browser on the same host where you run the
oidc-gen <shortname>oidc-gen --pub <shortname>
For more information on the different providers refer to integrate with different providers.
After an account configuration is created it can be used with the shortname to obtain access tokens. One does not need to run
oidc-gen again unless to update or create a new account configuration.
However, usually it is not necessary to load an account configuration with
oidc-add. One can directly request an access token for a configuration and
oidc-agent will automatically load it if it is not already loaded.
Alternatively, it is also possible to request an access token without specifying the shortname of a configuration but with the issuer url:
This way is recommended when writing scripts that utilize oidc-agent to obtain access tokens. This allows that the script can be easily used by others without them having to update the shortname.
oidc-add -loidc-gen -l
These commands both give a list of all existing account configurations.
A list of the currently loaded accounts can be retrieved with:
An existing account configuration can be updated with
oidc-gen -m <shortname>