OIDC

Introduction #

OpenID Connect (OIDC) is an identity protocol built on top of OAuth 2.0 that provides secure authentication and authorization. It allows users to securely log in to various services while service providers can simultaneously access verified identity information. The following article describes how to set up OpenID Connect (OIDC) in Relution using Microsoft Azure.

Settings in Relution #

OIDC can be configured in the Relution portal under Settings > OpenID Connect. The following screenshots include a working configuration using Microsoft Azure.

Configuration details #

Name of the provider Will be displayed on the login button in the rleution portal
Create unknown users in Relution Unknown users are created by login in Relution.

Client Details #

Client ID" Corresponds to the application ID in Azure.
Client Secret Corresponds to the client secret key to the application ID in Azure.

Server URIs #

Use Discovery Endpoint If supported by the provider, an automatic configuration of the required URIs is performed.
Manual configuration of endpoints Necessary as soon as automatic discovery does not work.

Authorization URI
https://login.microsoftonline.com/$-your-client-ID/oauth2/v2.0/authorize

JWK Set URI
https://login.microsoftonline.com/$-your-client-ID/discovery/v2.0/keys

Token URI
https://login.microsoftonline.com/$-your-client-ID/oauth2/v2.0/token

User Info URI
https://graph.microsoft.com/oidc/userinfo

Advanced configuration #

The username attribute from the OIDC provider contains the unique username of the authenticated user.

The username attribute in Relution contains the unique username of the authenticated user.

Authorization Grant Type` The Authorization Grant Type is an OAuth mechanism that specifies how an application obtains access permissions from a user.

Scope Scopes define what identity information or resources the application can request from the OIDC provider

Settings in Azure #

Creating a new app registry #

1. login in Azure Portal, continue on Azure Active Directory.
2. create new App registry > Create new registry for OIDC
3. name application, select account type Only accounts in this organization directory and regest it

Add secret client key (Client Secret) under Certificates & Secrets #

1. the required client secret is created under Add a certificate or secret
2. via New secret client key the Description and validity period Valid until can be set
3. the client key can be copied directly

Configure API permissions. #

1. under API Permissions > Configured Permissions, click Add Permission.
2. select Microsoft Graph under Microsoft APIs in the Request API Permissions dialog box

3. in the next step select the tile `Application permissions
4. select User.Read.All for `User

Add redirection URI #