auth-oidc

An OpenID Connect Relying Party designed to support authentication and authorization in a reverse proxy.

Users are authenticated using the configured OpenID Provider and authorized using the provided configuration. Session information is stored as a signed JWT in a cookie.

Endpoints

• /auth

  Performs authentication and authorization. The user's email address is returned in the X-Subject response header.

  Query parameters:

  Name	Required	Description
  group	No	The group name to use for authorization.
  redirect	No	The URL to redirect to after a successful login.

  Status codes:

  Status	Description
  200	The user is authenticated and authorized.
  302	The user is not authenticated and a redirect URL was provided. Redirects to the OpenID Provider Authorization Endpoint.
  401	The user is not authenticated and a redirect URL was not provided.
  403	The user is authenticated but not authorized.

• /login

  Starts the OpenID Connect Authorization Code Flow.

  Query parameters:

  Name	Required	Description
  redirect	No	The URL to redirect to after a successful login.

  Status codes:

  Status	Description
  302	Redirects to the OpenID Provider Authorization Endpoint.

• /logout

  Performs logout.

  Status codes:

  Status	Description
  200	The user was successfully logged out.

• /callback

  Completes the OpenID Connect Authorization Code Flow. The OpenID Provider should be configured with this endpoint as the callback URL.

  Status codes:

  Status	Description
  200	The user was successfully logged in and a redirect URL was not provided.
  302	The user was successfully logged in and a redirect URL was provided. Redirects to the provided redirect URL.

Configuration

Configuration is provided using command-line flags and a YAML configuration file.

Detailed usage information is available using the -help flag.

Configuration file

• groups

  Group memberships to use for authorization.

Example

groups:
  group1:
    - user1@example.com
  group2:
    - user1@example.com
    - user2@example.com