Microsoft Entra SSO-integrering med Redocly

I den här artikeln får du lära dig hur du integrerar Redocly med Microsoft Entra-ID. Redocly är det första verktyget för utvecklardokumentation som gör att vi kan behålla dokumenten i GitHub och hålla utvecklardokumenten nära utvecklarna. När du integrerar Redocly med Microsoft Entra-ID kan du:

• Kontroll i Microsoft Entra-ID som har åtkomst till Redocly.
• Gör så att dina användare automatiskt loggas in på Redocly med sina Microsoft Entra-konton.
• Hantera dina konton på en central plats.

Du konfigurerar och testar enkel inloggning med Microsoft Entra för Redocly i en testmiljö. Redocly stöder SP-initierad enkel inloggning och just-in-time-användaretablering .

Förutsättningar

För att integrera Microsoft Entra-ID med Redocly behöver du:

• Ett Microsoft Entra-användarkonto. Om du inte redan har ett kan du skapa ett konto kostnadsfritt.
• En av följande roller: Programadministratör, Molnprogramadministratör eller Programägare.
• En Microsoft Entra-prenumeration. Om du inte har en prenumeration kan du få ett kostnadsfritt konto.
• Redocly-prenumeration med enkel inloggning (SSO).

Lägga till program och tilldela en testanvändare

Innan du börjar konfigurera enkel inloggning måste du lägga till Redocly-programmet från Microsoft Entra-galleriet. Du behöver ett testanvändarkonto för att tilldela till programmet och testa konfigurationen för enkel inloggning.

Lägg till Redocly från Microsoft Entra-galleriet

Lägg till Redocly från Microsoft Entra-programgalleriet för att konfigurera enkel inloggning med Redocly. Mer information om hur du lägger till program från galleriet finns i Snabbstart: Lägg till program från galleriet.

Skapa och tilldela Microsoft Entra-testanvändare

Följ riktlinjerna i artikeln skapa och tilldela ett användarkonto för att skapa ett testanvändarkonto med namnet B.Simon.

Du kan också använda guiden Konfiguration av företagsappar. I den här guiden kan du lägga till ett program i din klientorganisation, lägga till användare/grupper i appen och tilldela roller. Guiden innehåller också en länk till konfigurationsfönstret för enkel inloggning. Läs mer om Microsoft 365-guider..

Konfigurera enkel inloggning med Microsoft Entra

Slutför följande steg för att aktivera enkel inloggning med Microsoft Entra.

1. Logga in på administrationscentret för Microsoft Entra som minst molnprogramadministratör.

2. Bläddra till Identity>Applications>Enterprise-program> Redocly>Enkel inloggning.

3. På sidan Välj en enkel inloggningsmetod väljer du SAML.

4. På sidan Konfigurera enkel inloggning med SAML väljer du pennikonen för Grundläggande SAML-konfiguration för att redigera inställningarna.

   

5. I avsnittet Grundläggande SAML-konfiguration utför du följande steg:

   a. I textrutan Identifierare skriver du en URL med något av följande mönster:

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

   b. I textrutan Svars-URL skriver du en URL med något av följande mönster:

   Svarswebbadress
   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. I textrutan Inloggnings-URL skriver du en URL med något av följande mönster:

   Inloggnings-URL
   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

   Kommentar

   Dessa värden är inte verkliga. Uppdatera dessa värden med faktisk identifierare, svars-URL och inloggnings-URL. Kontakta Redocly-supportteamet för att hämta dessa värden. Du kan också referera till de mönster som visas i avsnittet Grundläggande SAML-konfiguration.

6. På sidan Konfigurera enkel inloggning med SAML går du till avsnittet SAML-signeringscertifikat och letar reda på Certifikat (PEM) och väljer Ladda ned för att ladda ned certifikatet och spara det på datorn.

   

7. I avsnittet Konfigurera Redocly kopierar du lämpliga URL:er baserat på dina behov.

   

Konfigurera Redocly SSO

För att konfigurera enkel inloggning på Redocly-sidan måste du skicka det nedladdade certifikatet (PEM) och lämpliga kopierade URL:er från programkonfigurationen till Supportteamet för Redocly. De anger inställningen så att SAML SSO-anslutningen ställs in korrekt på båda sidorna.

Skapa Redocly-testanvändare

I det här avsnittet skapas en användare med namnet B.Simon i Redocly. Redocly stöder just-in-time-användaretablering, vilket är aktiverat som standard. Det finns inget åtgärdsobjekt för dig i det här avsnittet. Om en användare inte redan finns i Redocly skapas ofta en ny efter autentisering.

Testa enkel inloggning

I det här avsnittet testar du konfigurationen av enkel inloggning med Microsoft Entra med följande alternativ.

• Klicka på Testa det här programmet. Detta omdirigeras till Redocly-inloggnings-URL där du kan initiera inloggningsflödet.

• Gå till Redocly Sign-on URL direkt och initiera inloggningsflödet därifrån.

• Du kan använda Microsoft Mina appar. När du klickar på Redocly-panelen i Mina appar omdirigeras den till Redocly-inloggnings-URL. Mer information finns i Microsoft Entra Mina appar.

Ytterligare resurser

• Vad är enkel inloggning med Microsoft Entra-ID?
• Planera en distribution med enkel inloggning.

Nästa steg

När du har konfigurerat Redocly kan du framtvinga sessionskontroll, vilket skyddar exfiltrering och infiltration av organisationens känsliga data i realtid. Sessionskontrollen utökas från villkorlig åtkomst. Lär dig hur du framtvingar sessionskontroll med Microsoft Cloud App Security.