Se connecter avec l’authentification unique SSO via OIDC

Connectez votre fournisseur d’identité existant afin de permettre aux utilisateurs de se connecter à votre centre d’aide avec leurs identifiants professionnels.

L’authentification unique SSO via OIDC nécessite le forfait Pro ou un forfait supérieur. Comparer les forfaits si nécessaire.

Ce dont vous aurez besoin

Rassemblez les informations suivantes auprès de votre fournisseur d’identité avant de commencer :

URL de découverte : URL du document de découverte OIDC de votre fournisseur. Les fournisseurs standard utilisent généralement /.well-known/openid-configuration, mais Ferndesk accepte toute URL valide qui renvoie le document de découverte requis.
ID client : identifiant du client OAuth fourni dans les paramètres d’application de votre fournisseur
Secret client : clé confidentielle utilisée pour l’échange de jetons

Configuration

Ouvrir le contrôle d’accès

Dans le tableau de bord, accédez à Centre d’aide, puis à Contrôle d’accès.

Contrôle d’accès dans les paramètres du centre d’aide

Choisir votre mode d’accès

OIDC est utilisé lorsque votre centre d’aide est Privé, ou sur un centre d’aide Public pour restreindre l’accès à certaines sections et collections. Un centre d’aide privé nécessite au moins une méthode de connexion, et OIDC peut servir de méthode de connexion.

Ouvrir les paramètres OIDC

Sous Connexion des visiteurs, développez Authentification unique (OIDC).

Lignes de connexion des visiteurs dans le contrôle d’accès

Saisir les informations de votre fournisseur

Saisissez un Libellé du bouton, tel que « Se connecter avec Okta », puis saisissez votre URL de découverte, votre ID client et votre Secret client.

Formulaire des informations du fournisseur OIDC avec le champ URL de découverte

Activer OIDC

Cliquez sur Activer OIDC.

Ferndesk demande automatiquement les champs d’application openid, profile et email. Pour désactiver OIDC ultérieurement, revenez à cette section et cliquez sur Désactiver OIDC.

URL de rappel

Ajoutez cette URL aux URI de redirection autorisées de votre fournisseur d’identité :

https://<your-help-domain><base-path>/api/auth/oidc/callback

Exemples de fournisseurs

Okta : l’URL de découverte est https://your-domain.okta.com/.well-known/openid-configuration. Créez une intégration d’application Web avec le flux de code d’autorisation.

Auth0 : l’URL de découverte est https://your-domain.auth0.com/.well-known/openid-configuration. Créez une application Web classique.

Google Workspace : l’URL de découverte est https://accounts.google.com/.well-known/openid-configuration. Créez des identifiants OAuth 2.0 en définissant le type d’application sur Application Web.

Résolution des problèmes

URL de découverte non valide

L’URL doit renvoyer un JSON valide contenant les champs issuer, authorization_endpoint et token_endpoint. Testez-la dans votre navigateur avant de procéder à la configuration.

Échec de l’authentification du client

Vérifiez que votre ID client et votre secret client sont corrects. Vérifiez qu’il n’y a pas d’espaces ou de sauts de ligne supplémentaires lors du copier-coller.

URI de redirection non concordante

Ajoutez l’URL de rappel exacte aux URI de redirection autorisées de votre fournisseur, y compris https:// et votre domaine correct.

Accès refusé après la connexion

Ferndesk demande les champs d’application openid, profile et email. Si la connexion échoue, vérifiez que votre fournisseur renvoie un jeton d’identification valide contenant les revendications sub et email.

Cela vous a-t-il été utile ?