Condividi tramite


Configurare il provisioning di Freshservice per il provisioning automatico degli utenti

Questo articolo descrive i passaggi da eseguire sia nel provisioning di Freshservice che in Microsoft Entra ID per configurare il provisioning automatico degli utenti. Quando configurato, Microsoft Entra ID effettua automaticamente il provisioning e il deprovisioning degli utenti per Freshservice Provisioning tramite il servizio di provisioning di Microsoft Entra. Per informazioni dettagliate sulle caratteristiche e sul funzionamento di questo servizio e per le domande frequenti, consultare la sezione 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

Lo scenario descritto in questo articolo presuppone che siano già disponibili i prerequisiti seguenti:

  • Un account Freshservice con le autorizzazioni di amministratore dell'organizzazione.

Passaggio 1: Pianificare la distribuzione dell'approvvigionamento

  1. Scopri come funziona il servizio di provisioning.
  2. Determinare chi sarà incluso nell'ambito di per la fornitura di.
  3. Determinare quali dati eseguire il mapping tra Microsoft Entra ID e Freshservice Provisioning.

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

  1. Nell'account Freshservice, installa l'app Azure Provisioning (SCIM) dal marketplace passando a Freshservice Admin>Apps>Ottieni app.
  2. Nella schermata di configurazione specificare di dominio Freshservice (ad esempio, acme.freshservice.com) e la chiave API amministratore dell'organizzazione .
  3. Fare clic su Continua.
  4. Evidenziare e copiare il bearer Token. 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 sulla scheda di provisioning dell'applicazione Freshservice Provisioning.

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

Passaggio 4: Definire chi è incluso nel processo di provisioning

Il servizio di provisioning di Microsoft Entra consente di delimitare chi viene fornito in base all'assegnazione all'applicazione o in base agli attributi degli utenti o dei gruppi. Se si sceglie di definire l'ambito dell'app in base all'assegnazione, è possibile utilizzare i passaggi per assegnare utenti e gruppi all'applicazione. Se si sceglie di definire l'ambito per cui viene effettuato il provisioning esclusivamente in base agli attributi dell'utente o del gruppo, è possibile usare un filtro di ambito.

  • Iniziare con pochi elementi. Eseguire il test con un piccolo insieme di utenti e gruppi prima di distribuirlo 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 attributo .

  • Se sono necessari ruoli aggiuntivi, è possibile aggiornare il manifesto dell'applicazione per aggiungere nuovi ruoli.

Passaggio 5: Configurare il provisioning automatico degli utenti in Freshservice.

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

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

  1. Accedi al Microsoft Entra admin center come almeno un amministratore di applicazioni cloud.

  2. Passare a Identità>Applicazioni>Applicazioni aziendali

    Pannello delle applicazioni aziendali

  3. Nell'elenco delle applicazioni selezionare Freshservice Provisioning.

    Il collegamento di Provisioning di Freshservice nell'elenco delle applicazioni

  4. Selezionare la scheda Provisioning.

    scheda Configurazione

  5. Impostare Modalità di provisionamento su Automatico.

    scheda di provisioning automatica

  6. Nella sezione credenziali amministratore, immettere l'URL del Tenant di Provisioning Freshservice e il Token Segreto. Fare clic su Test Connessione per assicurarsi che Microsoft Entra ID possa connettersi a Freshservice Provisioning. Se la connessione non riesce, verificare che l'account Freshservice Provisioning disponga delle autorizzazioni di amministratore e riprovare.

    Token

  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.

    Messaggio e-mail di notifica

  8. Seleziona Salva.

  9. Nella sezione mapping selezionare Sincronizzare gli utenti di Microsoft Entra con Freshservice Provisioning.

  10. Esamina gli attributi dell'utente che vengono sincronizzati da Microsoft Entra ID a Freshservice Provisioning nella sezione Mappatura degli attributi. Gli attributi selezionati come proprietà di corrispondenza vengono utilizzati per allineare gli account utente in Freshservice Provisioning nelle operazioni di aggiornamento. Se si sceglie di modificare l'attributo di destinazione corrispondente , sarà necessario assicurarsi che l'API Freshservice Provisioning supporti il filtro degli utenti in base a tale attributo. Selezionare il pulsante Salva per confermare le modifiche.

    Attributo TIPO Supportato per il filtraggio
    nome utente Stringa
    attivo Booleano
    email[type eq "work"].valore Stringa
    nome visualizzato Stringa
    nome.nomeDato Stringa
    nome.cognome Stringa
    phoneNumbers[type eq "lavoro"].value Stringa
    numeriDiTelefono[tipo eq "mobile"].valore Stringa
    indirizzi[tipo eq "lavoro"].formattato Stringa
    locale Stringa
    titolo Stringa
    fuso orario Stringa
    Id esterno Stringa
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:dipartimento Stringa
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager Riferimento
    urn:ietf:params:scim:schemas:extension:freshservice:2.0:User:isAgent Stringa

Nota

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

  • In Mapping selezionare Effettuare il provisioning degli 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. Il 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 dell'attributo di destinazione.
  1. Per configurare i filtri di ambito, vedere le istruzioni seguenti fornite nell'articolo Filtro di ambito.

  2. Per abilitare il servizio di provisioning Microsoft Entra per Freshservice Provisioning, modificare lo stato del provisioning da Disattivato a Attivato nella sezione Impostazioni .

    Stato di configurazione modificato su

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

    Ambito di Fornitura

  4. Quando si è pronti per configurare, fare clic su Salva.

    Salvataggio della configurazione del provisioning

Questa 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 correttamente o in modo non riuscito
  2. Controlla la barra di progresso per visualizzare lo stato del ciclo di provisioning e quanto manca al completamento.
  3. Se la configurazione del provisioning sembra essere in uno stato problematico, l'applicazione va in quarantena. Per saperne di più sugli stati di quarantena, consulta l'articolo relativo al provisioning delle applicazioni con stato di quarantena.

Risorse aggiuntive