Esercitazione: Integrazione di Azure Active Directory con Envoy

Questa esercitazione descrive come integrare Envoy con Azure Active Directory (Azure AD).

L'integrazione di Envoy con Azure AD offre i vantaggi seguenti:

  • È possibile controllare in Azure AD chi può accedere a Envoy.
  • È possibile abilitare gli utenti per l'accesso automatico a Envoy (Single Sign-On) con i propri account Azure AD.
  • È possibile gestire gli account da una posizione centrale: il portale di Azure.

Per altre informazioni sull'integrazione di app SaaS con Azure AD, vedere Informazioni sull'accesso alle applicazioni e Single Sign-On con Azure Active Directory.

Prerequisiti

Per configurare l'integrazione di Azure AD con Envoy, sono necessari gli elementi seguenti:

  • Sottoscrizione di Azure AD.
  • Sottoscrizione di Envoy abilitata per l'accesso Single Sign-On.

Nota

Non è consigliabile usare un ambiente di produzione per testare i passaggi di questa esercitazione.

A questo scopo, è consigliabile seguire le indicazioni seguenti:

Descrizione dello scenario

In questa esercitazione viene eseguito il test dell'accesso Single Sign-On di Azure AD in un ambiente di test. Lo scenario descritto in questa esercitazione prevede i due blocchi predefiniti seguenti:

  1. Aggiunta di Envoy dalla raccolta
  2. Configurazione e test dell'accesso Single Sign-On di Azure AD

Per configurare l'integrazione di Envoy in Azure AD, è necessario aggiungere Envoy dalla raccolta al proprio elenco delle app SaaS gestite.

Per aggiungere Envoy dalla raccolta, seguire questa procedura:

  1. Nel portale di Azure fare clic sull'icona di Azure Active Directory nel riquadro di spostamento sinistro.

    Pulsante Azure Active Directory

  2. Passare ad Applicazioni aziendali. Andare quindi a Tutte le applicazioni.

    Pannello Applicazioni aziendali

  3. Fare clic sul pulsante Nuova applicazione nella parte superiore della finestra di dialogo per aggiungere una nuova applicazione.

    Pulsante Nuova applicazione

  4. Nella casella di ricerca digitare Envoy selezionare Envoy dal pannello dei risultati e quindi fare clic sul pulsante Aggiungi per aggiungere l'applicazione.

    Envoy nell'elenco risultati

Configurare e testare l'accesso Single Sign-On di Azure AD

In questa sezione viene configurato e testato l'accesso Single Sign-On di Azure AD con Envoy in base a un utente test di nome "Britta Simon".

Per il funzionamento dell'accesso Single Sign-On, Azure AD deve conoscere qual è l'utente di Envoy che corrisponde a un utente di Azure AD. In altre parole, deve essere stabilita una relazione di collegamento tra un utente di Azure AD e l'utente correlato in Envoy.

Per stabilire la relazione di collegamento, in Envoy assegnare il valore di nome utente in Azure AD come valore di Username (Nome utente).

Per configurare e testare l'accesso Single Sign-On di Azure AD con Envoy, è necessario completare i blocchi predefiniti seguenti:

  1. Configurare l'accesso Single Sign-On di Azure AD: per consentire agli utenti di usare questa funzionalità.
  2. Creare un utente di test di Azure AD: per testare l'accesso Single Sign-On di Azure AD con l'utente Britta Simon.
  3. Creare un utente test di Envoy: per avere una controparte di Britta Simon in Envoy collegata alla rappresentazione dell'utente in Azure AD.
  4. Assegnare l'utente test di Azure AD: per abilitare Britta Simon all'uso dell'accesso Single Sign-On di Azure AD.
  5. Testare l'accesso Single Sign-On per verificare se la configurazione funziona.

Configurare l'accesso Single Sign-On di Azure AD

In questa sezione viene abilitato l'accesso Single Sign-On di Azure AD nel portale di Azure e viene configurato l'accesso Single Sign-On con l'applicazione Envoy.

Per configurare Single Sign-On di Azure AD con Envoy, seguire questa procedura:

  1. Nella pagina di integrazione dell'applicazione Envoy del portale di Azure fare clic su Single Sign-On.

    Collegamento per la configurazione dell'accesso Single Sign-On

  2. Nella finestra di dialogo Single Sign-On selezionare Accesso basato su SAML per Modalità per abilitare l'accesso Single Sign-On.

    Finestra di dialogo Single Sign-On

  3. Nella sezione URL e dominio Envoy seguire questa procedura:

    Informazioni su URL e dominio per l'accesso Single Sign-On di Envoy

    Nella casella di testo URL di accesso digitare l'URL usando il modello seguente: https://<tenant-name>.Envoy.com.

    Nota

    Poiché non è reale, è necessario aggiornare questo valore con l'URL di accesso effettivo. Per ottenere il valore contattare il team di supporto clienti di Envoy.

  4. Nella sezione Certificato di firma SAML copiare il valore IDENTIFICAZIONE PERSONALE del certificato.

    Collegamento di download del certificato

  5. Fare clic sul pulsante Salva .

    Pulsante Salva di Configura accesso Single Sign-On

  6. Nella sezione Configurazione di Envoy fare clic su Configura Envoy per aprire la finestra Configura accesso. Copiare l'URL servizio Single Sign-On SAML dalla sezione Riferimento rapido.

    Configurazione di Envoy

  7. In un'altra finestra del Web browser accedere al sito aziendale di Envoy come amministratore.

  8. Nel barra degli strumenti in alto fare clic su Impostazioni.

    Envoy

  9. Fare clic su Azienda.

    Azienda

  10. Fare clic su SAML.

    SAML

  11. Nella sezione di configurazione SAML Authentication seguire questa procedura:

    Autenticazione SAML

    Nota

    Il valore dell'ID della sede centrale viene generato automaticamente dall'applicazione.

    a. Nella casella di testo Fingerprint (Impronta digitale) incollare il valore Identificazione personale del certificato copiato dal portale di Azure.

    b. Incollare il valore dell'URL del servizio Single Sign-On SAML copiato dal portale di Azure nella casella di testo IDENTITY PROVIDER HTTP SAML URL (URL SAML HTTP DEL PROVIDER DI IDENTITÀ).

    c. Fare clic su Salva modifiche.

Suggerimento

Un riepilogo delle istruzioni è disponibile all'interno del portale di Azure durante la configurazione dell'app. Dopo aver aggiunto l'app dalla sezione Active Directory > Applicazioni aziendali è sufficiente fare clic sulla scheda Single Sign-On e accedere alla documentazione incorporata tramite la sezione Configurazione nella parte inferiore. Altre informazioni sulla funzione di documentazione incorporata sono disponibili in Azure AD embedded documentation (Documentazione incorporata di Azure AD).

Creare un utente test di Azure AD

Questa sezione descrive come creare un utente test denominato Britta Simon nel portale di Azure.

Creare un utente test di Azure AD

Per creare un utente test in Azure AD, eseguire la procedura seguente:

  1. Nel portale di Azure fare clic sul pulsante Azure Active Directory nel riquadro sinistro.

    Pulsante Azure Active Directory

  2. Per visualizzare l'elenco di utenti, passare a Utenti e gruppi e quindi fare clic su Tutti gli utenti.

    Collegamenti "Utenti e gruppi" e "Tutti gli utenti"

  3. Per aprire la finestra di dialogo Utente fare clic su Aggiungi nella parte superiore della finestra di dialogo Tutti gli utenti.

    Pulsante Aggiungi

  4. Nella finestra di dialogo Utente seguire questa procedura:

    Finestra di dialogo Utente

    a. Nella casella Nome digitare BrittaSimon.

    b. Nella casella Nome utente digitare l'indirizzo di posta elettronica dell'utente Britta Simon.

    c. Selezionare la casella di controllo Mostra password e quindi prendere nota del valore visualizzato nella casella Password.

    d. Fare clic su Crea.

Creare un utente test di Envoy

Non è necessaria alcuna attività di configurazione per il provisioning degli utenti in Envoy. Quando un utente assegnato prova ad accedere a Envoy usando il pannello di accesso, Envoy verifica se l'utente esiste. Se l'account utente non è presente, Envoy lo crea automaticamente.

Assegnare l'utente test di Azure AD

In questa sezione Britta Simon viene abilitata per l'uso dell'accesso Single Sign-On di Azure tramite la concessione dell'accesso a Envoy.

Assegnare il ruolo utente

Per assegnare Britta Simon a Envoy, seguire questa procedura:

  1. Nel portale di Azure aprire la visualizzazione delle applicazioni e quindi la visualizzazione delle directory e passare ad Applicazioni aziendali, quindi fare clic su Tutte le applicazioni.

    Assegna utente

  2. Nell'elenco delle applicazioni selezionare Envoy.

    Collegamento di Envoy nell'elenco delle applicazioni

  3. Scegliere Utenti e gruppi dal menu a sinistra.

    Collegamento "Utenti e gruppi"

  4. Fare clic sul pulsante Aggiungi. Selezionare quindi Utenti e gruppi nella finestra di dialogo Aggiungi assegnazione.

    Riquadro Aggiungi assegnazione

  5. Nella finestra di dialogo Utenti e gruppi selezionare Britta Simon nell'elenco Utenti.

  6. Fare clic sul pulsante Seleziona nella finestra di dialogo Utenti e gruppi.

  7. Fare clic sul pulsante Assegna nella finestra di dialogo Aggiungi assegnazione.

Testare l'accesso Single Sign-On

In questa sezione viene testata la configurazione dell'accesso Single Sign-On di Azure AD usando il pannello di accesso.

Quando si fa clic sul riquadro Envoy nel pannello di accesso, si dovrebbe accedere automaticamente all'applicazione Envoy. Per altre informazioni sul pannello di accesso, vedere Introduzione al Pannello di accesso.

Risorse aggiuntive