Configurer Redocly pour l’authentification unique avec l’ID Microsoft Entra

Dans cet article, vous allez apprendre à intégrer Redocly à Microsoft Entra ID. Redocly est le premier outil de documentation pour développeurs qui nous permet de conserver les documents dans GitHub, afin que les développeurs aient toujours accès à la documentation dont ils ont besoin. Quand vous intégrez Redocly à Microsoft Entra ID, vous pouvez :

• Contrôler dans Microsoft Entra ID qui a accès à Redocly.
• Permettre à vos utilisateurs de se connecter automatiquement à Redocly avec leurs comptes Microsoft Entra.
• Gérez vos comptes dans un emplacement central.

Vous allez configurer et tester l’authentification unique Microsoft Entra ID pour Redocly dans un environnement de test. Redocly prend en charge l'authentification unique SP et l'approvisionnement des utilisateurs Just In Time (juste-à-temps).

Conditions préalables

Pour intégrer Microsoft Entra ID à Redocly, vous avez besoin des éléments suivants :

• Un compte d’utilisateur Microsoft Entra. Si vous n’en avez pas encore, vous pouvez créer un compte gratuitement.
• L’un des rôles suivants : Administrateur d’application, Administrateur d’application cloud ou Propriétaire de l’application.
• Un abonnement Microsoft Entra. Si vous n’avez pas d’abonnement, vous pouvez obtenir un compte gratuit .
• Un abonnement Redocly pour lequel l’authentification unique (SSO) est activée

Ajouter une application et affecter un utilisateur de test

Avant de commencer le processus de configuration de l’authentification unique, vous devez ajouter l’application Redocly depuis la galerie Microsoft Entra. Vous avez besoin d’un compte d’utilisateur de test pour l’affecter à l’application et tester la configuration de l’authentification unique.

Ajouter Redocly depuis la galerie Microsoft Entra

Ajoutez Redocly à partir de la galerie d'applications Microsoft Entra pour configurer l'authentification unique avec Redocly. Pour plus d’informations sur l’ajout d’une application à partir de la galerie, consultez le guide de démarrage rapide : Ajouter une application à partir de la galerie.

Créer et affecter un utilisateur de test Microsoft Entra

Suivez les instructions de l'article créer et attribuer un compte d'utilisateur pour créer un compte d'utilisateur de test appelé B.Simon.

Vous pouvez sinon également utiliser l’Assistant de configuration des applications d'entreprise . Dans cet Assistant, vous pouvez ajouter une application à votre locataire, ajouter des utilisateurs/groupes à l’application et attribuer des rôles. L’Assistant fournit également un lien vers le volet de configuration de l’authentification unique. En savoir plus sur les Assistants Microsoft 365..

Configurer l’authentification unique Microsoft Entra

Effectuez les étapes suivantes pour activer l’authentification unique Microsoft Entra.

1. Connectez-vous au Centre d’administration Microsoft Entra en tant qu’administrateur d’application cloud au moins.

2. Accédez à Entra ID>Applications d’entreprise>Redocly>Authentification unique.

3. Dans la page Sélectionner une méthode d’authentification unique , sélectionnez SAML.

4. Dans la page Configurer l’authentification unique avec SAML , sélectionnez l’icône crayon de configuration SAML de base pour modifier les paramètres.

   

5. Dans la section Configuration SAML de base , procédez comme suit :

   a) Dans la zone de texte Identificateur , tapez une URL à l’aide de l’un des modèles suivants :

   Identificateur
   https://api.redocly.com/auth/sso?idpId=<CustomerId>
   https://api.<Region>.redocly.com/auth/sso?idpId=<CustomerId>

   b. Dans l’URL de réponse zone de texte, tapez une URL à l’aide de l’un des modèles suivants :

   URL de réponse
   https://api.redocly.com/auth/sso
   https://api.<Region>.redocly.com/auth/sso
   https://<SiteName>.redoc.dev/_auth/saml2
   https://<SiteName>.<REGION>.redoc.dev/_auth/saml2

   c. Dans la zone de texte URL de connexion , tapez une URL à l’aide de l’un des modèles suivants :

   URL de connexion
   https://app.redocly.com/login-sso
   https://app.<Region>.redocly.com/login-sso
   https://<SiteName>.redoc.dev/_auth/idp-login
   https://<SiteName>.<REGION>.redoc.dev/_auth/idp-login

   Remarque

   Ces valeurs ne sont pas réelles. Mettez à jour ces valeurs avec l’IDENTIFICATEUR, l’URL de réponse et l’URL de connexion réels. Pour obtenir ces valeurs, contactez l’équipe de support technique Redocly . Vous pouvez également consulter les modèles figurant à la section Configuration SAML de base.

6. Dans la page Configurer l’authentification unique avec SAML , dans la section Certificat de signature SAML , recherchez le certificat (PEM) et sélectionnez Télécharger pour télécharger le certificat et l’enregistrer sur votre ordinateur.

   

7. Dans la section Configurer Redocly , copiez la ou les URL appropriées en fonction de vos besoins.

   

Configurer Redocly SSO

Pour configurer l’authentification unique côté Redocly , vous devez envoyer le certificat téléchargé (PEM) et les URL appropriées copiées à partir de la configuration de l’application à l’équipe du support technique Redocly. Ils définissent ce paramètre pour que la connexion SAML SSO soit correctement définie sur les deux côtés.

Créer un utilisateur de test Redocly

Dans cette section, une utilisatrice appelée B.Simon est créée dans Redocly. Redocly prend en charge l’attribution d’utilisateurs juste-à-temps, option activée par défaut. Vous n’avez aucune opération à effectuer dans cette section. S’il n’existe pas encore d’utilisateur dans Redocly, un nouveau est généralement créé après l’authentification.

Tester l’authentification unique (SSO)

Dans cette section, vous testez votre configuration d’authentification unique Microsoft Entra avec les options suivantes.

• Sélectionnez Tester cette application, cette option redirige vers l’URL de connexion à Redocly où vous pouvez lancer le flux de connexion.

• Accédez directement à l’URL d’authentification de Redocly pour lancer le processus de connexion.

• Vous pouvez utiliser Microsoft My Apps. Lorsque vous sélectionnez la vignette Redocly dans Mes applications, cette option redirige vers l’URL de connexion à Redocly. Pour plus d’informations, consultez Microsoft Entra My Apps.

Ressources supplémentaires

• Qu’est-ce que l’authentification unique avec l’ID Microsoft Entra ?
• Planifiez un déploiement d’authentification unique.

Contenu connexe

Une fois que vous avez configuré Redocly, vous pouvez appliquer le contrôle de session, qui protège contre l’exfiltration et l’infiltration des données sensibles de votre organisation en temps réel. Le contrôle de session s’étend de l’accès conditionnel. Découvrez comment appliquer le contrôle de session avec Microsoft Cloud App Security.