Configurando a sincronização de usuário do SCIM com Okta

Configure a Sincronização de usuários SCIM entre o Okta e sua organização da UiPath no Test Cloud usando o OAuth2 ou o token de portador.

Esta página descreve como configurar o SCIM (sistema de gerenciamento de identidade entre domínios) da sincronização de usuários entre o Okta e sua organização UiPath.

Pré-requisitos

• Uma licença Enterprise ou Enterprise Trial para sua organização do UiPath.
• Permissões de administrador em sua organização UiPath e seu tenant Okta.
• Uma integração em funcionamento do Single Sign-On (SSO) da Linguagem de Marcação de Asserção de Segurança (SAML) entre o Okta e a UiPath. Para obter instruções de configuração, consulte Configuração do Okta como seu provedor de identidade.
• O mesmo conjunto de usuários deve ser atribuído aos aplicativos SAML SSO e SCIM.

Antes de começar

Configure o SSO antes de habilitar o SCIM. Para uma nova configuração, conclua as etapas nesta ordem:

1. Crie o aplicativo no Okta e configure o SSO do SAML com o UiPath. Consulte Configuração do Okta como seu provedor de identidade.
2. Habilite o SCIM no UiPath (etapa 1 abaixo).
3. Configure o SCIM no Okta (as etapas restantes).

Mapeamento de Atributos

Os seguintes atributos de usuário são sincronizados do seu provedor de identidade para a UiPath. O atributo SCIM é o valor enviado pelo Okta; o atributo UiPath é onde ele é armazenado.

Atributo SCIM	Atributo da UiPath	Required
externalId	Identificador do diretório usado para corresponder e vincular o usuário	Sim
userName	Username	Sim
displayName	Nome de exibição	Sim
active	Status do usuário (habilitado ou desabilitado)
emails[type eq "work"].value	Email
name.givenName	Nome
name.familyName	Sobrenome
title	Cargo
addresses[type eq "work"].locality	Cidade
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department	Department
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization	Nome da Empresa

O Okta preenche externalId automaticamente, então você não precisa mapeá-lo manualmente.

Como displayName é obrigatório, o provisionamento falha para usuários cujo perfil do Okta tem um nome de exibição vazio. Para evitar isso, mapeie o atributo Nome de exibição no Okta para uma expressão que forneça uma alternativa, por exemplo, user.displayName != null ? user.displayName : user.firstName + " " + user.lastName.

Etapa 1: habilitar o SCIM no UiPath

1. Faça login em cloud.uipath.com usando uma conta com permissões de administrador da organização.

2. No menu à esquerda, selecione Admin e, em seguida, selecione Segurança.

3. Em Integração de diretório e logon único (SSO), selecione Habilitar SCIM.

4. Selecione um dos seguintes métodos de autorização compatíveis com o Okta:

   • OAuth2 authorization code grant
   • Concessão de credenciais do cliente do OAuth
   • Token de portador de longa duração

5. Se você selecionou a concessão de código de autorização OAuth2, insira o URL de redirecionamento (o retorno de chamada OAuth do seu provedor de identidade). Use o URL de retorno de chamada da documentação de provisionamento de SCIM do Okta, pois o valor exato depende de seu ambiente e aplicativo Okta.

6. Selecione Configurar.

7. Registre os seguintes valores — você precisará deles ao configurar o Okta. Copie-os exatamente conforme mostrado no UiPath em vez de construí-los manualmente:

   • URL do SCIM (por exemplo, https://cloud.uipath.com/{orgId}/identity_/api/scim/v2)
   • If using either OAuth grant: OAuth application ID and OAuth secret
   • Se estiver usando um token de portador de longa duração: valor do token de portador

8. If using either OAuth grant, construct the endpoint URIs. UiPath does not display them. {orgId} is the org id that appears in your SCIM URL, and {organizationName} is your organization name:

   • Access token endpoint URI: https://cloud.uipath.com/{orgId}/identity_/connect/token
   • Authorization endpoint URI (authorization code grant only): https://cloud.uipath.com/{organizationName}/identity_/connect/authorize?scope=PM.Scim%20offline_access&acr_values=tenantName:{organizationName}
   Observação:

   The offline_access scope is required for the OAuth2 authorization code grant. Without it, UiPath does not return a refresh token, and provisioning stops when the access token expires after one hour. The refresh token expires after 60 days, after which you must reauthorize the connection in Okta.

Observação:

Deixe esta guia do navegador aberta. Não selecione Concluí a configuração do provedor de identidade até finalizar as etapas nas seções a seguir.

Etapa 2: configurar o SCIM no Okta

1. Faça login no Portal de administração do Okta usando uma conta com permissões de administrador.
2. Navegue até Aplicativos e selecione o aplicativo Okta usado para configurar SAML com o UiPath.
3. Habilite o provisionamento do SCIM:
   1. Na guia Geral , selecione Editar em Configurações do aplicativo.
   2. Em Provisionamento, selecione SCIM.
   3. Selecione Salvar.
4. Configure a conexão do SCIM:

   1. Na guia Provisionamento , selecione Editar em Integração.

   2. Defina os seguintes campos:

      Campo	Valor
      URL base do conector do SCIM	URL do SCIM da etapa 1
      Campo de identificador exclusivo para usuários	userName

   3. Em Ações de provisionamento compatíveis, selecione:

      • Enviar novos usuários
      • Enviar atualizações de perfil

      Não há suporte para correspondência baseada em importação. Os usuários são sincronizados com a UiPath apenas por meio de provisionamento por push.

   4. Defina o modo de autenticação:

      OAuth 2 with authorization code

      Set Grant Type to Authorization Code, then complete the fields:

      Campo	Valor
      URI do ponto de extremidade de autorização	URI do ponto de extremidade de autorização da etapa 1
      URI do ponto de extremidade do token de acesso	URI do ponto de extremidade do token de acesso da etapa 1
      ID do Cliente	OAuth application ID from Step 1
      Segredo do Cliente	OAuth secret from Step 1

      OAuth 2 with client credentials

      Set Grant Type to Client Credentials, then complete the fields:

      Campo	Valor
      URI do ponto de extremidade do token de acesso	URI do ponto de extremidade do token de acesso da etapa 1
      ID do Cliente	OAuth application ID from Step 1
      Segredo do Cliente	OAuth secret from Step 1

      Cabeçalho HTTP (token de portador)

      Campo	Valor
      Autorização	Valor do token de portador da etapa 1

   5. Selecione Testar configuração do conector.

   6. Verifique se o teste de conexão foi bem-sucedido.

   7. Selecione Salvar.

5. Habilitar funcionalidades de provisionamento:
   1. Na guia Provisionamento , selecione Para aplicativo.
   2. Habilite as seguintes opções:
      • Criar usuários
      • Atualizar atributos de usuários
      • Desativar usuários
   3. Selecione Salvar.

Etapa 3: conclusão da configuração no UiPath

Retorne à guia do navegador UiPath da Etapa 1 e selecione Concluí a configuração do provedor de identidade.

Resultado

A sincronização de usuário do SCIM agora está ativa entre o Okta e sua organização UiPath. Os usuários atribuídos ao aplicativo no Okta serão provisionados para a UiPath automaticamente, e as atualizações subsequentes ou eventos de desprovisionamento no seu diretório serão enviados para a UiPath de forma assíncrona.

Para verificar a configuração, navegue até Admin > Segurança no UiPath e confirme se o status do SCIM é exibido como habilitado. Você também pode navegar até Administrador > Contas e grupos e confirmar se os usuários provisionados aparecem no diretório.