Comment configurer le SSO OIDC avec Microsoft Entra ID (Azure AD)

Ce guide utilisera Microsoft Entra ID en tant que fournisseur SSO et le protocole Open ID Connect (OIDC) comme protocole d’identité privilégié.

Cette fonctionnalité fait partie des plans Team & Enterprise.

Étape 1 : Créer une nouvelle application dans votre fournisseur d'identité

Ouvrez un nouvel onglet ou une nouvelle fenêtre dans votre navigateur et connectez-vous au portail Azure de votre organisation.

Accédez au centre d’administration Microsoft Entra ID et cliquez sur « Applications d’entreprise »

Vous serez redirigé vers cette page. Cliquez ensuite sur « New application » en haut, puis sur « Create your own application ».

Saisissez un nom pour votre application (par exemple, Hugging Face SSO), puis sélectionnez « Register an application to integrate with Microsoft Entra ID (App you’re developing) ».

Étape 2 : Configurer votre application sur Azure

Ouvrez un nouvel onglet ou une nouvelle fenêtre dans votre navigateur et accédez à la section SSO des paramètres de votre organisation. Sélectionnez le protocole OIDC.

Copiez l’« URI de redirection » depuis les paramètres de l’organisation sur Hugging Face et collez-la dans le champ « Redirect URI » sur Azure Entra ID. Assurez-vous de sélectionner « Web » dans le menu déroulant. L’URL ressemble à ceci : https://huggingface.co/organizations/[organizationIdentifier]/oidc/consume.

Enregistrez votre nouvelle application.

Étape 3 : Finaliser la configuration sur Hugging Face

Nous devrons collecter les informations suivantes pour finaliser la configuration sur Hugging Face :

• L'identifiant client de l'application OIDC
• Un secret client de l'application OIDC
• L'URL de l'émetteur de l'application OIDC

Dans Microsoft Entra ID, accédez à Applications d’entreprise, puis cliquez sur votre application nouvellement créée dans la liste.

Dans l'aperçu de l'application, cliquez sur « Single sign-on », puis sur « Go to application ».

Dans l’aperçu de l’application OIDC, vous trouverez un champ copiable nommé « Application (client) ID ». Copiez cet ID dans votre presse-papiers et collez-le dans le champ « Client ID » sur Hugging Face.

Ensuite, cliquez sur « Endpoints » dans le menu supérieur de Microsoft Entra. Copiez la valeur du champ « OpenID connect metadata document » et collez-la dans le champ « Issue URL » de Hugging Face.

Retournez dans Microsoft Entra, accédez à « Certificates & secrets » et générez un nouveau secret en cliquant sur « New client secret ».

Une fois le secret créé, copiez sa valeur et collez-la dans le champ « Client secret » sur Hugging Face.

Vous pouvez maintenant cliquer sur « Update and Test OIDC configuration » pour enregistrer les paramètres.

Vous devriez être redirigé vers l'écran de connexion de votre fournisseur SSO (IdP). Une fois connecté, vous serez redirigé vers la page de paramètres de votre organisation.

Une coche verte à proximité du sélecteur OIDC atteste que le test a réussi.

Étape 4 : Activer le SSO dans votre organisation

Maintenant que le Single Sign-On est configuré et testé, vous pouvez l’activer pour les membres de votre organisation en cliquant sur le bouton « Enable ».

Une fois activé, les membres de votre organisation doivent compléter le flux d’authentification SSO décrit dans la section Fonctionnement.

Update on GitHub