Le aree di lavoro che si affidano a Okta per il provisioning possono usare i ruoli personalizzati per integrarsi completamente con Okta. Qualsiasi ruolo creato in ClickUp può essere aggiunto come opzione in Okta, semplificando l'integrazione dei ruoli personalizzati nei flussi di lavoro esistenti.
Prima di configurare il provisioning, devi abilitare Okta SSO per la tua area di lavoro.
Okta SSO è disponibile solo per le aree di lavoro con il Piano Enterprise.
Solo i titolari e gli amministratori dell'area di lavoro possono abilitare Okta SSO.
Solo gli amministratori di Okta possono configurare Okta SCIM.
Configura Okta SCIM ed esegui il provisioning di amministratori, membri e ospiti
L'app ClickUp in Okta è preconfigurata per il provisioning di amministratori, membri e ospiti. Per eseguire il provisioning di membri con accesso limitato, scorri alla sezione successiva.
Per configurare Okta SCIM:
- Dopo aver abilitato Okta SSO, vedrai un URL base SCIM e un token API SCIM.
- Se il tuo Identity Provider (IdP) supporta SCIM ma non stai usando Okta, avrai comunque bisogno dell'URI Audience (SP Entity ID) e dell'URL Single sign on (ACS URL) mostrati dopo aver integrato correttamente SSO. Se SCIM non è supportato per l'integrazione SSO ufficiale di ClickUp del tuo IdP, devi usare il SAML personalizzato.
- Se il tuo Identity Provider (IdP) supporta SCIM ma non stai usando Okta, avrai comunque bisogno dell'URI Audience (SP Entity ID) e dell'URL Single sign on (ACS URL) mostrati dopo aver integrato correttamente SSO. Se SCIM non è supportato per l'integrazione SSO ufficiale di ClickUp del tuo IdP, devi usare il SAML personalizzato.
- Nella barra laterale sinistra della tua Okta Dashboard, fai clic su Applicazioni, quindi seleziona Applicazioni.
- Seleziona l'applicazione ClickUp e fai clic sulla scheda Provisioning.
- Seleziona la casella di controllo Abilita funzionalità di provisioning.
- Fai clic su Configura integrazione API.
- Seleziona la casella Abilita integrazione API.
- Copia e incolla l'URL base SCIM e il token API SCIM dal passaggio 1.
- Fai clic su Verifica credenziali API. Se l'operazione riesce, viene visualizzato un messaggio di verifica.
- Fai clic su Salva.
- Nel pannello di sinistra, seleziona All'app.
- Scegli le Funzionalità di provisioning che vuoi abilitare.
- Assegna le persone all'app e completa la configurazione dell'applicazione.
- Quando assegni utenti o gruppi, assegna l'attributo Ruolo ClickUp. Se questo attributo non è impostato, tutti avranno il ruolo di membro come impostazione predefinita.
Esegui il provisioning dei membri con accesso limitato
Per eseguire il provisioning del ruolo utente membro con accesso limitato, un amministratore di Okta deve apportare alcuni aggiornamenti.
Per eseguire il provisioning del ruolo utente membro con accesso limitato:
- Nella tua Okta Dashboard, vai a Directory e scegli Editor profili.
- Fai clic sul profilo di ClickUp.
- Verrai reindirizzato alla pagina Attributi.
- Nella riga Ruolo ClickUp, all'estrema destra, fai clic sull'icona a forma di matita.
- Nella pagina Membri dell'attributo, nella sezione Nome visualizzato, fai clic su Aggiungi un altro.
- Nella casella di testo Nome visualizzato, digita Membro con accesso limitato.
- A destra del nome visualizzato, nella colonna Valore, digita 100.
- Nell'angolo in basso a destra, fai clic su Salva attributo.
- Il ruolo utente membro con accesso limitato è ora disponibile come opzione durante il provisioning degli utenti in ClickUp.
Azioni disponibili con Okta SCIM
Puoi eseguire le seguenti azioni tramite Okta SCIM:
| Azione | Descrizione |
| Invia nuovi utenti | I nuovi utenti creati tramite Okta vengono creati anche nell'applicazione di terze parti. |
| Invia nuovo gruppo | I nuovi gruppi creati tramite Okta vengono creati anche come Team in ClickUp. Quando un team viene creato tramite Okta, nella colonna Origine della pagina Team viene visualizzato SCIM Provisioned. I team creati manualmente mostrano Manual nella colonna Origine. Assicurati di abilitare l'importazione dei gruppi nella scheda Provisioning per usare SCIM con i gruppi. |
| Invia aggiornamenti del profilo | Gli aggiornamenti al profilo dell'utente tramite Okta vengono applicati anche nell'applicazione di terze parti. |
| Invia disattivazione utente | La disattivazione o la disabilitazione dell'accesso dell'utente all'applicazione tramite Okta disattiva l'utente anche nell'applicazione di terze parti. Quando gli utenti vengono disattivati in Okta, vengono rimossi dall'area di lavoro ClickUp associata. Gli utenti non potranno accedere a nulla in quell'area di lavoro, ma i loro dati resteranno disponibili come "utente inattivo". Non restituiamo alcun dato utente per gli utenti disattivati nelle risposte SCIM, ad eccezione del loro stato di disattivazione. Per questa applicazione, disattivare un utente significa revocare l'accesso al login mantenendo le sue informazioni come utente inattivo. |
| Riattiva utenti | Gli account utente possono essere riattivati nell'applicazione. |
Risolvi i problemi con Invia aggiornamenti del profilo
Quando usi Invia aggiornamenti del profilo su utenti esistenti, potresti riscontrare i seguenti errori nel registro di sistema di Okta:
-
TEAM_749 Unauthorized: Okta ha tentato di inviare un aggiornamento del profilo a ClickUp, ma la richiesta è stata rifiutata. Le cause più comuni sono un token API SCIM scaduto o non valido, oppure l'utente di destinazione non correttamente collegato tra Okta e ClickUp. Per risolvere il problema, rigenera il token API SCIM in ClickUp, aggiornalo nelle impostazioni dell'integrazione Okta e riprova a inviare il profilo. -
Rate limit exceeded: inviare aggiornamenti del profilo per molti utenti contemporaneamente può attivare la limitazione della frequenza. Queste operazioni vengono riprovate automaticamente dopo 60 secondi. Non è necessaria alcuna azione, a meno che i problemi non persistano dopo più tentativi.
Modifica o aggiorna un indirizzo email
Quando vengono creati nuovi utenti con l'azione Invia nuovi utenti, Okta crea un nome utente e un'email, ma non una password. Se un utente viene bloccato perché SSO si è disconnesso, un titolare o un amministratore deve seguire questi passaggi:
- Se richiedi l'uso di SSO per questo utente, rendi temporaneamente facoltativa l'autenticazione SSO.
- Modifica l'email in Okta, poi modifica l'email in ClickUp.
- Se hai reso facoltativa l'autenticazione SSO, rendila di nuovo obbligatoria.
- Verifica che l'utente possa accedere a ClickUp tramite SSO.
L'email può essere usata come valore nameID in Okta. Se modifichi il valore nameID, dovrai ricollegare il tuo account SSO dopo aver modificato l'email in Okta e ClickUp.
Mappatura del campo Responsabile
L'attributo Responsabile è disponibile per tutte le aree di lavoro Enterprise.
In Okta, apri la tabella Mappature attributi di ClickUp e vedrai la riga Responsabile impostata su manager.value. È il modo in cui Okta fa riferimento al responsabile di ciascuna persona.
Il campo manager.value deve contenere l'indirizzo email del responsabile corrispondente all'email del suo account ClickUp oppure il suo ID utente ClickUp. I nomi visualizzati come "Mario Rossi" non sono accettati e causeranno errori di provisioning.
Imposta Applica su su Crea e aggiorna in modo che le informazioni sul responsabile restino sincronizzate. Una volta configurato, il responsabile di ciascuna persona viene visualizzato nella pagina Panoramica persone in Teams Hub.
Attributi aggiuntivi
I seguenti attributi sono disponibili e vengono gradualmente rilasciati a tutte le aree di lavoro Enterprise:
| Attributo | Descrizione |
| Reparto | Il reparto dell'utente all'interno dell'organizzazione. |
| Regione | La regione geografica dell'utente. |
Quando questi attributi sono impostati, vengono visualizzati anche nella pagina Panoramica persone in Teams Hub.