Configure OpenID Connect para Okta

Compartilhe links para visualizações públicas do ClickUp de forma segura via OpenID Connect (OIDC).

O que você precisará

• Um proprietário ou administrador do Workspace precisará configurar o OpenID Connect para seu Workspace.
• Uma conta de administrador do Okta.
• A autenticação de visualizações públicas está disponível apenas em Planos Enterprise.

Copie sua URL de callback

Durante a configuração no Assistente de Integração de Aplicativos do Okta, você precisará colar sua URL de callback. Para copiar sua URL de callback do ClickUp:

1. Ative a autenticação de visualizações públicas no ClickUp.
2. À direita do campo URL de Callback, clique em Copiar.
   
3. Sua URL de callback deve seguir este formato com base na sua configuração do ClickUp: https://app.clickup.com/data/v3/workspaces/{workspaceId}/oidc/callback.

Registre um novo aplicativo no Okta

Para registrar um novo aplicativo no Okta:

1. Faça login no Painel de Administração do Okta da sua organização.
2. Selecione a aba Aplicativos.

3. Selecione Aplicativos.

   

4. Clique em Criar Integração de Aplicativo.
5. Para o método de login, selecione OIDC – OpenID Connect.
6. Para o tipo de aplicativo, selecione Aplicativo Web.
7. Clique em Próximo.

Configure as configurações do aplicativo

Para configurar as configurações do aplicativo no Okta:

1. Na seção Configurações Gerais do Assistente de Integração de Aplicativos, configure estes campos:
   • Nome da integração do aplicativo: Insira um nome descritivo. Por exemplo, Integração ClickUp OIDC.
   • Logo do aplicativo: Opcional. Faça o upload de um logo.
2. Na seção Logout, configure estes campos:
   • URIs de redirecionamento de login: Cole o valor do campo URL de Callback no ClickUp. É aqui que o Okta envia as respostas OAuth.
   • URIs de redirecionamento de logout: Opcional. Insira a URL de redirecionamento se necessário para seu aplicativo. É aqui que o Okta redireciona o navegador após o logout da parte confiável e o término da sessão.
3. Na seção Atribuições, estas opções de Acesso controlado permitem que você escolha quem pode acessar este aplicativo:
   • Permitir que todos na sua organização acessem: A opção padrão.
   • Limitar o acesso a grupos selecionados: Insira os nomes dos grupos que podem acessar o aplicativo.
   • Ignorar a atribuição de grupos por enquanto: Crie o aplicativo sem atribuir nenhum grupo.
4. Clique em Salvar.

Configure as configurações OIDC

Para configurar as configurações OIDC no Okta:

1. Na página de Detalhes do Aplicativo, abra a aba Geral na seção Credenciais do Cliente.
2. Copie a URL do Documento de Descoberta. A URL de Descoberta para o Okta segue este formato: https://your-org.okta.com/.well-known/openid-configuration. Substitua your-org pelo seu subdomínio da organização Okta. A URL de Descoberta preencherá estes campos no ClickUp:
   • Emissor: issuer
   • Ponto de Extremidade de Autorização: authorization_endpoint
   • Ponto de Extremidade de Token: token_endpoint
   • Ponto de Extremidade de Informações do Usuário: userinfo_endpoint
   • URI JWKS: jwks_uri
3. Copie o valor do ID do Cliente. Por exemplo: 0oa2xyz123abc456def
4. Copie o valor do Segredo do Cliente.

Certifique-se de armazenar o Segredo do Cliente de forma segura. Ele não será exibido em texto claro novamente.

Configure configurações adicionais

Essas configurações são opcionais:

• Configurações de Tempo de Vida do Token: Na aba Geral, role para baixo até Configurações Gerais. Ajuste os tempos de vida do Token de Atualização e do Token de Acesso, se necessário.
• Tipos de Concessão Permitidos: Se você estiver configurando este campo, certifique-se de que Código de Autorização esteja habilitado, pois é necessário para o fluxo OIDC.

Teste sua configuração

Essas configurações serão processadas automaticamente pelo seu serviço ClickUp OIDC para derivar todos os outros pontos de extremidade e configurações necessárias.

Para testar sua configuração:

1. Use a URL de descoberta em um navegador para verificar se ela retorna uma configuração JSON válida.

   • Por exemplo: 

     { 
         "clientId": "0oa2xyz123abc456def",
         "clientSecret": "very-long-secret-string-here",
         "discoveryUrl": "https://your-org.okta.com/.well-known/openid-configuration"
     }

2. Teste o fluxo OIDC usando seu aplicativo.
3. Verifique se a URL de callback é acessível e está configurada corretamente.

Precisa de mais ajuda? O suporte do ClickUp está à disposição.

E se você busca otimizar o uso do ClickUp no seu time, a Audatia (parceira oficial no Brasil) tem especialistas prontos para ajudar com consultoria e treinamentos. Fale com um consultor →