Esercitazione: Integrazione dell'accesso Single Sign-On (SSO) di Microsoft Entra con Aventri

In questa esercitazione si apprenderà come integrare Aventri con Microsoft Entra ID. Integrando Aventri con Microsoft Entra ID, è possibile:

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

Per altre informazioni sull'integrazione delle app SaaS con Microsoft Entra ID, vedere Informazioni sull'accesso alle applicazioni e Single Sign-On con Microsoft Entra ID.

Prerequisiti

Per iniziare, sono necessari gli elementi seguenti:

  • Una sottoscrizione di Microsoft Entra. Se non si possiede una sottoscrizione, è possibile ottenere un account gratuito.
  • Sottoscrizione di Aventri abilitata per l'accesso Single Sign-On (SSO).

Descrizione dello scenario

In questa esercitazione viene configurato e testato l'accesso SSO di Microsoft Entra in un ambiente di test.

Per configurare l'integrazione di Aventri in Microsoft Entra ID, è necessario aggiungere Aventri dalla raccolta all'elenco di app SaaS gestite.

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un'applicazione cloud Amministrazione istrator.
  2. Passare a Applicazioni di identità>Applicazioni>aziendali>Nuova applicazione.
  3. Nella sezione Aggiungi dalla raccolta digitare Aventri nella casella di ricerca.
  4. Selezionare Aventri nel pannello dei risultati e quindi aggiungere l'app. Attendere alcuni secondi che l'app venga aggiunta al tenant.

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, assegnare ruoli, nonché esaminare la configurazione dell'accesso SSO. Altre informazioni sulle procedure guidate di Microsoft 365.

Configurare e testare l'accesso Single Sign-On di Microsoft Entra per Aventri

Configurare e testare l'accesso SSO di Microsoft Entra con Aventri usando un utente di test di nome B.Simon. Per consentire il funzionamento dell'accesso Single Sign-On, è necessario stabilire una relazione di collegamento tra un utente di Microsoft Entra e l'utente correlato in Aventri.

Per configurare e testare l'accesso SSO di Microsoft Entra con Aventri, completare le procedure di base seguenti:

  1. Configurare l'accesso Single Sign-On di Microsoft Entra: per consentire agli utenti di usare questa funzionalità.
    1. Creare un utente di test di Microsoft Entra: per testare l'accesso Single Sign-On di Microsoft Entra con B.Simon.
    2. Assegnare l'utente di test di Microsoft Entra : per abilitare B.Simon all'uso dell'accesso Single Sign-On di Microsoft Entra.
  2. Configurare l'accesso Single Sign-On di Aventri: per configurare le impostazioni di Single Sign-On sul lato applicazione.
    1. Creare l'utente di test di Aventri: per avere una controparte di B.Simon in Aventri collegata alla rappresentazione dell'utente in Microsoft Entra.
  3. Testare l'accesso Single Sign-On: per verificare se la configurazione funziona.

Configurare l'accesso Single Sign-On di Microsoft Entra

Seguire questa procedura per abilitare l'accesso Single Sign-On di Microsoft Entra.

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un'applicazione cloud Amministrazione istrator.

  2. Passare ad Applicazioni di identità>Applicazioni>aziendali>Aventri>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 Modifica (la penna) relativa a Configurazione SAML di base per modificare le impostazioni.

    Edit Basic SAML Configuration

  5. Nella sezione Configurazione SAML di base immettere i valori per i campi seguenti:

    a. Nella casella di testo URL di accesso digitare un URL nel formato seguente: https://na-admin.eventscloud.com/saml/accounts/acs/<ACCOUNTID>

    b. Nella casella di testo Identificatore (ID entità) digitare un URL nel formato seguente: https://na-admin.eventscloud.com/saml/accounts/sso/<ACCOUNTID>

    Nota

    Poiché questi non sono i valori reali, Aggiornare i valori con URL di accesso e identificatore effettivi, come illustrato più avanti nell'esercitazione.

  6. L'applicazione Aventri prevede un formato specifico per le asserzioni SAML. È quindi necessario aggiungere mapping di attributi personalizzati alla configurazione degli attributi del token SAML. Lo screenshot seguente mostra l'elenco degli attributi predefiniti.

    image

  7. Oltre quelli elencati in precedenza, l'applicazione Aventri prevede il passaggio di altri attributi nella risposta SAML. Tali attributi sono indicati di seguito. Anche questi attributi vengono prepopolati, ma è possibile esaminarli in base ai requisiti.

    Nome Attributo di origine
    Indirizzo e-mail user.mail
  8. Nella sezione Certificato di firma SAML della pagina Configura l'accesso Single Sign-On con SAML individuare il file XML dei metadati della federazione e selezionare Scarica per scaricare il certificato e salvarlo nel computer.

    The Certificate download link

  9. Nella sezione Configura Aventri copiare gli URL appropriati in base alle esigenze.

    Copy configuration URLs

Creare un utente di test di Microsoft Entra

In questa sezione verrà creato un utente di test di nome B.Simon.

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un utente Amministrazione istrator.
  2. Passare a Utenti>identità>Tutti gli utenti.
  3. Selezionare Nuovo utente Crea nuovo utente> nella parte superiore della schermata.
  4. Nelle proprietà Utente seguire questa procedura:
    1. Nel campo Nome visualizzato immettere B.Simon.
    2. Nel campo Nome entità utente immettere .username@companydomain.extension Ad esempio: B.Simon@contoso.com.
    3. Selezionare la casella di controllo Mostra password e quindi prendere nota del valore visualizzato nella casella Password.
    4. Selezionare Rivedi e crea.
  5. Seleziona Crea.

Assegnare l'utente di test di Microsoft Entra

In questa sezione si abiliterà B.Simon all'uso dell'accesso Single Sign-On concedendole l'accesso a Aventri.

  1. Accedere all'interfaccia di amministrazione di Microsoft Entra come almeno un'applicazione cloud Amministrazione istrator.

  2. Passare ad Applicazioni di identità>Applicazioni>aziendali>Aventri.

  3. Nella pagina di panoramica dell'app trovare la sezione Gestione e selezionare Utenti e gruppi.

    The

  4. Selezionare Aggiungi utente e quindi Utenti e gruppi nella finestra di dialogo Aggiungi assegnazione.

    The Add User link

  5. Nella finestra di dialogo Utenti e gruppi selezionare B.Simon dall'elenco degli utenti e quindi fare clic sul pulsante Seleziona nella parte inferiore della schermata.

  6. Se si prevede un valore di ruolo nell'asserzione SAML, nella finestra di dialogo Selezionare un ruolo selezionare il ruolo appropriato per l'utente dall'elenco e quindi fare clic sul pulsante Seleziona nella parte inferiore della schermata.

  7. Nella finestra di dialogo Aggiungi assegnazione fare clic sul pulsante Assegna.

Configurare l'accesso Single Sign-On di Aventri

  1. Per configurare l'accesso SSO per l'applicazione, seguire questa procedura nell'applicazione Aventri:

    Aventri configuration

    a. Accedere all'applicazione Aventri con i diritti di amministratore.

    b. Passare alla pagina di configurazione per SAML.

    c. Nella sezione General Settings (Impostazioni generali) aprire il certificato scaricato dal portale di Azure nel Blocco note, copiarne il contenuto e incollarlo nella casella di testo dei metadati IDP.

    d. Fare clic sul pulsante Save & Stay (Salva e rimani).

    e. Fare clic sul pulsante Update Metadata (Aggiorna metadati) nella sezione relativa ai metadati SAML.

    f. La pagina viene aperta e viene eseguito l'accesso SSO. Quando l'accesso SSO funziona, è possibile impostare il nome utente.

    g. Nel campo Username (Nome utente) selezionare emailaddress (indirizzo e-mail), come mostrato nell'immagine seguente.

    h. Copiare il valore dell'ID entità SP e incollarlo nella casella di testo Identificatore, disponibile nella sezione Configurazione SAML di base.

    i. Copiare il valore SSO URL/ACS e incollarlo nella casella di testo URL di accesso, disponibile nella sezione Configurazione SAML di base.

Creare l'utente di test di Aventri

In questa sezione viene creato un utente di nome B.Simon in Aventri. Collaborare con il team di supporto clienti di Aventri per aggiungere gli utenti alla piattaforma Aventri.

Testare l'accesso SSO

In questa sezione viene testata la configurazione dell'accesso Single Sign-On di Microsoft Entra usando il Pannello di accesso.

Quando si fa clic sul riquadro di Aventri nel pannello di accesso, si dovrebbe accedere automaticamente all'istanza di Aventri per cui si è configurato l'accesso SSO. Per altre informazioni sul Pannello di accesso, vedere Introduzione al Pannello di accesso.

Risorse aggiuntive