Esercitazione: Configurare Zendesk per il provisioning utenti automatico

Articolo
10/02/2024

Questa esercitazione descrive i passaggi da eseguire sia in Zendesk che in Microsoft Entra ID per configurare il provisioning utenti automatico. Se configurato, Microsoft Entra ID effettua automaticamente il provisioning e il deprovisioning di utenti e gruppi in Zendesk usando 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 Zendesk.
Rimuovere utenti da Zendesk quando non richiedono più l'accesso
Mantenere sincronizzati gli attributi utente tra Microsoft Entra ID e Zendesk.
Effettuare il provisioning di gruppi e appartenenze a gruppi in Zendesk
Accesso Single Sign-On a Zendesk (scelta consigliata)

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 ruoli: Amministratore di applicazioni, Amministratore di applicazione cloud o Proprietario dell'applicazione.
Un account utente in Zendesk con diritti di amministratore.
Tenant di Zendesk con il piano Professional, o superiore, abilitato.

Passaggio 1: pianificare la distribuzione del provisioning

Vedere le informazioni su come funziona il servizio di provisioning.
Determinare gli utenti che verranno inclusi nell'ambito per il provisioning.
Determinare per quali dati eseguire il mapping tra Microsoft Entra ID ed Zendesk.

Passaggio 2: configurare Zendesk per supportare il provisioning con Microsoft Entra ID

Accedere all'Interfaccia di amministrazione di Zendesk.
Passare ad >API di App and integrazioni>API di Zendesk.
Cliccare sulla scheda Impostazioni e verificare che l'Accesso ai token sia abilitato.
Cliccare sul pulsante Aggiungi token API a destra di Token API attivi. Il token viene generato e visualizzato.
Immettere una descrizione del token API.
Copiare il token e incollarlo in un posto sicuro. Dopo aver chiuso questa finestra, il token completo non verrà mai più visualizzato.
Per tornare alla pagina delle API, cliccare su Salva. Se si fa clic sul token per riaprirlo, viene visualizzata una versione troncata del token.

Passaggio 3: aggiungere Zendesk dalla raccolta di applicazioni Microsoft Entra

Aggiungere Zendesk dalla raccolta di applicazioni Microsoft Entra per iniziare a gestire il provisioning in Zendesk. Se Zendesk è stato configurato in precedenza per l'accesso SSO, è possibile usare la stessa applicazione. Tuttavia, si consiglia di creare un'app separata per il test iniziale dell'integrazione. 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 per gli utenti di cui verrà eseguito il provisioning in base all'assegnazione all'applicazione e/o in base agli attributi dell'utente o del gruppo. Se si sceglie di definire l'ambito degli utenti di cui verrà eseguito il provisioning per l'app in base all'assegnazione, è possibile seguire questa procedura per assegnare utenti e gruppi all'applicazione. Se si sceglie di definire l'ambito degli utenti di cui verrà eseguito il provisioning esclusivamente in base agli attributi dell'utente o del gruppo, è 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.
Se sono necessari altri ruoli è possibile aggiornare il manifesto dell'applicazione per aggiungere nuovi ruoli.

Passaggio 5: configurare il provisioning utenti automatico per Zendesk

Questa sezione descrive la procedura per configurare il servizio di provisioning di Microsoft Entra per creare, aggiornare e disabilitare utenti e/o gruppi in Zendesk in base alle assegnazioni di utenti e/o gruppi in Microsoft Entra ID.

Suggerimenti importanti per l'assegnazione di utenti a Zendesk

Oggi, i ruoli di Zendesk vengono popolati in modo automatico e dinamico nell'interfaccia utente del portale di Azure. Prima di assegnare i ruoli Zendesk agli utenti, assicurarsi di completare una sincronizzazione iniziale con Zendesk per recuperare gli ultimi ruoli nel tenant Zendesk.
È consigliabile assegnare un singolo utente di Microsoft Entra a Zendesk per testare la configurazione iniziale del provisioning utenti automatico. Sarà possibile assegnare altri utenti o gruppi se i test hanno esito positivo.
Quando si assegna un utente a Zendesk, selezionare qualsiasi ruolo valido specifico dell'applicazione, se disponibile, nella finestra di dialogo di assegnazione. Gli utenti con il ruolo Accesso predefinito vengono esclusi dal provisioning.

Configurare il provisioning utenti automatico per Zendesk in Microsoft Entra ID

Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.
Passare a Identità>Applicazioni>Applicazioni enterprise
Nell'elenco di applicazioni selezionare Zendesk.
Selezionare la scheda Provisioning.
Impostare Modalità di provisioning su Automatico.
Nella sezione Credenziali amministratore immettere il nome utente amministratore, il token segreto e il dominio dell'account Zendesk. Ecco alcuni esempi di questi valori:
- Nel campo Nome utente amministratore immettere il nome utente dell'account amministratore nel tenant di Zendesk. Un esempio è admin@contoso.com.
- Nel campo Token segreto immettere il token del segreto come descritto nel passaggio 6.
- Nel campo Dominio immettere il sottodominio del tenant di Zendesk. Ad esempio, per un account con un URL del tenant https://my-tenant.zendesk.com, il sottodominio è my-tenant.
Il token segreto per l'account Zendesk può essere generato seguendo i passaggi indicati nel Passaggio 2 precedente.
Dopo aver compilato le caselle mostrate nel passaggio 5, selezionare Test di connessione per verificare che Microsoft Entra ID possa connettersi a Zendesk. Se la connessione non riesce, verificare che l'account Zendesk abbia le autorizzazioni da amministratore e riprovare.
Nel campo Messaggio di posta elettronica di notifica immettere l'indirizzo e-mail di una persona o di un gruppo che riceverà le notifiche di errore relative al provisioning. Selezionare la casella di controllo Invia una notifica di posta elettronica in caso di errore.
Selezionare Salva.
Nella sezione Mapping, selezionare Sincronizza utenti Microsoft Entra in Zendesk.
Esaminare gli attributi utente sincronizzati da Microsoft Entra ID a Zendesk nella sezione Mapping attributi. Gli attributi selezionati come proprietà corrispondenti vengono usati per trovare le corrispondenze con gli account utente in Zendesk per le operazioni di aggiornamento. Per salvare le modifiche, selezionare Salva.
Nella sezione Mapping selezionare Sincronizza gruppi di Microsoft Entra in Zendesk.
Esaminare gli attributi del gruppo sincronizzati da Microsoft Entra ID a Zendesk nella sezione Mapping attributi. Gli attributi selezionati come Proprietà corrispondenti vengono usati per trovare le corrispondenze con i gruppi in Zendesk per le operazioni di aggiornamento. Per salvare le modifiche, selezionare Salva.
Per configurare i filtri di ambito, seguire le istruzioni riportate nell'esercitazione sui filtri per la definizione dell'ambito.
Per abilitare il servizio di provisioning di Microsoft Entra per Zendesk, modificare lo Stato del provisioning su Attivo nella sezione Impostazioni.
Definire gli utenti o i gruppi di cui si vuole eseguire il provisioning in Zendesk. Nella sezione Impostazioni selezionare i valori desiderati in Ambito.
Quando si è pronti per eseguire il provisioning, selezionare Salva.

L'operazione avvia la sincronizzazione iniziale di tutti gli utenti o i gruppi definiti nell'Ambito della sezione Impostazioni. La sincronizzazione iniziale richiede più tempo rispetto alle sincronizzazioni successive. Le sincronizzazioni vengono eseguite circa ogni 40 minuti, purché il servizio di provisioning di Microsoft Entra sia in esecuzione.

È possibile usare la sezione Dettagli sincronizzazione per monitorare lo stato di avanzamento e selezionare i collegamenti al report attività di provisioning. Il report descrive tutte le azioni eseguite dal servizio di provisioning di Microsoft Entra in Zendesk.

Per scoprire di più sulla lettura dei log di provisioning di Microsoft Entra, vedere Creazione di report sul provisioning automatico degli account utente.

Limitazioni dei connettori

Zendesk supporta l'uso dei gruppi solo per gli utenti con il ruolo di Agente. Per altre informazioni, vedere la documentazione di Zendesk.
Quando un ruolo personalizzato viene assegnato a un utente o gruppo, il servizio di provisioning utenti automatico di Microsoft Entra assegna il ruolo predefinito da Agente. È possibile assegnare un ruolo predefinito solo agli Agenti. Per altre informazioni, vedere la documentazione API di Zendesk.
L'importazione di tutti i ruoli ha esito negativo se uno qualunque dei ruoli personalizzati ha un nome visualizzato simile ai ruoli predefiniti di "agente" o "utente finale". Per evitare questo problema, assicurarsi che nessuno dei ruoli personalizzati da importare abbia i nomi visualizzati elencati in precedenza.

Altre risorse

Passaggi successivi

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

Condividi tramite