Autenticação do Salesforce

Edições Compatíveis

Para se autenticar no Salesforce, você deve ter uma edição que inclua suporte para API. O conector Salesforce funciona com a seguinte edição (não limitada a):

• Salesforce Sales Cloud (Enterprise ou Professional com suporte de API)

Para todas as outras edições não listadas, entre em contato com seu representante da UiPath para obter assistência.

Observação:

O conector usa a API REST da Salesforce. Confirme se sua edição do Salesforce inclui acesso à API antes de prosseguir.

Pré-requisitos

Para criar uma conexão, você precisa das seguintes credenciais:

• Código de autorização do OAuth 2.0: nome de usuário e senha.
• Senha OAuth 2.0: nome de usuário, senha, token de segurança.
• Traga seu próprio aplicativo OAuth 2.0: ID do cliente, Segredo do cliente.
• Token de acesso pessoal (PAT): chave codificada em base64 do JWT, Público, Emissor, Assunto.

Além disso, você pode precisar de um aplicativo autenticador instalado em seu telefone celular se sua organização do Salesforce exigir autenticação multifator (MFA).

Antes de criar uma conexão, certifique-se também do seguinte:

1. Você tem uma edição Enterprise do Salesforce Sales Cloud, edição Professional com suporte a API ou outra edição compatível listada acima.
2. Você tem privilégios de Administrador no Salesforce Sales Cloud para configurar aplicativos. Entre em contato com o administrador do seu sistema se você não tiver esses privilégios.
3. A permissão API habilitada é ativada para seu perfil de usuário do Salesforce. Para verificar: abra o Salesforce e vá para Configuração > Administração > Usuários > Perfis, selecione o perfil relevante e confirme se a opção API Habilitada está marcada.

Dica:

• Como verificar seu perfil atribuído: clique no avatar do seu perfil no canto superior direito do Salesforce e clique em Configurações > Detalhes do usuário avançados. Seu nome de perfil está listado no campo Perfil . Alternativamente, vá para Configuração > Administração > Usuários > Usuários e verifique a coluna Perfil para seu nome de usuário.
• Recomendamos provisionar e atribuir um usuário de integração dedicado do Salesforce para conexões da UiPath. As conexões herdam as permissões da conta usada para autenticação, incluindo acesso a campos e objetos. Usar um usuário dedicado garante acesso consistente e auditável.

Métodos de autenticação do SQL

O conector UiPath Salesforce é compatível com os seguintes métodos de autenticação. As credenciais necessárias dependem do método que você escolher:

Método de autenticação	Description	Credenciais necessárias
Código de autorização do OAuth 2.0	Redireciona para o Salesforce para login e permissão.	Nome de usuário e senha do Salesforce
Senha do OAuth 2.0	Autenticação legada para contas/apps do Salesforce mais antigos. Bloqueado por padrão para novas organizações de acordo com as notas de versão do Salesforce. Use apenas para cenários especiais.	Nome de usuário, senha, token de segurança
Portador do JWT (PAT)	Autenticação de servidor a servidor baseada em Token da Web JSON usando um certificado digital. Ideal para automações unattended em que não é possível fazer o logon interativo.	Chave privada codificada JWT base64, Público, Emissor (ID do cliente), Assunto (nome de usuário)
Traga seu próprio aplicativo (BYOA)	Usa um aplicativo privado que você cria no Salesforce. Recomendado pela UiPath, pois oferece a você controle total sobre escopos, políticas e marca.	ID do cliente, Segredo do cliente (de seu Aplicativo Cliente externo da Salesforce)

Para saber mais sobre os diferentes tipos de autenticação disponíveis para a Salesforce, consulte a documentação oficial da Salesforce em Criar um aplicativo cliente externo.

Código de autorização do OAuth 2.0

Esse método usa o aplicativo público conectado à UiPath e redireciona você para o Salesforce para autenticação. Siga estas etapas:

1. Selecione Orchestrator no inicializador de produtos da UiPath.
2. Selecione uma pasta e navegue até a aba Conexões .
3. Selecione Adicionar conexão.
4. Procure e selecione o conector do Salesforce na lista.
5. Selecione o ambiente: Produção ou Sandbox.
6. Selecione Código de autorização do OAuth 2.0 como o método de autenticação.
7. Selecione Conectar. Você será redirecionado para a página de logon do Salesforce.
8. Digite seu nome de usuário e senha do Salesforce.
9. Se solicitado pelo MFA, insira o código de verificação do seu aplicativo autenticador.
10. Revise as permissões solicitadas pela UiPath e clique em Permitir.
11. Você será redirecionado de volta para o Orchestrator. O status da conexão será exibido como Conectado.

Domínio personalizado: se sua organização do Salesforce usa um domínio personalizado, clique em Usar domínio personalizado na tela de login do Salesforce, insira sua URL de domínio personalizado (por exemplo, suaempresa.minha.salesforce.com), em seguida, clique em Continuar e insira suas credenciais.

Observação:

Esse método usa o aplicativo UiPath Connected público. Se você encontrar um erro OAUTH_APPROVAL_ERROR_GENERIC , consulte a seção Solução de problemas .

Senha do OAuth 2.0 (legado)

AVISO:

Este método de autenticação é bloqueado por padrão para novas organizações do Salesforce. A Salesforce descontinua o fluxo OAuth NomeDeUsuário-Senha para a maioria dos casos de uso. Use esse método apenas se sua organização o exigir explicitamente para compatibilidade com versões anteriores.

Se você precisar usar esse método, primeiro habilite-o seguindo a documentação do Salesforce: Fluxo de nome de usuário do OAuth 2.0 para cenários especiais. Então:

1. Siga as etapas 1 a 5 das instruções do Código de autorização do OAuth 2.0 acima.
2. Selecione Senha do OAuth 2.0 como o método de autenticação.
3. Insira seu nome de usuário, senha e token de segurança do Salesforce.
4. Select Connect.

Como obter seu token de segurança: no Salesforce, acesse suas configurações de perfil > Redefinir meu token de segurança. O token é enviado para seu e-mail. Anexe-o à sua senha ao se conectar.

Autenticação do Portador do JWT (PAT)

A autenticação do portador do JWT usa um certificado digital para assinar uma solicitação JWT, permitindo a integração de servidor para servidor sem logon interativo. Isso é ideal para automações não assistidas. Siga estas etapas:

1. Crie uma chave privada e um certificado digital autoassinado. Consulte o guia do Salesforce: Criar uma chave privada e um certificado digital autoassinado.
2. Crie um Aplicativo Cliente Externo no Salesforce. Acesse Configuração > Apps > Apps cliente externo > App Manager do cliente externo e clique em Novo aplicativo cliente externo. Carregue seu certificado digital na configuração do aplicativo. (Consulte a seção BYOA / Configuração do Aplicativo do Cliente Externo abaixo para obter etapas detalhadas.)
3. Configure o fluxo de Portador do JWT. Nas configurações do Aplicativo Cliente externo, habilite o fluxo Portador de JWT em Habilitação de fluxo. Atribua os escopos do OAuth necessários.
4. Pré-autorize o aplicativo para seu usuário de integração. Vá para Configuração > Apps conectados > Gerenciar apps conectados, encontre seu aplicativo e, em Políticas, defina Usuários permitidos como "Usuários aprovados pelo administrador são pré-autorizados." Em seguida, adicione o perfil ou o conjunto de permissões relevante.
5. No UiPath Orchestrator, selecione Orchestrator > pasta > Conexões > Adicionar conexão > Salesforce.
6. Selecione o ambiente (Production ou Sandbox).
7. Selecione Token de acesso pessoal (PAT) como o método de autenticação.
8. Insira as credenciais necessárias:
   • Chave codificada JWT base64: sua chave privada no formato base64.
   • Emissor: o ID do Cliente OAuth (Chave do Consumidor) do seu Aplicativo Cliente Externo.
   • Assunto: o nome de usuário do usuário do Salesforce com o qual você deseja se autenticar.
   • Público: o URL do endpoint do token do Salesforce (por exemplo, https://login.salesforce.com para produção ou https://test.salesforce.com para sandbox).
9. Select Connect.

Para obter mais detalhes sobre a habilitação de Tokens JWT, consulte a documentação do Salesforce: OAuth 2.0 JWT Bearer Flow for Server-to-Server Integration, Habilitar Tokens de acesso baseados em JSON Web Token (JWT) e Tokens de acesso baseados em JWT.

Traga seu próprio aplicativo (BYOA) (recomendado)

Importante:

A Salesforce descontinua o modelo legado de Aplicativo Conectado. Todos os novos aplicativos devem ser criados como External Client Apps. Os Apps Conectados existentes continuam a funcionar, mas a Salesforce recomenda a migração para os Apps Clientes Externos. As etapas abaixo refletem o novo fluxo de trabalho do aplicativo cliente externo.

Esse método usa um aplicativo privado que você cria e gerencia no Salesforce, dando a você controle total sobre escopos e políticas de segurança do OAuth. Siga estas etapas:

Etapa A: criar um aplicativo cliente externo no Salesforce

1. Faça login em sua conta do Salesforce e acesse Configuração.
2. Navegue até Apps > Aplicativos clientes externos > Gerenciador de aplicativos clientes externos.
3. Clique em Novo aplicativo cliente externo.
4. Preencha os campos obrigatórios:
   • Nome do aplicativo cliente externo: um nome descritivo (por exemplo, "Integração da UiPath").
   • Nome da API: deve conter apenas sublinhados e caracteres alfanuméricos, ser exclusivo, começar com uma letra e não terminar com um sublinhado ou conter sublinhados consecutivos.
   • E-mail de contato: o endereço de e-mail do proprietário do aplicativo.
   • Estado de distribuição: selecione Local (para uso de uma organização única) ou Pacote.
5. Expanda a seção API (Habilitar configurações do OAuth) e marque Habilitar o OAuth.
6. No campo URL de retorno de chamada , insira a URL de retorno de chamada do UiPath OAuth fornecida em sua tela de configuração de conexão do Orchestrator.
7. Selecione os Escopos de OAuth necessários e mova-os para Escopos de OAuth selecionados. No mínimo, inclua: Acessar o serviço de URLs de identidade, Gerenciar dados do usuário por meio de APIs e Executar solicitações a qualquer momento.
8. Em Habilitação de fluxo, selecione Habilitar código de autorização e fluxo de credenciais.
9. Em Segurança, marque Exigir segredo para Fluxo do Web Server e Exigir segredo para Fluxo de token de atualização.
10. Clique em Criar.

Etapa A.1: configurar políticas (obrigatória)

Após criar o aplicativo cliente externo, você deve configurar suas políticas:

1. Vá para Configuração > Apps conectados > Gerenciar Apps conectados.
2. Encontre seu Aplicativo Cliente externo e clique em Editar políticas.
3. Defina o seguinte:
   • Usuários permitidos: "Todos os usuários podem se autoautorizar"
   • Flexão de IP: "Relaxar restrições de IP"
   • Política de token de atualização: "o token de atualização é válido até ser revogado"
4. Clique em Salvar.

Etapa B: recuperar o ID do cliente e o segredo do cliente

1. No aplicativo cliente externo, acesse a guia Configurações .
2. Expanda Configurações do OAuth.
3. Clique em Chave e segredo do consumidor.
4. Insira suas credenciais (e OTP, se solicitado).
5. Copie a Chave do consumidor (esta é sua ID do cliente) e Segredo do Consumidor (este é seu Segredo do Cliente). Armazene-os com segurança.

Observação:

Após criar ou modificar um Aplicativo Cliente Externo, o Salesforce pode levar até 10 minutos para propagar as alterações. Aguarde antes de tentar se conectar.

Etapa C: conectar-se no UiPath Orchestrator

1. No Orchestrator, acesse sua pasta > Conexões > Adicionar conexão > Salesforce.
2. Selecione o ambiente (Production ou Sandbox).
3. Selecione Traga seu próprio aplicativo OAuth 2.0 como o método de autenticação.
4. Insira a ID do cliente e o Segredo do cliente da Etapa B.
5. Select Connect.
6. Conclua o login do Salesforce e autorize o aplicativo.

Para obter mais detalhes, consulte a documentação do Salesforce: Definir as configurações OAuth do aplicativo cliente externo e habilitar as configurações OAuth para a integração da API.

Expiração e atualização do token

Os tokens do OAuth podem expirar após uma quantidade de tempo definida, dependendo da sua configuração do Salesforce. Para evitar desconexões inesperadas em fluxos de trabalho de produção:

• Defina a Política de token de atualização como "O token de atualização é válido até que seja revogado" nas configurações do Aplicativo Conectado do Salesforce ou do Aplicativo Cliente Externo.
• Certifique-se de que o escopo "Executar solicitações a qualquer momento" seja concedido. Este escopo permite a atualização offline e não está incluído no escopo de "acesso total" — ele deve ser configurado de forma independente.

Consulte os guias do Salesforce: Gerenciar políticas de acesso OAuth para um aplicativo conectado e Tokens e escopos OAuth para obter etapas detalhadas de configuração.

Configuração do sandbox

Para configurar uma conta do Sandbox, siga as etapas descritas na documentação oficial do Salesforce: Considerações de configuração do Sandbox.

Os sandboxes do Salesforce estão isolados da sua organização de produção. As operações executadas em um sandbox não afetam os dados de produção e vice-versa. Os sandboxes são quase idênticos à produção, mas existem algumas diferenças — consulte a documentação do Salesforce para obter detalhes.

Dica:

Ao começar a usar a UiPath com o Salesforce, recomendamos testar em uma conta de sandbox ou com dados não essenciais. Isso impede qualquer perda de dados cruciais, especialmente porque as ações executadas por meio de automações podem não ser desfeitas facilmente.

Permissões

As conexões do Salesforce no UiPath herdam as permissões da conta usada para autenticação. Abaixo está um guia abrangente para as permissões necessárias.

Escopos do OAuth obrigatórios (aplicativo da UiPath público)

Ao criar uma conexão por meio do aplicativo UiPath público, o conector solicita as seguintes permissões:

Permissão / Escopo	Finalidade
Acesse o serviço de URL de identidade	Recuperar informações de identidade do usuário
Gerencie os dados do usuário por meio de APIs	Ler e gravar registros do Salesforce por meio da API
Gerencia os dados do usuário por meio de navegadores da web	Acesso a dados baseado em navegador
Acesse os recursos da API REST do Marketplace	Acesso à API do Habilitar e Conectar
Acesse aplicativos do Visualforce	Interagir com páginas do Visualforce
Acessar identificadores exclusivos de usuário	Acesso ao ID do usuário exclusivo para mapeamento
Acessar permissões personalizadas	Ler atribuições de permissão personalizadas
Acessar recursos da API REST de análise	Relatórios e painéis por meio da API
Acesso a recursos de gráfico de gráfico da API REST da Análise	Dados geográficos no análise
Gerenciar conexões de hub	Gerenciamento de conexões de hub
Gerenciar serviços do Pardot	Acesso à automação de marketing do Pardot
Acessar aplicativos Lighting	Acesso ao Lighting Experience
Acessar recursos de conteúdo	Acesso à biblioteca de conteúdo
Gerenciar dados da API de ingestão do Salesforce CDP	Ingestão de dados do CDP
Gerenciar dados do perfil do Salesforce CDP	Gerenciamento de perfil do CDP
Executar consultas SQL ANSI em dados do Salesforce CDP	Consulta de dados do CDP
Acessar serviços do chatbot	Serviços de robôs do Einstein
Executar solicitações a qualquer momento	Acesso ao token de atualização offline
Realize a segmentação nos dados do Salesforce CDP	Segmentação de CDP

Permissão habilitada para API

Você deve ter a permissão API habilitada no Salesforce. Para configurar: acesse Configuração > Administração > Usuários > Perfis, selecione o perfil relevante e certifique-se de que API Habilitada esteja marcada em Permissões administrativas.

Permissões de objeto padrão e personalizadas

Recomendamos que a conta do usuário conectado tenha permissões para ler, gravar, editar, excluir, visualizar todos e modificar todos os objetos padrão ou personalizados com os quais suas automações interagem. Para configurar:

• Acesse Configuração > Administração > Usuários > Perfis (ou Conjuntos de permissões).
• Localize os objetos padrão ou personalizados relevantes e atribua as permissões necessárias.
• A segurança no nível do objeto é a maneira mais ampla de controlar o acesso aos dados. Ele configura a capacidade de um usuário visualizar, criar, editar ou excluir registros de um tipo de objeto específico (por exemplo, Leads, Oportunidades). Se um objeto estiver oculto do usuário de integração, ele não aparecerá na UiPath.

Observação:

Se os objetos esperados do Salesforce não estiverem aparecendo no UiPath, consulte seu administrador do Salesforce para confirmar se o usuário da integração tem acesso a todos os objetos necessários.

Segurança no nível do campo

A segurança no nível do campo controla a visibilidade de campos individuais dentro de objetos, incluindo em listas relacionadas, exibições de lista, relatórios e resultados de pesquisas. Ele também determina se os usuários podem exibir ou editar os valores dos campos. Isso permite que você proteja dados confidenciais sem ocultar objetos inteiros.

Configure a segurança no nível do campo por meio de perfis ou conjuntos de permissões no Salesforce. Se os campos esperados não estiverem aparecendo no UiPath, consulte seu administrador do Salesforce para confirmar que o usuário de integração tem acesso aos campos necessários.

Perfis e conjuntos de permissões

As permissões de usuário e as configurações de acesso controlam o que os usuários podem fazer em sua organização do Salesforce:

• Perfis: defina as permissões de linha de base para um grupo de usuários. Cada usuário recebe um perfil. Use perfis para atribuir as permissões mínimas necessárias.
• Conjuntos de permissões: adicione permissões adicionais no alto de um perfil. Um usuário pode ter vários conjuntos de permissões. Use-os para criar acesso extra em camadas conforme necessário para integrações.

Solução de problemas

Erro/Sintama	Resolution
OAUTH_APProVAL_ERROR_GenERIC	O Salesforce está bloqueando o aplicativo UiPath porque ele não está instalado. Isso se aplica apenas ao aplicativo UiPath conectado público (não aos aplicativos clientes externos BYOA, que são seguros por padrão e isentos dessa restrição). Para resolver: Instalar o aplicativo: um administrador do Salesforce deve acessar Configuração > Uso do OAuth de Apps conectados, localizar o conector da UiPath e clicar em Instalar. Depois de instalado, configure as políticas do OAuth conforme necessário. Atribuir permissões de desvio: um administrador do Salesforce pode atribuir Aprovar Connected Apps desinstalados (disponível quando o Controle de acesso de API não estiver habilitado) ou Usar qualquer cliente de API (funciona quando o Controle de acesso de API estiver habilitado).
invalid_client_id / "identificador de cliente inválido"	A Chave do Consumidor (ID do Cliente) não foi reconhecida. Causas comuns: Atraso na propagação — depois de criar ou modificar um Aplicativo Cliente externo, aguarde até 10 minutos para que o Salesforce propagar as alterações. Chave do consumidor errada — copie-a novamente da guia Configurações do aplicativo cliente externo > Configurações do OAuth > Chave e segredo do consumidor. Incompatibilidade de sandbox/produção — certifique-se de que o ambiente selecionado no UiPath corresponda ao local em que o aplicativo foi criado (Sandbox usa test.salesforce.com, Produção usa login.salesforce.com).
desafio de código necessário ausente	O PKCE (Proof Key for Code Exchange) foi aplicado. Desabilite-o em dois lugares: Nível de organização: Configuração > Identidade > Configurações do OAuth e OpenID Connect — desative "Requerer Extensão de Chave de Prova de Chave para Code Exchange (PKCE) para Fluxos de Autorização Suportados". Nível do aplicativo: nas configurações do OAuth do aplicativo cliente externo, desmarque o requisito PKCE. A configuração em nível de organização substitui a configuração em nível de aplicativo — ambas devem estar desativadas. Após desabilitar, aguarde alguns minutos e limpe o cache do navegador antes de tentar novamente.
Falha ao trocar o código OAuth por token	O código de autorização foi emitido, mas a troca de tokens falhou. Causas comuns para Apps cliente externos: Incompatibilidade de URL de retorno de chamada — verifique se a URL em seu aplicativo cliente externo corresponde exatamente ao que a UiPath envia (verifique http vs https, barras à direita, maiúsculas/minúsculas). Segredo do cliente incorreto — copie novamente de Configurações > Configurações do OAuth > Chave e segredo do consumidor. Políticas não configuradas — acesse Configuração > Apps conectados > Gerenciar Apps conectados, encontre o aplicativo, clique em Editar políticas e defina Usuários permitidos como "Todos os usuários podem se autoautorizar", Flexão de IP como "Relaxar restrições de IP" e Política de token de atualização para "O token de atualização é válido até ser revogado." Limite de token — o Salesforce permite até 5 tokens simultâneos por usuário por aplicativo; revogue tokens antigos por meio de Configuração > Segurança > Gerenciamento de sessão.
A conexão é desconectada inesperadamente	O token de atualização pode ter expirado. Defina a Política de Token de Atualização como "O token de atualização é válido até ser revogado" e certifique-se de que o escopo "Executar solicitações a qualquer momento" seja concedido. Consulte a seção Expiração e atualização do token .
Objetos ou campos ausentes no UiPath	As configurações de segurança no nível do objeto ou no nível do campo estão impedindo a visibilidade. Consulte seu administrador do Salesforce para confirmar se o perfil do usuário da integração tem acesso de leitura/gravação aos objetos e campos necessários.
Erro de API Habilitada / privilégios insuficientes	O perfil do usuário conectado não possui a permissão API Habilitada. Acesse Configuração > Perfis, selecione o perfil e habilite-o em Permissões administrativas.
Prompt do MFA durante a conexão	Sua organização exige uma autenticação multifator. Use um aplicativo autenticador para concluir a etapa de verificação. Para cenários automatizados (não assistidos), considere usar a autenticação de titular do JWT, que não requer MFA interativo.
Domínio personalizado não reconhecido	Clique em "Usar domínio personalizado" na tela de logon do Salesforce, digite a URL do domínio personalizado completo (por exemplo, suaempresa.minha.salesforce.com) e clique em Continuar antes de inserir as credenciais.

Melhores práticas

• Use um usuário de integração dedicado. Crie um usuário dedicado do Salesforce para integrações da UiPath em vez de usar contas pessoais. Isso garante permissões consistentes, simplifica a auditoria e evita a interrupção quando usuários individuais mudam de função.
• Teste primeiro em um sandbox. Sempre teste novas conexões e automações em um ambiente de área restrita do Salesforce antes de implantar em produção. As ações executadas por meio da UiPath nem sempre podem ser desfeitas.
• Aplique permissões de privilégio mínimo. Conceda apenas o acesso a objeto e campo de que suas automações realmente precisam. Use perfis para acesso de linha base e conjuntos de permissão para escopos adicionais.
• Configure políticas de atualização de tokens. Defina a política do token de atualização como "válida até ser revogada" e conceda o escopo "Executar solicitações a qualquer momento" para evitar desconexões inesperadas.
• Use nomes de conexão significativos. Ao criar conexões no Orchestrator, use nomes descritivos que indiquem o ambiente e a finalidade (por exemplo, "Salesforce-Production-OrderSync") para facilitar o gerenciamento.
• Plano para a migração do aplicativo cliente externo do Salesforce. A Salesforce descontinua o modelo legado de Aplicativo Conectado. Todos os novos Apps devem ser criados como aplicativos cliente externos. Planeje migrar os Connected Apps existentes de acordo com a orientação do Salesforce.