Configurar o logon único (SSO) via Active Directory Federation Services (AD FS) para sua conta do ClickUp permite que os usuários façam login no ClickUp com sua conta Microsoft auto-hospedada.

Se você estiver usando o Microsoft 365 ou o Azure Active Directory, use nossa opção de logon único da Microsoft.

O que você vai precisar

• Somente proprietários e administradores podem configurar o SSO com SAML.
• O SAML personalizado está disponível apenas no plano Enterprise. Para saber mais sobre nossos planos, clique aqui.

Configurar o Microsoft Active Directory local com o Active Directory Federation Service e o SSO com SAML

São cinco etapas para configurar o SSO com SAML na sua conta do ClickUp com o Microsoft Active Directory local.

1. Coletar os detalhes do SSO com SAML no ClickUp
2. Configurar a confiança de terceira parte confiável para o AD FS
3. Adicionar regras ao AD FS
4. Exportar o certificado de assinatura
5. Concluir o processo de configuração no ClickUp

Etapa 1: Coletar os detalhes do SSO com SAML no ClickUp

O primeiro passo é coletar os detalhes do SSO com SAML no ClickUp.

1. Clique no avatar do seu Espaço de trabalho e depois clique em Configurações.
2. Selecione Segurança e permissões.
3. Na seção Logon único (SSO), selecione SAML.

   

   • As configurações de SSO anteriores do seu espaço de trabalho serão substituídas.
4. Em Configurar logon único SAML, você verá os seguintes itens que precisará consultar nas próximas etapas:
   • Certificado do SP
   • URL de logon único
   • URL de audiência (ID da entidade SP)
5. Copie todo o texto do Certificado do SP e cole em um editor de texto, como o VS Code.
6. Salve o arquivo como clickup.cert. O certificado de segurança não vai funcionar se qualquer parte do texto do Certificado do SP for removida.

Etapa 2: Configurar a confiança de terceira parte confiável para o AD FS

Depois de salvar o certificado de segurança, você vai criar uma confiança de terceira parte confiável no Gerenciador do Servidor Windows. Isso permite que o ClickUp se conecte à sua implantação do Active Directory.

1. No Gerenciador do Servidor Windows, clique em Ferramentas e selecione Gerenciamento do AD FS.
2. Na coluna Ações à direita, clique em Adicionar confiança de terceira parte confiável. Um assistente será aberto para guiá-lo pelo processo de configuração.

   

3. Na página de Boas-vindas, escolha Com reconhecimento de declarações e clique em Iniciar.
4. Na etapa Selecionar fonte de dados, selecione Inserir dados sobre a terceira parte confiável manualmente e clique em Avançar.
5. Adicione um Nome de exibição e clique em Avançar. Recomendamos usar ClickUp como nome.
6. Na etapa Configurar certificado, clique no botão Procurar.
7. Selecione o arquivo clickup.cert criado na etapa anterior e clique em Avançar.
8. Na etapa Configurar URL, marque Habilitar suporte para o protocolo SAML 2.0 WebSSO.
9. Cole a URL de logon único da etapa anterior no campo URL do serviço SAML 2.0 da terceira parte confiável e clique em Avançar.
10. Na etapa Configurar identificadores, cole a URL de audiência (ID da entidade SP) da etapa anterior no campo Identificador de confiança da terceira parte confiável.
11. Clique em Adicionar e depois em Avançar.
12. Na etapa Escolher política de controle de acesso, selecione Permitir a todos e clique em Avançar. Isso determina quem pode autenticar a conta do ClickUp via SSO.
13. Na etapa Pronto para adicionar confiança, clique em Avançar e Feche o assistente.

Etapa 3: Adicionar regras ao AD FS

Agora você precisa adicionar duas regras ao AD FS no Gerenciador do Servidor Windows. Isso garante que a integração envie atributos do Lightweight Directory Access Protocol (LDAP) como declarações.

1. No Gerenciador do Servidor Windows, clique em Ferramentas.
2. Selecione Gerenciamento do AD FS.
3. Na árvore do console, em AD FS, clique em Confianças de terceiras partes confiáveis.

   

4. Clique com o botão direito no Nome de exibição criado na etapa anterior e selecione Editar política de emissão de declarações.

   

Adicionar a primeira regra

1. Na caixa de diálogo Editar política de emissão de declarações, na guia Regras de transformação de emissão, clique em Adicionar regra.

   

2. Na página Selecionar modelo de regra, em Modelo de regra de declaração, selecione Enviar atributos LDAP como declarações na lista e clique em Avançar.
3. Na página Configurar regra, preencha as informações abaixo e clique em Concluir para finalizar e voltar à caixa de diálogo Editar política de emissão de declarações:
   • 1: Nome da regra de declaração: ClickUp LDAP
   • 2: Repositório de atributos: Active Directory
   • 3: No atributo LDAP: Endereço de e-mail
   • 4: Tipo de declaração de saída de endereço de e-mail: Endereço de e-mail

     

Adicionar a segunda regra

1. Clique em Adicionar regra para adicionar uma segunda regra de transformação.
2. Na página Selecionar modelo de regra, em Modelo de regra de declaração, selecione Transformar uma declaração de entrada na lista e clique em Avançar para continuar.
3. Na página Configurar regra de declaração, preencha as informações abaixo e clique em Concluir para finalizar.
   • 1: Nome da regra de declaração: Transformar endereço de e-mail como NameID
   • 2: Tipo de declaração de entrada: Endereço de e-mail.
   • 3: Tipo de declaração de saída: NameID
   • 4: Formato de ID de nome de saída: E-mail
   • 5: Selecione Passar todos os valores de declaração.

     

4. Na caixa de diálogo Editar política de emissão de declarações, clique em Aplicar para aplicar as duas regras.

Etapa 4: Exportar o certificado de assinatura

Agora você vai exportar o Certificado de assinatura do Gerenciador do Servidor Windows. Ele é frequentemente chamado de certificado X509 e serve para verificar sua organização por meio do seu Provedor de identidade.

1. No Gerenciador do Servidor Windows, clique em Ferramentas e selecione Gerenciamento do AD FS.
2. Expanda a pasta Serviço e selecione Certificados.

   

3. Clique com o botão direito no Certificado de assinatura de token e selecione Exibir certificado

   

4. Na caixa de diálogo Certificado, clique na guia Detalhes.
5. Clique em Copiar para arquivo.

6. No Assistente de exportação de certificados, clique em Avançar.
7. Selecione X.509 codificado em Base-64 (CER) e clique em Avançar.
8. Nomeie o arquivo de certificado como adfsdomain.cer e clique em Avançar.
9. Clique em Concluir para exportar o certificado. Verifique se o certificado está na guia Assinatura e não na guia Criptografia.

O AD FS vai exportar o certificado para a pasta de downloads configurada.

Etapa 5: Concluir o processo de configuração no ClickUp

Agora que você configurou tudo no AD FS, adicione os detalhes do AD FS ao ClickUp. Para mais informações, consulte Logon único SAML personalizado.

1. Clique no avatar do seu Espaço de trabalho e depois clique em Configurações.
2. Selecione Segurança e permissões.
3. Na seção Logon único (SSO), selecione SAML.
4. Adicione as seguintes informações do AD FS ao ClickUp:
   • ID da entidade IdP: Informa ao ClickUp qual Provedor de identidade você está usando.
   • URL de destino SSO do IdP: O ClickUp usa este link para se conectar ao Provedor de identidade quando alguém da sua organização tenta fazer login via SSO com SAML. Para o AD FS, o formato é algo como: https://sso.yourdomain.tld/adfs/ls/
   • Certificado de assinatura do IDP: É o certificado baixado na Etapa 4.
   • Abra o editor de texto de sua preferência.
   • Use o editor de texto para abrir o arquivo adfsdomain.cer baixado anteriormente na Etapa 4.
   • Copie todo o valor do texto para a seção Certificado público do IDP.

Dicas de solução de problemas

O erro A resposta SAML ainda não é válida pode ser causado por um problema de sincronização do relógio do servidor ADFS com o carimbo de data/hora do SAML.

Para resolver isso, você pode:

• Atualizar o relógio do servidor ADFS para o fuso horário do seu Espaço de trabalho do ClickUp
• Executar o comando PowerShell abaixo, que ignora essa verificação: Set-AdfsRelyingPartyTrust -TargetName Clickup -NotBeforeSkew 5