Configura OpenID Connect per Okta

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:

  1. Attiva l'autenticazione delle viste pubbliche in ClickUp.
  2. A destra del campo URL di callback, fai clic su Copia.

Screenshot del pulsante Copia nel campo URL di callback

  1. 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:

  1. Accedi alla dashboard di amministrazione Okta della tua organizzazione.
  2. Seleziona la scheda Applicazioni.
  3. Seleziona Applicazioni.

Screenshot delle opzioni Applicazioni nella dashboard di amministrazione Okta

  1. Fai clic su Crea integrazione app.
  2. Come metodo di accesso, seleziona OIDC - OpenID Connect.
  3. Come tipo di applicazione, seleziona Applicazione web.
  4. Fai clic su Avanti.

Configura le impostazioni dell'applicazione

Per configurare le impostazioni dell'applicazione in Okta:

  1. 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.
  2. 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.
  3. 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.
  4. Fai clic su Salva.

Configura le impostazioni OIDC

Per configurare le impostazioni OIDC in Okta:

  1. Nella pagina Dettagli applicazione, apri la scheda Generale nella sezione Credenziali client.
  2. 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-org con 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
  3. Copia il valore dell'ID client. Ad esempio: 0oa2xyz123abc456def
  4. 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:

  1. Apri l'URL di individuazione in un browser e controlla che restituisca una configurazione JSON valida.
  2. Testa il flusso OIDC tramite la tua applicazione.
  3. Verifica che l'URL di callback sia raggiungibile e configurato correttamente.