Integrazione di Microsoft Entra SSO con Redocly

In questo articolo si apprenderà come integrare Redocly con Microsoft Entra ID. Redocly è il primo strumento di documentazione per sviluppatori che consente di mantenere la documentazione in GitHub, mantenendo la documentazione degli sviluppatori vicina agli sviluppatori. Integrando Redocly con Microsoft Entra ID, è possibile:

• Controllare in Microsoft Entra ID chi può accedere a Redocly.
• Abilitare gli utenti per l'accesso automatico a Redocly con gli account Microsoft Entra personali.
• Gestire gli account in un'unica posizione centrale.

Verrà configurato e testato l'accesso Single Sign-On di Microsoft Entra per Redocly in un ambiente di test. Redocly supporta l'accesso Single Sign-On avviato da SP e il provisioning utenti JIT .

Prerequisiti

Per integrare Microsoft Entra ID con Redocly, è necessario:

• Un account utente di Microsoft Entra. Se non è già disponibile, è possibile creare gratuitamente un account.
• Uno dei ruoli seguenti: Application Amministrazione istrator, Cloud Application Amministrazione istrator o Application Owner.
• Una sottoscrizione di Microsoft Entra. Se non si possiede una sottoscrizione, è possibile ottenere un account gratuito.
• Sottoscrizione di Redocly abilitata per l'accesso Single Sign-On (SSO).

Aggiungere un'applicazione e assegnare un utente di test

Prima di iniziare il processo di configurazione dell'accesso Single Sign-On, è necessario aggiungere l'applicazione Redocly dalla raccolta di Microsoft Entra. È necessario un account utente di test per assegnare all'applicazione e testare la configurazione dell'accesso Single Sign-On.

Aggiungere Redocly dalla raccolta di Microsoft Entra

Aggiungere Redocly dalla raccolta di applicazioni di Microsoft Entra per configurare l'accesso Single Sign-On con Redocly. Per altre informazioni su come aggiungere un'applicazione dalla raccolta, vedere Avvio rapido: Aggiungere un'applicazione dalla raccolta.

Creare e assegnare l'utente di test di Microsoft Entra

Seguire le linee guida nell'articolo Creare e assegnare un account utente per creare un account utente di test di nome B.Simon.

In alternativa, è anche possibile usare l'Enterprise Configurazione app Wizard. In questa procedura guidata è possibile aggiungere un'applicazione al tenant, aggiungere utenti/gruppi all'app e assegnare ruoli. La procedura guidata fornisce anche un collegamento al riquadro di configurazione dell'accesso Single Sign-On. Altre informazioni sulle procedure guidate di Microsoft 365.

Configurare l'accesso Single Sign-On di Microsoft Entra

Completare i passaggi seguenti per abilitare l'accesso Single Sign-On di Microsoft Entra.

1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.

2. Passare ad Applicazioni di identità>Applicazioni>aziendali>Redocly>Single Sign-On.

3. Nella pagina Selezionare un metodo di accesso Single Sign-On selezionare SAML.

4. Nella pagina Configura l'accesso Single Sign-On con SAML fare clic sull'icona della matita relativa a Configurazione SAML di base per modificare le impostazioni.

   

5. Nella sezione Configurazione SAML di base seguire questa procedura:

   a. Nella casella di testo Identificatore digitare un URL in uno dei formati seguenti:

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

   b. Nella casella di testo URL di risposta digitare un URL corrispondente al modello seguente:

   URL di risposta
   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. Nella casella di testo URL di accesso digitare un URL usando uno dei modelli seguenti:

   URL di accesso
   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

   Nota

   Poiché questi non sono i valori reali, è necessario aggiornarli con l'identificatore, l'URL di risposta e l'URL di accesso effettivi. Per ottenere questi valori, contattare il team di supporto di Redocly. È anche possibile fare riferimento ai modelli illustrati nella sezione Configurazione SAML di base.

6. Nella sezione Certificato di firma SAML della pagina Configura l'accesso Single Sign-On con SAML individuare Certificato (PEM) e selezionare Scarica per scaricare il certificato e salvarlo nel computer.

   

7. Nella sezione Configura Redocly copiare gli URL appropriati in base alle esigenze.

   

Configurare l'accesso Single Sign-On di Redocly

Per configurare l'accesso Single Sign-On sul lato Redocly, è necessario inviare il file Certificato (PEM) scaricato e gli URL appropriati copiati dalla configurazione dell'applicazione al team di supporto di Redocly. La configurazione viene eseguita in modo che la connessione SSO SAML sia impostata correttamente su entrambi i lati.

Creare l'utente di test di Redocly

In questa sezione viene creato un utente di nome B.Simon in Redocly. Redocly supporta il provisioning utenti JIT, che è abilitato per impostazione predefinita. Non è necessario alcun intervento dell'utente in questa sezione. Se non esiste già un utente in Redocly, ne viene in genere creato uno nuovo dopo l'autenticazione.

Testare l'accesso SSO

In questa sezione viene testata la configurazione dell'accesso Single Sign-On di Microsoft Entra con le opzioni seguenti.

• Fare clic su Test this application (Testa questa applicazione), verrà eseguito il reindirizzamento all'URL di accesso di Redocly in cui è possibile avviare il flusso di accesso.

• Passare direttamente all'URL di accesso di Redocly e avviare il flusso di accesso da questa posizione.

• È possibile usare App personali Microsoft. Quando si fa clic sul riquadro Redocly nella App personali, verrà eseguito il reindirizzamento all'URL di accesso redocly. Per altre informazioni, vedere Microsoft Entra App personali.

Risorse aggiuntive

• Che cos'è l'accesso Single Sign-On con Microsoft Entra ID?
• Pianificare una distribuzione dell'accesso Single Sign-On.

Passaggi successivi

Dopo aver configurato Redocly, è possibile applicare il controllo sessione che consente di proteggere in tempo reale l'esfiltrazione e l'infiltrazione dei dati sensibili dell'organizzazione. Il controllo sessione costituisce un'estensione dell'accesso condizionale. Informazioni su come applicare il controllo sessione con Microsoft Cloud App Security.