Esercitazione: Integrazione di Azure Active Directory con TOPdesk - Public

Questa esercitazione descrive come integrare TOPdesk - Public con Azure Active Directory (Azure AD).

L'integrazione di TOPdesk - Public con Azure AD offre i vantaggi seguenti:

  • È possibile controllare in Azure AD chi può accedere a TOPdesk - Public.
  • È possibile abilitare gli utenti per l'accesso automatico a TOPdesk - Public (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 TOPdesk - Public, sono necessari gli elementi seguenti:

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

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

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

    TOPdesk - Public nell'elenco dei 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 TOPdesk - Public usando un utente di test di nome "Britta Simon".

Per il funzionamento dell'accesso Single Sign-On, Azure AD deve conoscere l'utente controparte di TOPdesk - Public 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 TOPdesk - Public.

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

Per configurare e testare l'accesso Single Sign-On di Azure AD con TOPdesk - Public, è 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 di test per TOPdesk - Public: per avere una controparte di Britta Simon in TOPdesk - Public 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 OPdesk - Public.

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

  1. Nella pagina di integrazione dell'applicazione TOPdesk - Public 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 TOPdesk - Public seguire questa procedura:

    Informazioni sull'accesso Single Sign-On per URL e dominio di TOPdesk - Public

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

    b. Nella casella di testo Identificatore digitare l'URL adottando il modello seguente: https://<companyname>.topdesk.net/tas/public/login/verify

    c. Nella casella di testo URL di risposta digitare l'URL usando il modello seguente: https://<companyname>.topdesk.net/tas/public/login/saml

    Nota

    Poiché questi non sono i valori reali, aggiornarli con l'identificatore, l'URL di risposta e l'URL di accesso effettivi. L'URL di risposta è descritto più avanti nell'esercitazione. Per ottenere questi valori, contattare il team di supporto clienti di TOPdesk - Public.

  4. Nella sezione Certificato di firma SAML fare clic su XML di metadati e quindi salvare il file dei metadati nel computer.

    Collegamento di download del certificato

  5. Fare clic sul pulsante Salva .

    Pulsante Salva di Configura accesso Single Sign-On

  6. Nella sezione Configurazione di TOPdesk - Public fare clic su Configura TOPdesk - Public per aprire la finestra Configura accesso. Copiare l'URL di disconnessione, l'ID di entità SAML e l'URL del servizio Single Sign-On SAML dalla sezione Riferimento rapido.

    Configurazione di TOPdesk - Public

  7. Accedere al sito aziendale di TOPdesk - Public come un amministratore.

  8. Nel menu TOPdesk fare clic su Settings (Impostazioni).

    Impostazioni

  9. Fare clic su Login Settings.

    Login Settings

  10. Espandere il menu Login Settings (Impostazioni accesso) e quindi fare clic su General (Generale).

    General

  11. Nell'area Public (Publico) della sezione di configurazione SAML login (Accesso SAML) seguire questa procedura:

    Technical Settings

    a. Fare clic su Download per scaricare il file di metadati pubblici e quindi salvarlo in locale nel computer.

    b. Aprire il file dei metadati scaricato e quindi individuare il nodo AssertionConsumerService .

    AssertionConsumerService

    c. Copiare il valore AssertionConsumerService, incollarlo nella casella di testo URL di risposta nella sezione URL e dominio TOPdesk - Public.

  12. Per creare un file del certificato, seguire questa procedura:

    Certificate

    a. Aprire il file di metadati scaricato dal portale di Azure.

    b. Espandere il nodo RoleDescriptor con xsi:type corrispondente a fed:ApplicationServiceType.

    c. Copiare il valore del nodo X509Certificate .

    d. Salvare il valore copiato di X509Certificate in un file locale nel computer.

  13. Nell'area Public (Pubblica) fare clic su Add (Aggiungi).

    Login SAML

  14. Nella pagina SAML configuration assistant seguire questa procedura:

    SAML Configuration Assistant

    a. Per caricare il file di metadati scaricato dal portale di Azure, in Metadati della federazione fare clic su Sfoglia.

    b. Per caricare il file del certificato, in Certificate (RSA) (Certificato RSA) fare clic su Browse (Sfoglia).

    c. Per caricare il file del logo ottenuto dal team di supporto del team di TOPdesk, in Logo icon (Icona logo) fare clic su Browse (Sfoglia).

    d. Nella casella di testo User name attribute (Attributo nome utente) digitare http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress.

    e. Nella casella di testo Display name digitare un nome per la configurazione.

    f. Fare clic su Save.

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 di test di TOPdesk - Public

Per consentire agli utenti di Azure AD di accedere a TOPdesk - Public, è necessario eseguirne il provisioning in TOPdesk - Public.
Nel caso di TOPdesk - Public, il provisioning è un'attività manuale.

Per configurare il provisioning utente, seguire questa procedura:

  1. Accedere al sito aziendale di TOPdesk - Public come amministratore.

  2. Nel menu presente sulla parte superiore fare clic su TOPdesk > New (Nuovo) > Support Files (File di supporto) > Person (Persona).

    Person

  3. Nella finestra di dialogo New Person seguire questa procedura:

    New Person

    a. Fare clic sulla scheda General.

    b. Digitare il cognome dell'utente, ad esempio Simon, nella casella di testo Surname (Cognome)

    c. Selezionare un Site per l'account.

    d. Fare clic su Salva.

Nota

È possibile usare qualsiasi altro strumento o API di creazione account utente fornita da TOPdesk - Public per eseguire il provisioning degli account utente Azure AD.

Assegnare l'utente test di Azure AD

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

Assegnare il ruolo utente

Per assegnare Britta Simon a TOPdesk - Public, 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 TOPdesk - Public.

    Collegamento TOPdesk - Public 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 TOPdesk - Public nel pannello di accesso, si dovrebbe accedere automaticamente all'applicazione TOPdesk - Public. Per altre informazioni sul pannello di accesso, vedere Introduzione al Pannello di accesso.

Risorse aggiuntive