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 di Microsoft Entra.
• L'autenticazione delle viste pubbliche è disponibile solo nei piani Enterprise.

Copia il tuo URL di callback

Durante la configurazione nel centro di amministrazione di Microsoft Entra, dovrai incollare il tuo URL di callback. Per copiare il tuo 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.

   

3. Il tuo URL di callback deve seguire questo formato in base alla tua configurazione di ClickUp: https://app.clickup.com/data/v3/workspaces/{workspaceId}/oidc/callback.

Registra una nuova applicazione in Microsoft Entra

Per registrare una nuova applicazione in Microsoft Entra:

1. Accedi al centro di amministrazione di Microsoft Entra della tua organizzazione.
2. Nella barra laterale sinistra, fai clic su Identità.
3. Nella scheda Entra ID, fai clic su Registrazioni app.
4. Fai clic su Nuova registrazione e seleziona uno di questi Tipi di account supportati:
   • Account solo in questa directory organizzativa: è l'opzione più comune per gli account Enterprise.
   • Account in qualsiasi directory organizzativa: si tratta di una configurazione multi-tenant.
   • Account in qualsiasi directory organizzativa e account Microsoft personali: si tratta di una configurazione multi-tenant che consente anche gli account personali.
5. Nella sezione Configurazioni della piattaforma, seleziona Aggiungi una piattaforma, quindi seleziona Web.
6. Nel campo URI di reindirizzamento, incolla il valore del campo URL di callback di ClickUp. È l'indirizzo a cui Microsoft Entra invia le risposte OAuth.
7. Fai clic su Registra.

Configura l'autenticazione

Per configurare le impostazioni di autenticazione in Microsoft Entra:

1. Nella barra laterale sinistra, fai clic su Autenticazione.
2. Nella sezione Configurazione della piattaforma, verifica che il tuo URI di reindirizzamento sia configurato correttamente.
   • Aggiungi altri URI di reindirizzamento, se necessario.
3. Nelle Impostazioni avanzate, configura le seguenti opzioni:
   • Consenti flussi client pubblici: seleziona No. Questa opzione è consigliata per le applicazioni web.
   • Tipi di account supportati: verifica che la selezione corrisponda ai tuoi requisiti.

Crea il segreto client

Per creare il tuo segreto client in Microsoft Entra:

1. Nella barra laterale sinistra, fai clic su Certificati e segreti.
2. Fai clic su Nuovo segreto client e configura le seguenti opzioni:
   • Descrizione: inserisci una descrizione. Ad esempio, OIDC Client Secret.
   • Scadenza: seleziona un periodo di scadenza. Consigliamo un massimo di 24 mesi.
   • Fai clic su Aggiungi.
3. Assicurati di conservare il segreto client in modo sicuro. Non verrà più mostrato in chiaro.

Recupera i dettagli di configurazione

Per recuperare i dettagli di configurazione in Microsoft Entra:

1. Dalla pagina Panoramica, copia questi ID:
   • ID applicazione (client): ad esempio, 12345678-1234-1234-1234-123456789abc
   • ID directory (tenant): ad esempio, 12345678-1234-1234-1234-123456789abc

• URL di individuazione OpenID discoveryUrl: l'URL di individuazione per Microsoft Entra ID segue questo formato:
  • https://login.microsoftonline.com/{tenant-id}/v2.0/.well-known/openid-configuration.
  • Sostituisci {tenant-id} con il tuo ID directory (tenant).
  • Ad esempio: https://login.microsoftonline.com/12345678-1234-1234-1234-123456789abc/v2.0/.well-known/openid-configuration.
  • L'URL di individuazione OIDC fornisce automaticamente questi endpoint:
  • Emittente:issuer
  • Endpoint di autorizzazione:authorization_endpoint
  • Endpoint token:token_endpoint
  • Endpoint UserInfo:userinfo_endpoint
  • URI JWKS:jwks_uri

Configura le autorizzazioni API

Queste impostazioni sono facoltative.

Per configurare le autorizzazioni API:

1. Nella barra laterale sinistra, fai clic su Autorizzazioni API.
2. Per impostazione predefinita, viene aggiunta l'autorizzazione User.Read, che consente la lettura delle informazioni di base del profilo utente.
   • Se necessario, fai clic su Aggiungi un'autorizzazione, quindi scegli Microsoft Graph. Facoltativamente, puoi aggiungere queste autorizzazioni:
   • openid: accesso tramite OpenID Connect.
   • profile: informazioni di base del profilo.
   • email: indirizzo email.
   • Se le autorizzazioni richiedono il consenso dell'amministratore, fai clic su Concedi il consenso amministratore.

Testa la tua configurazione

Queste configurazioni verranno elaborate automaticamente dal servizio OIDC di ClickUp per ricavare tutti gli altri endpoint e le impostazioni necessari.

Per testare la tua configurazione:

1. Usa l'URL di individuazione in un browser per verificare che restituisca una configurazione JSON valida.
2. Testa il flusso OIDC con la tua applicazione.
3. Verifica che l'URL di callback sia accessibile e configurato correttamente.