Condividi tramite

Esercitazione: Configurare Zenya per il provisioning utenti automatico

  • Articolo

Questa esercitazione descrive la procedura da eseguire in Zenya e Microsoft Entra ID per configurare Microsoft Entra ID in modo da effettuare automaticamente il provisioning e il deprovisioning di utenti e/o gruppi in Zenya. 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. Prima di tentare di seguire questa esercitazione, accertati di conoscere e di rispettare tutti i requisiti. In caso di domande, contatta Infoland.

Capacità supportate

  • Creare utenti in Zenya
  • Rimuovere/disabilitare utenti da Zenya quando non richiedono più l'accesso
  • Mantenere sincronizzati gli attributi utente tra Microsoft Entra ID e Zenya
  • Effettuare il provisioning di gruppi e appartenenze a gruppi in Zenya
  • AccessoSingle Sign-On a Zenya (scelta consigliata)

Prerequisiti

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

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 per quali dati eseguire il mapping tra Microsoft Entra ID e Zenya.

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

  1. Accedere alla Console di amministrazione di Zenya. Spostarsi su Vai a > Gestione applicazioni.

    Screenshot che mostra la Console di amministrazione si Zenya.

  2. Selezionare Gestione degli utenti esterni.

    Screenshot che mostra la pagina Utenti e gruppi Zenya con il collegamento Gestione utenti esterni evidenziato.

  3. Per aggiungere un nuovo operatore, cliccare sull'icona più. Nella nuova finestra di dialogo Aggiungi operatore specificare un Titolo. È possibile aggiungere una restrizione dell'accesso basata su IP. Selezionare OK.

    Screenshot che mostra un nuovo pulsante di aggiunta di Zenya.

    Screenshot che mostra la pagina di aggiunta operatore di Zenya.

  4. Selezionare il pulsante Token permanente. Copiare il Token permanente e salvarlo. Non sarà possibile visualizzarlo in un secondo momento. Questo valore verrà immesso nel campo Token segreto nella scheda Provisioning dell'applicazione Zenya.

    Screenshot che mostra la pagina di Provisioning utenti Zenya per la creazione di un token.

Aggiungere Zenya dalla raccolta di applicazioni Microsoft Entra per iniziare a gestire il provisioning in Zenya. Se Zenya è stata configurata in precedenza per l'accesso SSO, è possibile usare la stessa applicazione. Si consiglia però 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 mantenere il controllo 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 Zenya

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

Per altre informazioni (in olandese) consultare anche: Implementatie SCIM koppeling

Per configurare il provisioning utenti automatico per Zenya in Microsoft Entra ID:

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

  2. Passare a Identità>Applicazioni>Applicazioni enterprise

    Screenshot che mostra il pannello Applicazioni Enterprise.

  3. Nell'elenco delle applicazioni selezionare Zenya.

    Screenshot per selezionare l'applicazione dall'Elenco delle applicazioni.

  4. Selezionare la scheda Provisioning.

    Screenshot delle opzioni di gestione con l'opzione Provisioning evidenziata.

  5. Impostare Modalità di provisioning su Automatico.

    Screenshot dell'elenco a discesa Modalità di provisioning con l'opzione Automatico evidenziata.

  6. Nella sezione Credenziali amministratore immettere i valori dell'URL di base SCIM 2.0 e del token permanente recuperati in precedenza rispettivamente nei campi URL del tenant e aggiungere /scim/ all'URL. Aggiungere anche il Token segreto. È possibile generare un token segreto in Zenya usando il pulsante token permanente. Selezionare Test connessione per verificare che Microsoft Entra ID possa connettersi a Zenya. Se la connessione non riesce, verificare che l'account Zenya abbia le corrette autorizzazioni di amministratore e riprovare.

    Screenshot che mostra la pagina del Test di connessione e i campi per l'URL del tenant e il 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.

    Screenshot che mostra il campo per l'immissione di un indirizzo email per la notifica.

  8. Selezionare Salva.

  9. Nella sezione Mapping, selezionare Sincronizza utenti Microsoft Entra in Zenya.

  10. Esaminare gli attributi utente sincronizzati da Microsoft Entra ID a Zenya nella sezione Mapping attributi. Gli attributi selezionati come Proprietà corrispondenti vengono usati per trovare le corrispondenze con gli account utente in Zenua per le operazioni di aggiornamento. Selezionare il pulsante Salva per eseguire il commit delle modifiche.

    Attributo Type
    active Booleano
    displayName String
    emails[type eq "work"].value String
    preferredLanguage Stringa
    userName Stringa
    phoneNumbers[type eq "work"].value String
    externalId String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department Stringa
    title Stringa
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager Stringa

  11. Nella sezione Mapping selezionare Sincronizza gruppi di Microsoft Entra in Zenya.

  12. Esaminare gli attributi gruppo sincronizzati da Microsoft Entra ID a Zenya nella sezione Mapping attributi. Gli attributi selezionati come Proprietà corrispondenti vengono usati per trovare le corrispondenze con i gruppi in Zenya per le operazioni di aggiornamento. Selezionare il pulsante Salva per eseguire il commit delle modifiche.

    Attributo Type
    displayName String
    membri Riferimento
    externalID String

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

  14. Per abilitare il servizio di provisioning di Microsoft Entra per Zenya, impostare Stato del provisioning su Attivato nella sezione Impostazioni.

    Screenshot che mostra l'opzione stato del provisioning impostata su attivato.

  15. Definire gli utenti e/o i gruppi di cui si vuole eseguire il provisioning in Zenya selezionando i valori desiderati in Ambito nella sezione Impostazioni. È necessaria una licenza P1 o P2 per consentire il provisioning di utenti e gruppi assegnati.

    Screenshot che mostra dove selezionare l’ambito del provisioning.

  16. Quando si è pronti per eseguire il provisioning, selezionare Salva.

    Screenshot che mostra il pulsante Salva nella configurazione del provisioning.

L'operazione avvia la sincronizzazione iniziale di tutti gli utenti e/o i gruppi definiti in Ambito nella sezione Impostazioni. La sincronizzazione iniziale richiede più tempo delle sincronizzazioni successive, che saranno eseguite circa ogni 40 minuti quando il servizio di provisioning di Microsoft Entra è 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 entra in quarantena. Per altre informazioni sugli stati di quarantena, fare clic qui.

Registro modifiche

  • 17/06/2020 - Rimozione del supporto per l'attributo dell'estensione enterprise urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager.
  • 11/10/2023 - Supporto aggiuntivo per il titolo dell'attributo principale e aggiunta del supporto per gli attributi dell'estensione enterprise urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department e urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager.

Altre risorse

Passaggi successivi