Esercitazione: Integrazione dell'accesso Single Sign-On (SSO) di Azure Active Directory con FreshserviceTutorial: Azure Active Directory single sign-on (SSO) integration with Freshservice

Questa esercitazione descrive come integrare Freshservice con Azure Active Directory (Azure AD).In this tutorial, you'll learn how to integrate Freshservice with Azure Active Directory (Azure AD). Integrando Freshservice con Azure AD, è possibile:When you integrate Freshservice with Azure AD, you can:

  • Controllare in Azure AD chi può accedere a Freshservice.Control in Azure AD who has access to Freshservice.
  • Abilitare gli utenti per l'accesso automatico a Freshservice con gli account Azure AD personali.Enable your users to be automatically signed-in to Freshservice with their Azure AD accounts.
  • Gestire gli account in un'unica posizione centrale: il portale di Azure.Manage your accounts in one central location - the Azure portal.

Per altre informazioni sull'integrazione di app SaaS con Azure AD, vedere Accesso Single Sign-On alle applicazioni in Azure Active Directory.To learn more about SaaS app integration with Azure AD, see What is application access and single sign-on with Azure Active Directory.

PrerequisitiPrerequisites

Per iniziare, sono necessari gli elementi seguenti:To get started, you need the following items:

  • Una sottoscrizione di Azure AD.An Azure AD subscription. Se non si ha una sottoscrizione, è possibile ottenere un account gratuito.If you don't have a subscription, you can get a free account.
  • Sottoscrizione di Freshservice abilitata per l'accesso Single Sign-On (SSO).Freshservice single sign-on (SSO) enabled subscription.

Descrizione dello scenarioScenario description

In questa esercitazione vengono eseguiti la configurazione e il test dell'accesso Single Sign-On di Azure AD in un ambiente di test.In this tutorial, you configure and test Azure AD SSO in a test environment.

  • Freshservice supporta l'accesso SSO avviato da SPFreshservice supports SP initiated SSO

Per configurare l'integrazione di Freshservice in Azure AD è necessario aggiungere Freshservice dalla raccolta al proprio elenco di app SaaS gestite.To configure the integration of Freshservice into Azure AD, you need to add Freshservice from the gallery to your list of managed SaaS apps.

  1. Accedere al portale di Azure con un account aziendale o dell'istituto di istruzione oppure con un account Microsoft personale.Sign in to the Azure portal using either a work or school account, or a personal Microsoft account.
  2. Nel riquadro di spostamento a sinistra selezionare il servizio Azure Active Directory.On the left navigation pane, select the Azure Active Directory service.
  3. Passare ad Applicazioni aziendali e quindi selezionare Tutte le applicazioni.Navigate to Enterprise Applications and then select All Applications.
  4. Per aggiungere una nuova applicazione, selezionare Nuova applicazione.To add new application, select New application.
  5. Nella sezione Aggiungi dalla raccolta digitare Freshservice nella casella di ricerca.In the Add from the gallery section, type Freshservice in the search box.
  6. Selezionare Freshservice nel riquadro dei risultati e quindi aggiungere l'app.Select Freshservice from results panel and then add the app. Attendere alcuni secondi che l'app venga aggiunta al tenant.Wait a few seconds while the app is added to your tenant.

Configurare e testare l'accesso Single Sign-On di Azure AD per FreshserviceConfigure and test Azure AD single sign-on for Freshservice

Configurare e testare l'accesso Single Sign-On di Azure AD con Freshservice usando un utente di test di nome B.Simon.Configure and test Azure AD SSO with Freshservice using a test user called B.Simon. Per consentire il funzionamento dell'accesso Single Sign-On, è necessario stabilire una relazione di collegamento tra un utente di Azure AD e l'utente correlato in Freshservice.For SSO to work, you need to establish a link relationship between an Azure AD user and the related user in Freshservice.

Per configurare e testare l'accesso SSO di Azure AD con Freshservice, completare le procedure di base seguenti:To configure and test Azure AD SSO with Freshservice, complete the following building blocks:

  1. Configurare l'accesso Single Sign-On di Azure AD : per consentire agli utenti di usare questa funzionalità.Configure Azure AD SSO - to enable your users to use this feature.
    1. Creare un utente di test di Azure AD : per testare l'accesso Single Sign-On di Azure AD con l'utente B. Simon.Create an Azure AD test user - to test Azure AD single sign-on with B.Simon.
    2. Assegnare l'utente di test di Azure AD : per abilitare B. Simon all'uso dell'accesso Single Sign-On di Azure AD.Assign the Azure AD test user - to enable B.Simon to use Azure AD single sign-on.
  2. Configurare l'accesso Single Sign-On di Freshservice : per configurare le impostazioni di Single Sign-On sul lato applicazione.Configure Freshservice SSO - to configure the single sign-on settings on application side.
    1. Creare l'utente di test di Freshservice : per avere una controparte di B.Simon in Freshservice collegata alla rappresentazione dell'utente in Azure AD.Create Freshservice test user - to have a counterpart of B.Simon in Freshservice that is linked to the Azure AD representation of user.
  3. Testare l'accesso Single Sign-On : per verificare se la configurazione funziona.Test SSO - to verify whether the configuration works.

Configurare l'accesso SSO di Azure ADConfigure Azure AD SSO

Per abilitare l'accesso Single Sign-On di Azure AD nel portale di Azure, seguire questa procedura.Follow these steps to enable Azure AD SSO in the Azure portal.

  1. Nella pagina di integrazione dell'applicazione Freshservice del portale di Azure individuare la sezione Gestione e selezionare Single Sign-On.In the Azure portal, on the Freshservice application integration page, find the Manage section and select single sign-on.

  2. Nella pagina Selezionare un metodo di accesso Single Sign-On selezionare SAML.On the Select a single sign-on method page, select SAML.

  3. 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.On the Set up single sign-on with SAML page, click the edit/pen icon for Basic SAML Configuration to edit the settings.

    Modificare la configurazione SAML di base

  4. Nella sezione Configurazione SAML di base immettere i valori per i campi seguenti:On the Basic SAML Configuration section, enter the values for the following fields:

    a.a. Nella casella di testo URL di accesso digitare un URL nel formato seguente: https://<democompany>.freshservice.comIn the Sign on URL text box, type a URL using the following pattern: https://<democompany>.freshservice.com

    b.b. Nella casella di testo Identificatore (ID entità) digitare un URL nel formato seguente: https://<democompany>.freshservice.comIn the Identifier (Entity ID) text box, type a URL using the following pattern: https://<democompany>.freshservice.com

    Nota

    Poiché questi non sono i valori reali,These values are not real. è necessario aggiornarli con l'ID e l'URL di accesso effettivi.Update these values with the actual Sign on URL and Identifier. Per ottenere questi valori contattare il team di supporto clienti di Freshservice.Contact Freshservice Client support team to get these values. È anche possibile fare riferimento ai modelli mostrati nella sezione Configurazione SAML di base del portale di Azure.You can also refer to the patterns shown in the Basic SAML Configuration section in the Azure portal.

  5. Nella sezione Certificato di firma SAML della pagina Configura l'accesso Single Sign-On con SAML, trovare Certificato (Base64) e selezionare Scarica per scaricare il certificato e salvarlo nel computer in uso.On the Set up Single Sign-On with SAML page, in the SAML Signing Certificate section, find Certificate (Base64) and select Download to download the certificate and save it on your computer.

    Collegamento di download del certificato

  6. Per il corretto funzionamento dell'accesso SSO, Freshservice richiede l'impronta digitale SHA-256.Freshservice requires SHA-256 fingerprint to get SSO working. Per ottenere l'impronta digitale SHA-256, seguire questa procedura:To get SHA-256 fingerprint, perform the following steps :

    Impronta digitaleFingerPrint

    1. Aprire il collegamento in un altro Web browser.Open the link in different web browser.

    2. Aprire il certificato scaricato (Base64) nel Blocco note e incollarne il contenuto nella casella di testo X.509 cert (Certificato X.509).Open downloaded certificate (Base64) file in the Notepad and paste content in the X.509 cert textbox.

    3. Per l'algoritmo selezionare sha256 nell'elenco a discesa.For the Algorithm, select sha256 from the dropdown.

    4. Fare clic su CALCULATE FINGERPRINT (CALCOLA IMPRONTA DIGITALE).Click CALCULATE FINGERPRINT.

    5. Fare clic sull'icona di copia per copiare il valore generato di FingerPrint (Impronta digitale) e salvarlo nel computer.Click on the copy icon to copy the generated FingerPrint and save it on your computer.

  7. Nella sezione Configura Freshservice del portale di Azure copiare gli URL appropriati in base alle esigenze.On the Set up Freshservice section on the Azure portal, copy the appropriate URL(s) based on your requirement.

    Copiare gli URL di configurazione

Creare un utente di test di Azure ADCreate an Azure AD test user

In questa sezione verrà creato un utente di test di nome B.Simon nel portale di Azure.In this section, you'll create a test user in the Azure portal called B.Simon.

  1. Nel riquadro sinistro del portale di Azure selezionare Azure Active Directory, Utenti e quindi Tutti gli utenti.From the left pane in the Azure portal, select Azure Active Directory, select Users, and then select All users.
  2. Selezionare Nuovo utente in alto nella schermata.Select New user at the top of the screen.
  3. In Proprietà utente seguire questa procedura:In the User properties, follow these steps:
    1. Nel campo Nome immettere B.Simon.In the Name field, enter B.Simon.
    2. Nel campo Nome utente immettere username@companydomain.extension.In the User name field, enter the username@companydomain.extension. Ad esempio: B.Simon@contoso.com.For example, B.Simon@contoso.com.
    3. Selezionare la casella di controllo Mostra password e quindi prendere nota del valore visualizzato nella casella Password.Select the Show password check box, and then write down the value that's displayed in the Password box.
    4. Fare clic su Crea.Click Create.

Assegnare l'utente test di Azure ADAssign the Azure AD test user

In questa sezione si abiliterà B.Simon all'uso dell'accesso Single Sign-On di Azure concedendole l'accesso a Freshservice.In this section, you'll enable B.Simon to use Azure single sign-on by granting access to Freshservice.

  1. Nel portale di Azure selezionare Applicazioni aziendali e quindi Tutte le applicazioni.In the Azure portal, select Enterprise Applications, and then select All applications.

  2. Nell'elenco delle applicazioni selezionare Freshservice.In the applications list, select Freshservice.

  3. Nella pagina di panoramica dell'app trovare la sezione Gestione e selezionare Utenti e gruppi.In the app's overview page, find the Manage section and select Users and groups.

    Collegamento "Utenti e gruppi"

  4. Selezionare Aggiungi utente e quindi Utenti e gruppi nella finestra di dialogo Aggiungi assegnazione.Select Add user, then select Users and groups in the Add Assignment dialog.

    Collegamento Aggiungi utente

  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.In the Users and groups dialog, select B.Simon from the Users list, then click the Select button at the bottom of the screen.

  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.If you're expecting any role value in the SAML assertion, in the Select Role dialog, select the appropriate role for the user from the list and then click the Select button at the bottom of the screen.

  7. Nella finestra di dialogo Aggiungi assegnazione fare clic sul pulsante Assegna.In the Add Assignment dialog, click the Assign button.

Configurare l'accesso Single Sign-On per FreshserviceConfigure Freshservice SSO

  1. Per automatizzare la configurazione all'interno di Freshservice, è necessario installare l'estensione del browser per l'accesso sicuro alle app personali facendo clic su Installa estensione.To automate the configuration within Freshservice, you need to install My Apps Secure Sign-in browser extension by clicking Install the extension.

    Estensione per App personali

  2. Dopo aver aggiunto l'estensione al browser, fare clic su Setup Freshservice (Configura Freshservice) per passare direttamente all'applicazione Freshservice.After adding extension to the browser, click on Setup Freshservice will direct you to the Freshservice application. Da qui, fornire le credenziali di amministratore per accedere a Freshservice.From there, provide the admin credentials to sign into Freshservice. L'estensione del browser configurerà automaticamente l'applicazione e automatizzerà i passaggi da 3 a 6.The browser extension will automatically configure the application for you and automate steps 3-6.

    Eseguire la configurazione

  3. Se si vuole configurare manualmente Freshservice, aprire una nuova finestra del Web browser, accedere al sito aziendale di Freshservice come amministratore e seguire questa procedura:If you want to setup Freshservice manually, open a new web browser window and sign into your Freshservice company site as an administrator and perform the following steps:

  4. Nel menu in alto fare clic su Admin.In the menu on the top, click Admin.

    AdminAdmin

  5. Nel portale dei clienti fare clic su Security (Sicurezza).In the Customer Portal, click Security.

    SicurezzaSecurity

  6. Nella sezione Security seguire questa procedura:In the Security section, perform the following steps:

    Single Sign-OnSingle Sign On

    a.a. Passare a Single Sign-On.Switch Single Sign On.

    b.b. Selezionare SAML SSO.Select SAML SSO.

    c.c. Nella casella di testo SAML Login URL (URL di accesso SAML) incollare il valore di URL di accesso copiato dal portale di Azure.In the SAML Login URL textbox, paste the value of Login URL, which you have copied from Azure portal.

    d.d. Nella casella di testo Logout URL (URL disconnessione) incollare il valore dell'URL di disconnessione copiato dal portale di Azure.In the Logout URL textbox, paste the value of Logout URL, which you have copied from Azure portal.

    e.e. Nella casella di testo Security Certificate Fingerprint (Impronta digitale certificato di protezione) incollare il valore di FingerPrint (Impronta digitale) generato in precedenza.In Security Certificate Fingerprint textbox, paste the FingerPrint value, which you have generated earlier.

    f.f. Fare clic su Save (Salva).Click Save

Creare un utente test di FreshserviceCreate Freshservice test user

Per consentire agli utenti di Azure AD di accedere a Freshservice, è necessario eseguire il provisioning degli utenti in Freshservice.To enable Azure AD users to sign in to FreshService, they must be provisioned into FreshService. Nel caso di FreshService, il provisioning è un'attività manuale.In the case of FreshService, provisioning is a manual task.

Per eseguire il provisioning di un account utente, seguire questa procedura:To provision a user account, perform the following steps:

  1. Accedere al sito aziendale di FreshService come amministratore.Sign in to your FreshService company site as an administrator.

  2. Nel menu in alto fare clic su Admin.In the menu on the top, click Admin.

    AdminAdmin

  3. Nella sezione User Management (Gestione utenti) fare clic su Requesters (Richiedenti).In the User Management section, click Requesters.

    RequestersRequesters

  4. Fare clic su Nuovo Requester.Click New Requester.

    New RequestersNew Requesters

  5. Nella sezione New Requester seguire questa procedura:In the New Requester section, perform the following steps:

    New RequesterNew Requester

    a.a. Nelle caselle First Name e Email immettere il nome e l'indirizzo di posta elettronica di un account Azure Active Directory valido di cui si vuole eseguire il provisioning.Enter the First Name and Email attributes of a valid Azure Active Directory account you want to provision into the related textboxes.

    b.b. Fare clic su Save.Click Save.

    Nota

    Il titolare dell'account Azure Active Directory riceve un messaggio di posta elettronica con un collegamento da selezionare per confermare l'account e attivarlo.The Azure Active Directory account holder gets an email including a link to confirm the account before it becomes active

Nota

È possibile usare qualsiasi altro strumento o API di creazione di account utente fornito da FreshService per effettuare il provisioning degli account utente Azure AD.You can use any other FreshService user account creation tools or APIs provided by FreshService to provision Azure AD user accounts.

Testare l'accesso SSOTest SSO

In questa sezione viene testata la configurazione dell'accesso Single Sign-On di Azure AD usando il pannello di accesso.In this section, you test your Azure AD single sign-on configuration using the Access Panel.

Quando si fa clic sul riquadro di Freshservice nel pannello di accesso, si dovrebbe accedere automaticamente all'applicazione Freshservice per cui si è configurato l'accesso SSO.When you click the Freshservice tile in the Access Panel, you should be automatically signed in to the Freshservice for which you set up SSO. Per altre informazioni sul pannello di accesso, vedere Introduzione al Pannello di accesso.For more information about the Access Panel, see Introduction to the Access Panel.

Risorse aggiuntiveAdditional resources