Integracja logowania jednokrotnego firmy Microsoft z aplikacją Redocly
Z tego artykułu dowiesz się, jak zintegrować aplikację Redocly z identyfikatorem Entra firmy Microsoft. Redocly to pierwsze narzędzie do dokumentacji dla deweloperów, które pozwala nam przechowywać dokumenty w usłudze GitHub, utrzymując dokumentację deweloperów blisko deweloperów. Po zintegrowaniu aplikacji Redocly z usługą Microsoft Entra ID można wykonywać następujące czynności:
- Kontroluj w usłudze Microsoft Entra ID, kto ma dostęp do narzędzia Redocly.
- Umożliwianie użytkownikom automatycznego logowania się do aplikacji Redocly przy użyciu kont Microsoft Entra.
- Zarządzaj kontami w jednej centralnej lokalizacji.
Skonfigurujesz i przetestujesz logowanie jednokrotne firmy Microsoft Entra dla aplikacji Redocly w środowisku testowym. Narzędzie Redocly obsługuje logowanie jednokrotne inicjowane przez dostawcę usług i aprowizowanie użytkowników typu Just In Time.
Wymagania wstępne
Aby zintegrować aplikację Microsoft Entra ID z aplikacją Redocly, potrzebne są następujące elementy:
- Konto użytkownika Microsoft Entra. Jeśli jeszcze go nie masz, możesz bezpłatnie utworzyć konto.
- Jedną z następujących ról: Administracja istrator aplikacji, Administracja istrator aplikacji w chmurze lub właściciel aplikacji.
- Subskrypcja firmy Microsoft Entra. Jeśli nie masz subskrypcji, możesz uzyskać bezpłatne konto.
- Ponowne logowanie jednokrotne (SSO) — subskrypcja z obsługą logowania jednokrotnego.
Dodawanie aplikacji i przypisywanie użytkownika testowego
Przed rozpoczęciem procesu konfigurowania logowania jednokrotnego należy dodać aplikację Redocly z galerii Microsoft Entra. Do przypisania do aplikacji i przetestowania konfiguracji logowania jednokrotnego potrzebne jest konto użytkownika testowego.
Dodawanie aplikacji Redocly z galerii Microsoft Entra
Dodaj aplikację Redocly z galerii aplikacji Microsoft Entra, aby skonfigurować logowanie jednokrotne w aplikacji Redocly. Aby uzyskać więcej informacji na temat dodawania aplikacji z galerii, zobacz Przewodnik Szybki start: Dodawanie aplikacji z galerii.
Tworzenie i przypisywanie użytkownika testowego aplikacji Microsoft Entra
Postępuj zgodnie z wytycznymi w artykule Tworzenie i przypisywanie konta użytkownika, aby utworzyć testowe konto użytkownika o nazwie B.Simon.
Alternatywnie można również użyć Kreatora konfiguracji aplikacji dla przedsiębiorstw. W tym kreatorze możesz dodać aplikację do dzierżawy, dodać użytkowników/grupy do aplikacji i przypisać role. Kreator udostępnia również link do okienka konfiguracji logowania jednokrotnego. Dowiedz się więcej o kreatorach platformy Microsoft 365.
Konfigurowanie logowania jednokrotnego firmy Microsoft
Wykonaj poniższe kroki, aby włączyć logowanie jednokrotne firmy Microsoft Entra.
Zaloguj się do centrum administracyjnego firmy Microsoft Entra jako co najmniej Administracja istrator aplikacji w chmurze.
Przejdź do sekcji Identity>Applications Enterprise Applications>>Redocly>Single sign-on (Ponowne logowanie jednokrotne).
Na stronie Wybieranie metody logowania jednokrotnego wybierz pozycję SAML.
Na stronie Konfigurowanie logowania jednokrotnego przy użyciu protokołu SAML wybierz ikonę ołówka podstawową konfigurację protokołu SAML, aby edytować ustawienia.
W sekcji Podstawowa konfiguracja protokołu SAML wykonaj następujące czynności:
a. W polu tekstowym Identyfikator wpisz adres URL, używając jednego z następujących wzorców:
Identyfikator https://api.redocly.com/auth/sso?idpId=<CustomerId>https://api.<Region>.redocly.com/auth/sso?idpId=<CustomerId>b. W polu tekstowym Adres URL odpowiedzi wpisz adres URL, używając jednego z następujących wzorców:
Adres URL odpowiedzi https://api.redocly.com/auth/ssohttps://api.<Region>.redocly.com/auth/ssohttps://<SiteName>.redoc.dev/_auth/saml2https://<SiteName>.<REGION>.redoc.dev/_auth/saml2c. W polu tekstowym Adres URL logowania wpisz adres URL , używając jednego z następujących wzorców:
Adres URL logowania https://app.redocly.com/login-ssohttps://app.<Region>.redocly.com/login-ssohttps://<SiteName>.redoc.dev/_auth/idp-loginhttps://<SiteName>.<REGION>.redoc.dev/_auth/idp-loginUwaga
Te wartości nie są prawdziwe. Zaktualizuj te wartości przy użyciu rzeczywistego identyfikatora, adresu URL odpowiedzi i adresu URL logowania. Skontaktuj się z zespołem pomocy technicznej aplikacji Redocly, aby uzyskać te wartości. Możesz również odwołać się do wzorców przedstawionych w sekcji Podstawowa konfiguracja protokołu SAML.
Na stronie Konfigurowanie logowania jednokrotnego przy użyciu protokołu SAML w sekcji Certyfikat podpisywania SAML znajdź pozycję Certyfikat (PEM) i wybierz pozycję Pobierz, aby pobrać certyfikat i zapisać go na komputerze.
W sekcji Konfigurowanie aplikacji Redocly skopiuj odpowiednie adresy URL zgodnie z wymaganiami.
Konfigurowanie ponownego logowania jednokrotnego
Aby skonfigurować logowanie jednokrotne po stronie aplikacji Redocly , musisz wysłać pobrany certyfikat (PEM) i odpowiednie adresy URL skopiowane z konfiguracji aplikacji do zespołu pomocy technicznej aplikacji Redocly. Ustawią oni to ustawienie tak, aby połączenie logowania jednokrotnego SAML było ustawione właściwie po obu stronach.
Tworzenie użytkownika testowego aplikacji Redocly
W tej sekcji w aplikacji Redocly jest tworzony użytkownik o nazwie B.Simon. Aplikacja Redocly obsługuje aprowizację użytkowników typu just in time, która jest domyślnie włączona. W tej sekcji nie ma elementu akcji. Jeśli użytkownik jeszcze nie istnieje w redocly, nowy jest często tworzony po uwierzytelnieniu.
Testowanie logowania jednokrotnego
W tej sekcji przetestujesz konfigurację logowania jednokrotnego firmy Microsoft z następującymi opcjami.
Kliknij pozycję Przetestuj tę aplikację. Spowoduje to przekierowanie do adresu URL ponownego logowania, w którym można zainicjować przepływ logowania.
Przejdź bezpośrednio do adresu URL logowania ponownego i zainicjuj przepływ logowania z tego miejsca.
Możesz użyć usługi Microsoft Moje aplikacje. Po kliknięciu kafelka Redocly w Moje aplikacje nastąpi przekierowanie do adresu URL ponownego logowania. Aby uzyskać więcej informacji, zobacz Microsoft Entra Moje aplikacje.
Dodatkowe zasoby
- Co to jest logowanie jednokrotne w usłudze Microsoft Entra ID?
- Planowanie wdrożenia logowania jednokrotnego.
Następne kroki
Po skonfigurowaniu narzędzia Redocly możesz wymusić kontrolę sesji, która chroni eksfiltrację i infiltrację poufnych danych organizacji w czasie rzeczywistym. Kontrola sesji rozszerza się od dostępu warunkowego. Dowiedz się, jak wymusić kontrolę sesji za pomocą usługi Microsoft Cloud App Security.