oidc-agent
  • Introduction
  • Quickstart
  • Migrating to oidc-agent 5
  • Installation
    • Linux
    • MacOS
    • Windows
  • Configuration
    • oidc-agent Directory
    • General Configuration
    • Custom Request Parameter
    • Configuration of Providers
    • oidc-agent Integration
    • Agent Forwarding
  • Usage
    • oidc-agent
      • Starting oidc-agent
      • General Usage
      • Detailed Information About All Options
    • oidc-agent-service
    • oidc-keychain
      • General Usage
      • Detailed Information About All Options
    • oidc-gen
      • General Usage
      • Detailed Information About All Options
      • Integrate With Different Providers
        • B2Access
        • EGI
        • Elixir
        • Google
        • HBP
        • Helmholtz AAI
        • IAM (INDIGO/DEEP)
        • KIT
        • Any Other Provider
        • Known Issues
        • Client Configuration Values
    • oidc-add
      • General Usage
      • Detailed Information About All Options
    • oidc-token
      • General Usage
      • Detailed Information About All Options
    • oidc-tokensh
      • General Usage
      • Detailed Information About All Options
    • Other Applications Using oidc-agent
    • Tips
    • oidc-agent-server
  • Windows
    • Installation
  • MAC OS
    • State of Feature Support
    • Installation
  • Security
    • Privilege Separation & Architecture
    • Account Configuration Files
    • Credentials
    • Memory
    • Agent Locking
    • Communication
    • Encryption Passwords
    • Autounload (Lifetime)
    • User Confirmation
    • Tracing
    • seccomp
    • Final Note
  • API
    • liboidc-agent4
    • liboidcagent-go
    • liboidcagent-py
    • IPC-API
Powered by GitBook
On this page
  1. Configuration

oidc-agent Integration

PreviousConfiguration of ProvidersNextAgent Forwarding

Last updated 3 years ago

Xsession Integration

oidc-agent has support for integration with Xsession, which is enabled by default if the oidc-agent-desktop package is installed. This means oidc-agent will automatically start at the beginning of an Xsession and then be available throughout that session (i.e. you can connect to the agent from every terminal).

To disable / re-enable this behavior (system-wide) edit the /etc/oidc-agent/oidc-agent-service.options file. To disable it on a per user basis, copy this file to your and edit it there. To disable XSession integration uncomment / add the line:

START_AGENT_WITH_XSESSION="False"

To re-enable Xsession integration change it to START_AGENT_WITH_XSESSION="True" or comment it out.

To pass command line options to the automatically started agent edit the OIDC_AGENT_OPTS variable.

Note that from version 4.1.0 on the agent can be restarted without losing the integration in existing terminals. To do so run:

oidc-agent-service restart-s

We also want to note that can be used without Xsession integration.

oidc-agent directory
oidc-agent-service