Esercitazione: Integrare Freshservice con Azure Active DirectoryTutorial: Integrate Freshservice with Azure Active Directory

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 una versione di valutazione gratuita per un mese qui.If you don't have a subscription, you can get one-month free trial here.
  • 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 ADConfigure and test Azure AD single sign-on

Configurare e testare l'accesso Single Sign-On di Azure AD con Freshservice usando un utente di test di nome Britta Simon.Configure and test Azure AD SSO with Freshservice using a test user called Britta 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.
  2. Configurare l'accesso Single Sign-On per 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.
  3. Creare un utente di test di Azure AD : per testare l'accesso Single Sign-On di Azure AD con l'utente Britta Simon.Create an Azure AD test user - to test Azure AD single sign-on with Britta Simon.
  4. Assegnare l'utente test di Azure AD : per abilitare Britta Simon all'uso dell'accesso Single Sign-On di Azure AD.Assign the Azure AD test user - to enable Britta Simon to use Azure AD single sign-on.
  5. Creare un utente test di Freshservice : per avere una controparte di Britta Simon in Freshservice collegata alla rappresentazione dell'utente in Azure AD.Create Freshservice test user - to have a counterpart of Britta Simon in Freshservice that is linked to the Azure AD representation of user.
  6. 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 trovare 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 pagina Configurazione SAML di base immettere i valori per i campi seguenti:On the Basic SAML Configuration page, 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 usando il modello 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 fare clic sul pulsante Modifica per aprire la finestra di dialogo Certificato di firma SAML .In the SAML Signing Certificate section, click Edit button to open SAML Signing Certificate dialog.

    Modificare il certificato di firma SAML

  6. Nella sezione Certificato di firma SAML copiare il valore Identificazione personale e salvarlo nel computer.In the SAML Signing Certificate section, copy the Thumbprint and save it on your computer.

    Copiare il valore di Identificazione personale

  7. Nella sezione Configura Freshservice copiare gli URL appropriati in base alle proprie esigenze.On the Set up Freshservice section, copy the appropriate URL(s) as per your requirement.

    Copiare gli URL di configurazione

    a.a. URL di accessoLogin URL

    b.b. Identificatore di Azure ADAzure AD Identifier

    c.c. URL di chiusura sessioneLogout URL

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 My Apps

  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.

    AmministratoreAdmin

  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 IDENTIFICAZIONE PERSONALE del certificato copiato dal portale di Azure.In Security Certificate Fingerprint textbox, paste the THUMBPRINT value of certificate, which you have copied from Azure portal.

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

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

In questa sezione verrà creato un utente di test di nome Britta Simon nel portale di Azure.In this section, you'll create a test user in the Azure portal called Britta 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 Britta Simon.In the Name field, enter Britta Simon.
    2. Nel campo Nome utente immettere username@companydomain.extension.In the User name field, enter the username@companydomain.extension. Ad esempio: BrittaSimon@contoso.com.For example, BrittaSimon@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 Create(Crea).Click Create.

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

In questa sezione Britta Simon verrà abilitata per l'uso dell'accesso Single Sign-On di Azure concedendo l'accesso a Freshservice.In this section, you'll enable Britta 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 Britta Simon nell'elenco Utenti e quindi fare clic sul pulsante Seleziona nella parte inferiore della schermata.In the Users and groups dialog, select Britta 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.

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.

    AmministratoreAdmin

  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 fornita da FreshService per eseguire il provisioning degli account utente di AAD.You can use any other FreshService user account creation tools or APIs provided by FreshService to provision AAD user accounts.

Testare l'accesso SSOTest SSO

Quando si seleziona il riquadro di Freshservice nel pannello di accesso, si dovrebbe accedere automaticamente all'applicazione Freshservice per cui si è configurato l'accesso SSO.When you select 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