Os Espaços de trabalho que dependem do Okta para provisionamento podem usar funções personalizadas para se integrar completamente ao Okta. Qualquer função criada no ClickUp pode ser adicionada como uma opção no Okta, facilitando a integração de funções personalizadas aos fluxos de trabalho existentes.

Antes de configurar o provisionamento, você precisa ter o SSO do Okta habilitado para o seu Espaço de trabalho.

O SSO do Okta está disponível apenas para Espaços de trabalho no Plano Enterprise.

Apenas proprietários e administradores do Espaço de trabalho podem habilitar o SSO do Okta.

Apenas administradores do Okta podem configurar o SCIM do Okta.

Configurar o SCIM do Okta e provisionar administradores, membros e convidados

O aplicativo ClickUp no Okta vem pré-configurado para provisionar administradores, membros e convidados. Para provisionar membros limitados, role até a próxima seção.

Para configurar o SCIM do Okta:

1. Após habilitar o SSO do Okta, você verá uma URL base do SCIM e um token de API do SCIM.
   • Se o seu Provedor de Identidade (IdP) oferece suporte a SCIM, mas você não está usando o Okta, ainda será necessário ter o URI de público (SP Entity ID) e a URL de logon único (ACS URL) exibidos após a integração bem-sucedida do SSO. Se o SCIM não for compatível com a integração oficial de SSO do ClickUp do seu IdP, use o SAML personalizado.

     

2. Na barra lateral esquerda do Painel do Okta, clique em Aplicativos e selecione Aplicativos.
3. Selecione o aplicativo ClickUp e clique na aba Provisionamento.
4. Marque a caixa de seleção Habilitar recursos de provisionamento.
5. Clique em Configurar integração de API.
6. Marque a caixa Habilitar integração de API.
7. Copie e cole a URL base do SCIM e o token de API do SCIM da etapa 1.
8. Clique em Testar credenciais de API. Se tiver êxito, uma mensagem de verificação será exibida.
9. Clique em Salvar.
10. No painel esquerdo, selecione Para o aplicativo.
11. Escolha os Recursos de provisionamento que deseja habilitar.
12. Atribua pessoas ao aplicativo e conclua a configuração.
13. Ao atribuir usuários ou grupos, defina o atributo Função do ClickUp. Se esse atributo não estiver definido, todos receberão a função de membro por padrão.

Provisionar membros com acesso limitado

Para provisionar o perfil de usuário de membro com acesso limitado, um administrador do Okta precisa fazer algumas atualizações.

Para provisionar o perfil de usuário de membro com acesso limitado:

1. No seu Painel do Okta, navegue até Directory e escolha Profile Editor.

   

2. Clique no perfil do ClickUp.
3. Você será direcionado para a página de Atributos.
4. Na linha Função do ClickUp, bem à direita, clique no ícone de lápis.

   

5. Na página Membros do atributo, na seção Nome de exibição, clique em Adicionar outro.
6. Na caixa de texto Nome de exibição, digite Membro com acesso limitado.
7. À direita do nome de exibição, na coluna Valor, digite 100.

   

8. No canto inferior direito, clique em Salvar atributo.
9. O perfil de usuário de membro com acesso limitado agora estará disponível como opção ao provisionar usuários no ClickUp.

Ações disponíveis com o Okta SCIM

Você pode realizar as seguintes ações com o Okta SCIM:

Resolver problemas em atualizações de perfil enviadas

Ao usar o envio de atualizações de perfil em usuários existentes, você pode encontrar os seguintes erros no log do sistema do Okta:

• TEAM_749 Unauthorized: o Okta tentou enviar uma atualização de perfil para o ClickUp, mas a solicitação foi rejeitada. As causas mais comuns são um token de API SCIM expirado ou inválido, ou o usuário de destino não estar devidamente vinculado entre o Okta e o ClickUp. Para resolver isso, gere um novo token de API SCIM no ClickUp, atualize-o nas configurações de integração do Okta e tente enviar o perfil novamente.
• Rate limit exceeded: enviar atualizações de perfil para muitos usuários ao mesmo tempo pode acionar o limite de taxa. Essas operações são repetidas automaticamente após 60 segundos. Nenhuma ação é necessária, a menos que as falhas persistam após várias tentativas.

Alterar ou atualizar um endereço de e-mail

Quando novos usuários são criados com a ação Enviar novos usuários, o Okta cria um nome de usuário e um e-mail, mas sem senha. Se um usuário ficar bloqueado porque o SSO deixou de estar vinculado, um proprietário ou administrador precisa seguir as etapas abaixo:

1. Se você exigir o uso do SSO para esse usuário, torne a autenticação SSO temporariamente opcional.
2. Altere o e-mail no Okta e, em seguida, altere o e-mail no ClickUp.
3. Se você tornou a autenticação SSO opcional, volte a exigi-la.
4. Verifique se o usuário consegue fazer login no ClickUp via SSO.

O e-mail pode ser usado como valor de nameID no Okta. Se você alterar o valor de nameID, será necessário reconectar sua conta SSO depois que o e-mail tiver sido alterado no Okta e no ClickUp.

Mapeamento do campo Gerente

O atributo Gerente está disponível para todos os Espaços de trabalho Enterprise.

No Okta, abra a tabela de Mapeamentos de Atributos do ClickUp e você verá a linha Gerente definida como manager.value. É assim que o Okta indica o gerente de cada pessoa.

O campo manager.value deve conter o endereço de e-mail do gerente correspondente ao e-mail da conta dele no ClickUp, ou o ID de usuário dele no ClickUp. Nomes de exibição como "John Smith" não são aceitos e causarão erros de provisionamento.

Defina Aplicar em como Criar e atualizar para manter as informações do gerente sempre sincronizadas. Depois de configurado, o gerente de cada pessoa aparece na página de visão geral de Pessoas no Teams Hub.

Atributos adicionais

Os atributos a seguir também estão disponíveis e estão sendo liberados gradualmente para todos os Espaços de trabalho Enterprise:

Quando esses atributos são definidos, eles também aparecem na página de visão geral de Pessoas no Teams Hub.