Esercitazione: integrazione di Azure Active Directory con Voyance

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

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

  • È possibile controllare in Azure AD chi può accedere a Voyance
  • È possibile abilitare gli utenti per l'accesso automatico a Voyance (Single Sign-On) con i propri account Azure AD
  • È possibile gestire gli account in un'unica 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 Voyance, sono necessari gli elementi seguenti:

  • Sottoscrizione di Azure AD.
  • Sottoscrizione di Voyance 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 Voyance dalla raccolta
  2. Configurazione e test dell'accesso Single Sign-On di Azure AD

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

Per aggiungere Voyance 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 Voyance, selezionare Voyance nel pannello dei risultati e quindi fare clic sul pulsante Aggiungi per aggiungere l'applicazione.

    Voyance 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 Voyance 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 Voyance 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 Voyance.

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

Per configurare e testare l'accesso Single Sign-On di Azure AD con Voyance, è necessario completare le operazioni fondamentali 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 di test di Voyance: per avere una controparte di Britta Simon in Voyance 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 nell'applicazione Voyance.

Per configurare l'accesso Single Sign-On di Azure AD con Voyance, seguire questa procedura:

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

    Collegamento Configura 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 Voyance seguire questa procedura se si vuole configurare l'applicazione in modalità avviata da IDP:

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

    a. Nella casella di testo Identificatore digitare l'URL adottando il modello seguente: https://<companyname>.nyansa.com

    b. Nella casella di testo URL di risposta digitare l'URL usando il modello seguente: https://<companyname>.nyansa.com/saml/create/

  4. Selezionare Mostra impostazioni URL avanzate e seguire questa procedura se si vuole configurare l'applicazione in modalità avviata da SP:

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

    Nella casella di testo URL di accesso digitare l'URL usando il modello seguente: https://<companyname>.nyansa.com/.

    Nota

    Poiché questi non sono i valori reali, aggiornarli con l'identificatore, l'URL di risposta e l'URL di accesso effettivi. Per ottenere questi valori, contattare il team di supporto clienti di Voyance.

  5. Nella sezione Certificato di firma SAML fare clic su Certificato (Base64) e quindi salvare il file del certificato nel computer.

    Collegamento di download del certificato

  6. Fare clic sul pulsante Salva .

    Pulsante Salva per la configurazione dell'accesso Single Sign-On

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

    Configurazione di Voyance

  8. In un'altra finestra del browser Web accedere al tenant Voyance come amministratore.

  9. Passare all'angolo superiore destro della barra di spostamento e fare clic nell'elenco a discesa "Acme University".

    Configurare l'accesso Single Sign-On sul lato app - Acme University

  10. Fare clic su "Admin Settings" (Impostazioni amministrazione).

    Configurare l'accesso Single Sign-On sul lato app - Impostazioni di amministrazione

  11. Fare clic sulla scheda "User Access" (Accesso utente).

    Configurare l'accesso Single Sign-On sul lato app - Accesso utente

  12. Fare clic sul pulsante "SSO is disabled" (SSO disabilitato) per configurare Azure AD come IdP tramite SAML 2.0.

    Configurare l'accesso Single Sign-On sul lato app - Pulsante che indica che l'accesso SSO è disabilitato

  13. Passare alla sezione SAML v2 e seguire questa procedura:

    Configurare l'accesso Single Sign-On sul lato app - SAML v2

    a. Selezionare Enabled.

    b. Incollare l'URL del servizio Single Sign-On SAML copiato dal portale di Azure nella casella di testoIdP Login URL (URL di accesso IdP).

    c. Aprire il certificato con codifica Base64 scaricato nel Blocco note, copiarne il contenuto negli Appunti e quindi incollarlo nella casella di testo IdP Cert (Certificato IdP).

    d. Fare clic su Salva.

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 sull'icona di Azure Active Directory nel riquadro di spostamento sinistro.

    Pulsante Azure Active Directory

  2. Passare a Utenti e gruppi e fare clic su Tutti gli utenti per visualizzare l'elenco di utenti.

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

  3. Nella parte superiore della finestra di dialogo fare clic su Aggiungi per aprire la finestra di dialogo Utente.

    Pulsante Aggiungi

  4. Nella pagina della finestra di dialogo Utente seguire questa procedura:

    Finestra di dialogo Utente

    a. Nella casella di testo Nome digitare BrittaSimon.

    b. Nella casella di testo Nome utente digitare l'indirizzo di posta elettronica di BrittaSimon.

    c. Selezionare Mostra password e prendere nota del valore della Password.

    d. Fare clic su Crea.

Creare un utente test di Voyance

Questa sezione descrive come creare un utente chiamato Britta Simon in Voyance. Voyance supporta il provisioning just-in-time, che è abilitato per impostazione predefinita. Non è necessario alcun intervento dell'utente in questa sezione. Durante il tentativo di accesso a Voyance viene creato un nuovo utente, se questo non esiste già.

Nota

Per creare un utente manualmente, contattare il team di supporto di Voyance.

Assegnare l'utente test di Azure AD

In questa sezione Britta Simon viene abilitata per l'uso dell'accesso Single Sign-On di Azure concedendole l'accesso a Voyance.

Assegnare il ruolo utente

Per assegnare Britta Simon a Voyance, 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 di applicazioni selezionare Voyance.

    Collegamento di Voyance 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 Voyance nel pannello di accesso, si dovrebbe accedere automaticamente all'applicazione Voyance.

Risorse aggiuntive