Condividi in modo sicuro i link alle viste pubbliche di ClickUp tramite OpenID Connect (OIDC).
Cosa ti serve
- Il titolare o un amministratore dell'area di lavoro dovrà configurare OpenID Connect per la tua area di lavoro.
- Un account amministratore Okta.
- L'autenticazione delle viste pubbliche è disponibile solo nei piani Enterprise.
Copia l'URL di callback
Durante la configurazione nell'App Integration Wizard di Okta, dovrai incollare il tuo URL di callback. Per copiare l'URL di callback da ClickUp:
- Attiva l'autenticazione delle viste pubbliche in ClickUp.
- A destra del campo URL di callback, fai clic su Copia.
- Il tuo URL di callback deve seguire questo formato in base alla configurazione di ClickUp: https://app.clickup.com/data/v3/workspaces/{workspaceId}/oidc/callback.
Registra una nuova applicazione in Okta
Per registrare una nuova applicazione in Okta:
- Accedi alla dashboard di amministrazione Okta della tua organizzazione.
- Seleziona la scheda Applicazioni.
- Seleziona Applicazioni.
- Fai clic su Crea integrazione app.
- Come metodo di accesso, seleziona OIDC - OpenID Connect.
- Come tipo di applicazione, seleziona Applicazione web.
- Fai clic su Avanti.
Configura le impostazioni dell'applicazione
Per configurare le impostazioni dell'applicazione in Okta:
- Nella sezione Impostazioni generali dell'App Integration Wizard, compila questi campi:
-
Nome integrazione app: Inserisci un nome descrittivo, ad esempio
ClickUp OIDC integration. - Logo app: Facoltativo. Carica un logo.
-
Nome integrazione app: Inserisci un nome descrittivo, ad esempio
- Nella sezione Disconnessione, compila questi campi:
- URI di reindirizzamento all'accesso: Incolla il valore del campo URL di callback di ClickUp. È qui che Okta invia le risposte OAuth.
- URI di reindirizzamento alla disconnessione: Facoltativo. Inserisci l'URL di reindirizzamento se necessario per la tua applicazione. È qui che Okta reindirizza il browser dopo la disconnessione dalla relying party e la chiusura della sessione.
- Nella sezione Assegnazioni, le opzioni di Accesso controllato ti permettono di scegliere chi può accedere all'applicazione:
- Consenti l'accesso a tutti i membri della tua organizzazione: l'opzione predefinita.
- Limita l'accesso ai gruppi selezionati: inserisci i nomi dei gruppi che possono accedere all'app.
- Salta l'assegnazione dei gruppi per ora: crea l'app senza assegnare alcun gruppo.
- Fai clic su Salva.
Configura le impostazioni OIDC
Per configurare le impostazioni OIDC in Okta:
- Nella pagina Dettagli applicazione, apri la scheda Generale nella sezione Credenziali client.
- Copia l'URL del documento di individuazione. L'URL di individuazione per Okta segue questo formato: https://your-org.okta.com/.well-known/openid-configuration. Sostituisci
your-orgcon il sottodominio della tua organizzazione Okta. L'URL di individuazione compilerà automaticamente questi campi in ClickUp:-
Emittente:
issuer -
Endpoint di autorizzazione:
authorization_endpoint -
Endpoint token:
token_endpoint -
Endpoint UserInfo:
userinfo_endpoint -
URI JWKS:
jwks_uri
-
Emittente:
- Copia il valore dell'ID client. Ad esempio:
0oa2xyz123abc456def - Copia il valore del segreto client.
Conserva il segreto client in un posto sicuro. Non verrà più mostrato in chiaro.
Configura le impostazioni aggiuntive
Queste impostazioni sono facoltative:
- Impostazioni della durata del token: nella scheda Generale, scorri fino a Impostazioni generali. Modifica la durata del Token di aggiornamento e del Token di accesso se necessario.
- Tipi di concessione consentiti: se stai configurando questo campo, assicurati che Codice di autorizzazione sia abilitato, poiché è richiesto dal flusso di lavoro OIDC.
Verifica la configurazione
Queste configurazioni verranno elaborate automaticamente dal servizio OIDC di ClickUp per ricavare tutti gli altri endpoint e le impostazioni necessari.
Per verificare la configurazione:
- Apri l'URL di individuazione in un browser e controlla che restituisca una configurazione JSON valida.
- Testa il flusso OIDC tramite la tua applicazione.
- Verifica che l'URL di callback sia raggiungibile e configurato correttamente.