Aller au contenu principal
Version: Any 26

OpenID Connect

Introduction​

Avant de configurer OpenID Connect, vous devez avoir un utilisateur créé dans Any dont l'identité correspond à celle renvoyée par votre fournisseur d'identité (le plus souvent l'adresse e-mail). Si aucun utilisateur ne correspond, la connexion est refusée. Vous pouvez rediriger ces utilisateurs vers une page de votre choix (voir la correspondance des identités ci-dessous).

Configuration​

Any est livré avec un fichier de configuration OpenID Connect préconfiguré nommé « shiro-oidc.ini ». Pour l'utiliser, il vous suffit de le renommer en « shiro.ini ».

Ci-dessous la partie à modifier dans le fichier « shiro.ini » afin de configurer votre connexion OpenID Connect.

oidcConfig.clientId = <client_id>
oidcConfig.secret = <client_secret>
oidcConfig.discoveryURI = https://login.microsoftonline.com/<tenant_id>/v2.0/.well-known/openid-configuration
oidcConfig.scope = openid email profile

clients.callbackUrl = <url de any>/callback

clientId : identifiant de l'application déclarée auprès de votre fournisseur d'identité.

secret : secret client généré par votre fournisseur d'identité pour cette application. Pour chiffrer cette valeur, consultez la génération des mots de passe chiffrés.

discoveryURI : URL de découverte du fournisseur d'identité, qui expose les points de terminaison et les clés du protocole. L'exemple ci-dessus correspond à Microsoft Entra ID, où <tenant_id> désigne votre annuaire.

scope : liste des périmètres demandés, séparés par des espaces. Le périmètre openid est obligatoire, email et profile fournissent les attributs utilisés pour identifier l'utilisateur dans Any.

URL de rappel​

L'URL vers laquelle le fournisseur d'identité renvoie le navigateur après authentification. Elle doit être déclarée à l'identique dans l'application créée chez votre fournisseur d'identité.

clients.callbackUrl = <url de any>/callback

Correspondance des identités​

Ces entrées déterminent quel attribut du profil renvoyé par le fournisseur d'identité est utilisé pour retrouver l'utilisateur dans Any.

c6SsoAuthorizer.identityAttribute = email
# Identity type : login | username | email
c6SsoAuthorizer.identityType = email
# If the user does not exist in Any, it is redirected to the following page
# c6SsoAuthorizer.redirectionUrl = https://<server>?user=${user}&message=${message}

identityAttribute : nom de l'attribut à lire dans le profil renvoyé par le fournisseur d'identité. S'il n'est pas renseigné, l'identifiant du profil est utilisé.

identityType : champ de l'utilisateur Any auquel la valeur est comparée, parmi login, username et email.

redirectionUrl : page vers laquelle l'utilisateur est redirigé lorsque son compte est introuvable, désactivé ou expiré. Les jetons ${user} et ${message} sont remplacés par l'identité présentée et le motif du refus. Cette entrée est commentée par défaut, l'utilisateur reste alors sur une page d'erreur.