Esercitazione: Configurare il provisioning freshservice per il provisioning utenti automatico

Questa esercitazione descrive i passaggi da eseguire sia in Freshservice Provisioning che in Microsoft Entra ID per configurare il provisioning utenti automatico. Se configurato, Microsoft Entra ID effettua automaticamente il provisioning e il deprovisioning degli utenti in Freshservice Provisioning usando il servizio di provisioning Microsoft Entra. Per informazioni importanti sul funzionamento di questo servizio e sulle domande frequenti, vedere Automatizzare il provisioning e il deprovisioning degli utenti nelle applicazioni SaaS con Microsoft Entra ID.

Capacità supportate

• Creare utenti in Freshservice Provisioning
• Rimuovere gli utenti in Freshservice Provisioning quando non richiedono più l'accesso
• Mantenere sincronizzati gli attributi utente tra Microsoft Entra ID e Freshservice Provisioning

Prerequisiti

Per lo scenario descritto in questa esercitazione si presuppone che l'utente disponga dei prerequisiti seguenti:

• Un tenant di Microsoft Entra
• Uno dei ruoli seguenti: Application Amministrazione istrator, Cloud Application Amministrazione istrator o Application Owner.
• Un account Freshservice con autorizzazioni Amministrazione organizzative.

Passaggio 1: Pianificare la distribuzione del provisioning

1. Vedere le informazioni su come funziona il servizio di provisioning.
2. Determinare gli utenti che verranno inclusi nell'ambito per il provisioning.
3. Determinare quali dati eseguire il mapping tra Microsoft Entra ID e Freshservice Provisioning.

Passaggio 2: Configurare il provisioning freshservice per supportare il provisioning con Microsoft Entra ID

1. Nell'account Freshservice installare l'app Provisioning di Azure (SCIM) dal marketplace passando a Freshservice Amministrazione> Apps>Recupera app.
2. Nella schermata di configurazione specificare il dominio Freshservice ( ad esempio acme.freshservice.com) e la chiave API organization Amministrazione.
3. Fare clic su Continua.
4. Evidenziare e copiare il token di connessione. Questo valore verrà immesso nel campo Token segreto nella scheda Provisioning dell'applicazione Freshservice Provisioning.
5. Fare clic su Installa per completare l'installazione.
6. L'URL del tenant è https://scim.freshservice.com/scim/v2. Questo valore verrà immesso nel campo URL tenant nella scheda Provisioning dell'applicazione Freshservice Provisioning.

Passaggio 3: Aggiungere Freshservice Provisioning dalla raccolta di applicazioni Microsoft Entra

Aggiungere Freshservice Provisioning dalla raccolta di applicazioni Microsoft Entra per iniziare a gestire il provisioning in Freshservice Provisioning. Per altre informazioni su come aggiungere un'applicazione dalla raccolta, fare clic qui.

Passaggio 4: Definire chi sarà nell'ambito del provisioning

Il servizio di provisioning Di Microsoft Entra consente di definire l'ambito di chi verrà effettuato il provisioning in base all'assegnazione all'applicazione e o in base agli attributi dell'utente. Se si sceglie di definire l'ambito degli utenti di cui verrà effettuato il provisioning per l'app in base all'assegnazione, è possibile seguire questa procedura per assegnare utenti all'applicazione. Se si sceglie di definire l'ambito degli utenti di cui verrà effettuato il provisioning esclusivamente in base agli attributi dell'utente, è possibile usare un filtro di ambito come descritto qui.

• Iniziare con pochi elementi. Eseguire il test con un piccolo set di utenti e gruppi prima di eseguire la distribuzione a tutti. Quando l'ambito per il provisioning è impostato su utenti e gruppi assegnati, è possibile controllarlo assegnando uno o due utenti o gruppi all'app. Quando l'ambito è impostato su tutti gli utenti e i gruppi, è possibile specificare un filtro di ambito basato su attributi.

• Iniziare con pochi elementi. Eseguire il test con un piccolo set di utenti prima di procedere alla distribuzione generale. Quando l'ambito per il provisioning è impostato su utenti assegnati, è possibile mantenere il controllo assegnando uno o due utenti all'app. Quando l'ambito è impostato su tutti gli utenti e i gruppi, è possibile specificare un filtro di ambito basato su attributi.

Passaggio 5: Configurare il provisioning utenti automatico in Freshservice Provisioning

Questa sezione illustra i passaggi per configurare il servizio di provisioning Di Microsoft Entra per creare, aggiornare e disabilitare gli utenti in Freshservice Provisioning in base alle assegnazioni utente in Microsoft Entra ID.

Per configurare il provisioning utenti automatico per Freshservice Provisioning in Microsoft Entra ID

1. Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.

2. Passare a Applicazioni di identità>Applicazioni aziendali>

   

3. Nell'elenco delle applicazioni selezionare Freshservice Provisioning.

   

4. Selezionare la scheda Provisioning.

   

5. Impostare Modalità di provisioning su Automatico.

   

6. Nella sezione Amministrazione Credentials (Credenziali) immettere l'URL del tenant di provisioning freshservice e il token segreto. Fare clic su Test Connessione ion per assicurarsi che Microsoft Entra ID possa connettersi al provisioning Freshservice. Se la connessione non riesce, verificare che l'account Freshservice Provisioning disponga delle autorizzazioni Amministrazione e riprovare.

   

7. Nel campo Messaggio di posta elettronica di notifica immettere l'indirizzo di posta elettronica di una persona o un gruppo che riceverà le notifiche di errore relative al provisioning e selezionare la casella di controllo Invia una notifica di posta elettronica in caso di errore.

   

8. Seleziona Salva.

9. Nella sezione Mapping selezionare Synchronize Microsoft Entra users to Freshservice Provisioning (Sincronizza utenti di Microsoft Entra con Freshservice Provisioning).

10. Esaminare gli attributi utente sincronizzati da Microsoft Entra ID a Freshservice Provisioning nella sezione Mapping attributi . Gli attributi selezionati come proprietà corrispondenti vengono usati per trovare le corrispondenze con gli account utente in Freshservice Provisioning per le operazioni di aggiornamento. Se si sceglie di modificare l'attributo di destinazione corrispondente, è necessario assicurarsi che l'API Freshservice Provisioning supporti il filtro degli utenti in base a tale attributo. Selezionare il pulsante Salva per eseguire il commit delle modifiche.

    Attributo	Type	Supportato per il filtro
    userName	String	✓
    active	Booleano
    emails[type eq "work"].value	String
    displayName	String
    name.givenName	String
    name.familyName	String
    phoneNumbers[type eq "work"].value	String
    phoneNumbers[type eq "mobile"].value	String
    addresses[type eq "work"].formatted	String
    locale	String
    title	String
    timezone	String
    externalId	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager	Riferimento
    urn:ietf:params:scim:schemas:extension:freshservice:2.0:User:isAgent	String

Nota

È possibile aggiungere attributi di estensione personalizzati allo schema per soddisfare le esigenze dell'applicazione seguendo questa procedura:

• In Mapping selezionare Provisioning utenti di Microsoft Entra.
• Nella parte inferiore della pagina selezionare Mostra opzioni avanzate.
• Selezionare Modifica elenco attributi per Freshservice.
• Nella parte inferiore dell'elenco di attributi immettere le informazioni sull'attributo personalizzato nei campi disponibili. Lo spazio dei nomi urn dell'attributo personalizzato deve seguire il modello, come illustrato nell'esempio seguente. CustomAttribute può essere personalizzato in base ai requisiti dell'applicazione, ad esempio urn:ietf:params:scim:schemas:extension:freshservice:2.0:User:isAgent.
• È necessario selezionare il tipo di dati appropriato per l'attributo personalizzato e fare clic su Salva.
• Tornare alla schermata dei mapping predefiniti e fare clic su Aggiungi nuovo mapping. Gli attributi personalizzati verranno visualizzati nell'elenco a discesa Attributo di destinazione.

10. Per configurare i filtri di ambito, fare riferimento alle istruzioni fornite nell'esercitazione sui filtri per la definizione dell'ambito.

11. Per abilitare il servizio di provisioning Microsoft Entra per Freshservice Provisioning, impostare Stato del provisioning su Sì nella sezione Impostazioni.

    

12. Definire gli utenti di cui si vuole eseguire il provisioning in Freshservice Provisioning scegliendo i valori desiderati in Ambito nella sezione Impostazioni.

    

13. Quando si è pronti per eseguire il provisioning, fare clic su Salva.

    

L'operazione avvia il ciclo di sincronizzazione iniziale di tutti gli utenti definiti in Ambito nella sezione Impostazioni. Il ciclo iniziale richiede più tempo rispetto ai cicli successivi, che si verificano approssimativamente ogni 40 minuti, purché il servizio di provisioning di Microsoft Entra sia in esecuzione.

Passaggio 6: Monitorare la distribuzione

Dopo aver configurato il provisioning, usare le risorse seguenti per monitorare la distribuzione:

1. Usare i log di provisioning per determinare gli utenti di cui è stato eseguito il provisioning con esito positivo o negativo.
2. Controllare l'indicatore di stato per visualizzare lo stato del ciclo di provisioning e quanto manca al completamento.
3. Se la configurazione del provisioning sembra essere in uno stato non integro, l'applicazione entrerà in quarantena. Per altre informazioni sugli stati di quarantena, fare clic qui.

Risorse aggiuntive

• Gestione del provisioning degli account utente per app aziendali
• Che cos'è l'accesso alle applicazioni e l'accesso Single Sign-On con Microsoft Entra ID?

Passaggi successivi

• Informazioni su come esaminare i log e ottenere report sulle attività di provisioning