Esercitazione: Configurare Clarizen One per il provisioning utenti automatico
Questa esercitazione descrive i passaggi da eseguire sia in Clarizen One 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 Clarizen One usando il servizio di provisioning di Microsoft Entra. Per informazioni su questo servizio e su come funziona, insieme alle domande frequenti, vedere Automatizzare il provisioning e il deprovisioning degli utenti in applicazioni SaaS (Software as a Service) con Microsoft Entra ID.
Capacità supportate
- Creare utenti in Clarizen One.
- Rimuovere utenti da Clarizen One quando non richiedono più l'accesso.
- Mantenere sincronizzati gli attributi utente tra Microsoft Entra ID e Clarizen One.
- Effettuare il provisioning di gruppi e appartenenze a gruppi in Clarizen One.
- Accesso Single Sign-On (SSO) a Clarizen One (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 Clarizen One con le autorizzazioni Integration User (Utente integrazione) e Lite admin (Amministratore lite).
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 e Clarizen One.
Passaggio 2: Configurare Clarizen One per supportare il provisioning con Microsoft Entra ID
Selezionare uno dei quattro URL tenant seguenti in base all'ambiente e al data center di Clarizen One:
- Data center di produzione USA: https://servicesapp2.clarizen.com/scim/v2
- Data center di produzione EU: https://serviceseu1.clarizen.com/scim/v2
- Data center sandbox USA: https://servicesapp.clarizentb.com/scim/v2
- Data center sandbox EU: https://serviceseu.clarizentb.com/scim/v2
Creare una chiave API. Questo valore verrà immesso nel campo Secret Token nella scheda Provisioning dell'applicazione Clarizen One.
Passaggio 3: Aggiungere Clarizen One dalla raccolta di applicazioni di Microsoft Entra
Aggiungere Clarizen One dalla raccolta di applicazioni di Microsoft Entra per iniziare a gestire il provisioning in Clarizen One. Se Clarizen One è stato configurato in precedenza per l'accesso SSO, è possibile usare la stessa applicazione. Quando si testa inizialmente l'integrazione, creare un'app separata. Per altre informazioni su come aggiungere un'applicazione dalla raccolta, vedere Aggiungere un'applicazione al tenant di Microsoft Entra.
Passaggio 4: Definire gli utenti che verranno inclusi nell'ambito per il provisioning
Con il servizio di provisioning di Microsoft Entra è possibile definire l'ambito per gli utenti di cui verrà effettuato il provisioning in base all'assegnazione all'applicazione oppure in base agli attributi dell'utente o del gruppo. Se si sceglie di definire l'ambito degli utenti di cui verrà effettuato il provisioning per l'app in base all'assegnazione, seguire la procedura descritta in Gestire l'assegnazione di utenti per un'app in Microsoft Entra ID per assegnare utenti e gruppi all'applicazione. Se si sceglie di definire l'ambito degli utenti di cui verrà effettuato il provisioning esclusivamente in base agli attributi dell'utente o del gruppo, usare un filtro per la definizione dell'ambito come descritto in Provisioning dell'applicazione basato su attributi con filtri per la definizione dell'ambito.
- Quando si assegnano utenti e gruppi a Clarizen One, è necessario selezionare un ruolo diverso da Accesso predefinito. Gli utenti con il ruolo Accesso predefinito vengono esclusi dal provisioning e verranno contrassegnati come non autorizzati nei log di provisioning. Se l'unico ruolo disponibile nell'applicazione è il ruolo di accesso predefinito, è possibile aggiornare il manifesto dell'applicazione per aggiungere altri ruoli.
- Iniziare con pochi elementi. Eseguire il test con un piccolo set di utenti e gruppi prima di procedere alla distribuzione generale. 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 definizione dell'ambito basato su attributi.
Passaggio 5: Configurare il provisioning utenti automatico in Clarizen One
Questa sezione descrive la procedura per configurare il servizio di provisioning di Microsoft Entra per creare, aggiornare e disabilitare utenti o gruppi in TestApp in base alle assegnazioni di utenti o gruppi in Microsoft Entra ID.
Configurare il provisioning utenti automatico per Clarizen One in Microsoft Entra ID
Accedere all'Interfaccia di amministrazione di Microsoft Entra almeno come Amministratore applicazione cloud.
Passare a Identità>Applicazioni>Applicazioni aziendali.
Nell'elenco delle applicazioni selezionare Clarizen One.
Selezionare la scheda Provisioning.
Impostare Modalità di provisioning su Automatico.
Nella sezione Credenziali amministratore immettere l'URL tenant e il token segreto di Clarizen One. Selezionare Test connessione per verificare che Microsoft Entra ID possa connettersi a Clarizen One. Se la connessione non riesce, verificare che l'account Clarizen One abbia autorizzazioni di amministratore e riprovare.
Nella casella Indirizzo di posta elettronica per le notifiche immettere l'indirizzo di posta elettronica di una persona o di un gruppo che riceverà le notifiche degli errori di provisioning. Selezionare la casella di controllo Invia una notifica di posta elettronica in caso di errore.
Seleziona Salva.
Nella sezione Mapping selezionare Sincronizza utenti Microsoft Entra in Clarizen One.
Esaminare gli attributi utente sincronizzati da Microsoft Entra ID a Clarizen One nella sezione Mapping attributi. Gli attributi selezionati come proprietà corrispondenti vengono usati per trovare le corrispondenze con gli account utente in Clarizen One per le operazioni di aggiornamento. Se si cambia l'attributo di destinazione corrispondente, sarà necessario assicurarsi che l'API Clarizen One supporti il filtro degli utenti basato su tale attributo. Selezionare il pulsante Salva per eseguire il commit delle modifiche.
Attributo Type userName String displayName String active Booleano title String emails[type eq "work"].value String emails[type eq "home"].value String emails[type eq "other"].value String preferredLanguage String name.givenName String name.familyName String name.formatted String name.honorificPrefix String name.honorificSuffix String addresses[type eq "other"].formatted String addresses[type eq "work"].formatted String addresses[type eq "work"].country String addresses[type eq "work"].region String addresses[type eq "work"].locality String addresses[type eq "work"].postalCode String addresses[type eq "work"].streetAddress String phoneNumbers[type eq "work"].value String phoneNumbers[type eq "mobile"].value String phoneNumbers[type eq "fax"].value String phoneNumbers[type eq "home"].value String phoneNumbers[type eq "other"].value String phoneNumbers[type eq "pager"].value String externalId String nickName String locale String roles[primary eq "True".type] String roles[primary eq "True".value] String timezone String userType String urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department String urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber String urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager Riferimento urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter String urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division String urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division String Nella sezione Mapping selezionare Sincronizza gruppi Microsoft Entra in Clarizen One.
Esaminare gli attributi del gruppo sincronizzati da Microsoft Entra ID a Clarizen One nella sezione Mapping attributi. Gli attributi selezionati come proprietà corrispondenti vengono usati per trovare le corrispondenze con i gruppi in Clarizen One per le operazioni di aggiornamento. Selezionare il pulsante Salva per eseguire il commit delle modifiche.
Attributo Type displayName String externalId String membri Riferimento Per configurare i filtri di definizione dell'ambito, vedere le istruzioni riportate in questa esercitazione.
Per abilitare il servizio di provisioning di Microsoft Entra per Clarizen One, impostare Stato del provisioning su Sì nella sezione Impostazioni.
Definire gli utenti o i gruppi di cui effettuare il provisioning in Clarizen One selezionando i valori appropriati in Ambito nella sezione Impostazioni.
Quando si è pronti per eseguire il provisioning, selezionare Salva.
L'operazione avvia il ciclo di sincronizzazione iniziale di tutti gli utenti e i gruppi 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.
- Usare i log di provisioning per determinare gli utenti di cui è stato eseguito il provisioning con esito positivo o negativo.
- Controllare l'indicatore di stato per visualizzare lo stato del ciclo di provisioning e quanto manca al completamento.
- Se la configurazione del provisioning sembra essere in uno stato non integro, l'applicazione entrerà in quarantena. Per altre informazioni sugli stati di quarantena, vedere Provisioning delle applicazioni in stato di quarantena.
Suggerimenti per la risoluzione dei problemi
Quando si assegna un utente all'app Clarizen One della raccolta, selezionare solo il ruolo Utente. I ruoli seguenti non sono validi:
- Administrator (admin)
- Email Reporting user
- External user
- Financial user
- Social user
- Superuser
- Time & Expense user
Risorse aggiuntive
- Gestione del provisioning degli account utente per le app aziendali
- Che cos'è l'accesso alle applicazioni e Single Sign-On con Microsoft Entra ID?