Pré-requisitos do OAuth 2.0 de 2 pernas para o conector Salesforce no Jitterbit Studio
Introdução
Estes são os pré-requisitos para usar OAuth 2.0 de 2 pernas com os conectores Salesforce, Salesforce Service Cloud e ServiceMax. Você precisa da URL da sua instância Salesforce, de um ID de cliente e de um segredo do cliente para uma conexão bem-sucedida usando autenticação OAuth 2.0 de 2 pernas.
Nota
A versão do Agent 11.59 / 12.3 ou posterior é necessária para usar OAuth 2.0 de 2 pernas com o conector Salesforce.
A versão do Agent 11.59 (para agents 11.x) ou 12.4 ou posterior (para agents 12.x) é necessária para usar OAuth 2.0 de 2 pernas com os conectores Salesforce Service Cloud e ServiceMax.
URL da instância
A URL da sua instância Salesforce depende da configuração My Domain da sua organização:
- Se My Domain estiver ativado (padrão), sua URL de instância é
https://exampleDomain.my.salesforce.com. - Se My Domain estiver desativado, sua URL de instância é
https://exampleInstance.salesforce.com.
Aplicativo conectado
Importante
A partir de Spring 2026, Salesforce restringiu a criação de aplicativos conectados. Se você ainda não estiver usando um aplicativo conectado existente, use um aplicativo cliente externo em vez disso.
Se você tiver um aplicativo conectado Salesforce configurado anteriormente, confirme se ele está configurado para o fluxo de credenciais do cliente OAuth 2.0:
-
Nas configurações OAuth do aplicativo conectado, confirme se Enable Client Credentials Flow está selecionado.
-
Na página de detalhes do aplicativo conectado, clique em Manage, depois em Edit Policies. Em Client Credentials Flow, confirme se um usuário está atribuído a Run As (para orgs da Enterprise Edition, Salesforce recomenda um usuário com a permissão API Only User). As permissões Salesforce deste usuário determinam o que a conexão pode acessar, portanto, o usuário deve ter as permissões necessárias para as atividades usadas no seu projeto Studio. As políticas Permitted Users (por exemplo, Admin approved users are pre-authorized) não se aplicam a este usuário.
Para mais informações, consulte Configure a Connected App for the OAuth 2.0 Client Credentials Flow da Salesforce.
Navegue até o aplicativo e clique em Manage Consumer Details. Retenha os valores de Consumer Key e Consumer Secret para inserir como ID de cliente e segredo do cliente durante a configuração da conexão Salesforce.
Aplicativo cliente externo
Para criar e configurar um aplicativo cliente externo Salesforce a fim de obter as credenciais do cliente necessárias, siga estas etapas:
- Crie um aplicativo cliente externo.
-
Configure as configurações OAuth do aplicativo cliente externo
-
Defina a Callback URL para uma das seguintes URLs (dependendo da região da sua organização):
Região URL APAC https://apps.apac-southeast.jitterbit.com/design-studio/api/v1/oauth/authcodeEMEA https://apps.emea-west.jitterbit.com/design-studio/api/v1/oauth/authcodeNA https://apps.na-east.jitterbit.com/design-studio/api/v1/oauth/authcode
-
-
Em OAuth Scopes, selecione Manage user data via APIs (api). Considere escopos OAuth adicionais que sua implementação possa exigir. Por exemplo, Access the identity URL service (id, profile, email, address, phone).
- Selecione Enable Client Credentials Flow.
-
Configure as políticas de Client Credentials Flow do app cliente externo
-
Na lista de ações do app cliente externo, selecione Edit Policies.
-
Selecione Enable Client Credentials Flow.
-
Digite o nome de usuário do usuário Salesforce sob o qual a conexão é executada (o usuário de execução). As permissões Salesforce desse usuário determinam o que a conexão pode acessar, portanto o usuário deve ter as permissões necessárias para as atividades usadas no seu projeto Studio.
-
Clique em Save.
-
-
Navegue até as configurações OAuth do app e clique em Manage Consumer Details. Retenha os valores de Consumer Key e Consumer Secret para inserir como ID do cliente e segredo do cliente durante a configuração da conexão Salesforce.
Próximas etapas
Use a URL da instância, o ID do cliente e o segredo do cliente para configurar uma conexão Salesforce usando autenticação OAuth 2.0 de duas pernas.