Intégration de l’authentification unique Microsoft Entra à Redocly

Dans cet article, vous allez apprendre comment intégrer Redocly à Microsoft Entra ID. Redocly représente le premier outil de documentation pour les développeurs nous permettant de conserver les documents dans GitHub, tout en les gardant proches des développeurs. Lorsque vous intégrez Redocly à Microsoft Entra ID, vous pouvez :

• Contrôler dans Microsoft Entra ID qui a accès à Redocly.
• Permettre à vos utilisateurs d'être automatiquement connectés à Redocly avec leurs comptes Microsoft Entra.
• Gérer vos comptes à partir d’un emplacement central.

Vous allez configurer et tester l’authentification unique Microsoft Entra pour Redocly dans un environnement de test. Redocly prend en charge l’authentification unique lancée par le fournisseur de services et le provisionnement d’utilisateurs juste-à-temps.

Prérequis

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 d’application.
• Un abonnement Microsoft Entra. Si vous ne disposez d’aucun 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 à partir de la galerie Microsoft Entra. Vous avez besoin d’un compte d’utilisateur de test à affecter à l’application et de tester la configuration de l’authentification unique.

Ajouter Redocly à partir de la galerie Microsoft Entra

Ajoutez Redocly à partir de la galerie d’applications Microsoft Entra afin de 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 utilisateur pour créer un compte utilisateur test appelé B.Simon.

Vous pouvez également utiliser l’assistant Entreprise App Configuration. 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 Microsoft Entra SSO

Suivez les étapes ci-dessous pour activer l’authentification unique Microsoft Entra.

1. Connectez-vous au Centre d’administration de Microsoft Entra au minimum en tant qu’Administrateur d’application cloud.

2. Accédez à Identité>Applications>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 de crayon pour Configuration SAML de base afin de modifier les paramètres.

   

5. Dans la section Configuration SAML de base, effectuez les étapes suivantes :

   a. Dans la zone de texte Identificateur, tapez une URL en utilisant l’un des formats suivants :

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

   b. Dans la zone de texte URL de réponse , tapez une URL en respectant l’un des formats 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 en utilisant un des modèles suivants :

   URL d’authentification
   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

   Notes

   Il ne s’agit pas de valeurs réelles. Mettez à jour ces valeurs avec l’identificateur, l’URL d’authentification et l’URL de réponse réels. Pour obtenir ces valeurs, contactez l’équipe de support 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 Certificat (PEM), puis sélectionnez Télécharger pour télécharger le certificat et l’enregistrer sur votre ordinateur.

   

7. Dans la section Configurer Redocly, copiez l’URL ou les URL appropriées selon vos besoins.

   

Configurer l’authentification unique Redocly

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

Créer un utilisateur de test Redocly

Dans cette section, un utilisateur appelé B.Simon est créé dans Redocly. Redocly prend en charge l’approvisionnement d’utilisateurs juste-à-temps, une option activée par défaut. Vous n’avez aucune opération à effectuer dans cette section. S’il n’existe encore aucun 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.

• Cliquez sur Tester cette application. Vous êtes alors redirigé vers l’URL de connexion à Redocly, d’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 Mes applications de Microsoft. Dans Mes applications, cliquez sur la vignette Redocly, et vous êtes redirigé vers l’URL de connexion Redocly. Pour plus d’informations, consultez Mes applications Microsoft Entra.

Ressources supplémentaires

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

Étapes suivantes

Une fois Redocly configuré, vous pouvez appliquer le contrôle de session, protégeant en temps réel contre toute exfiltration et infiltration des données sensibles de votre organisation. Le contrôle de session est étendu à partir de l’accès conditionnel. Découvrez comment appliquer un contrôle de session avec Microsoft Cloud App Security.