Pré-requisitos de 2-legged OAuth 2.0 para conectores baseados em Salesforce no Jitterbit Studio

Introdução

Estes são os pré-requisitos para usar 2-legged OAuth 2.0 com os conectores Salesforce, Salesforce Einstein Analytics, Salesforce Events, Salesforce Service Cloud e ServiceMax. Você precisa da URL da sua instância Salesforce, de um ID de cliente e de um segredo de cliente para uma conexão bem-sucedida usando a autenticação 2-legged OAuth 2.0.

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 cliente externo

Use um aplicativo cliente externo, a menos que você já tenha um aplicativo Salesforce conectado existente configurado para esse fim. Para criar e configurar um aplicativo cliente externo Salesforce a fim de obter as credenciais do cliente necessárias, siga estas etapas:

1. Crie um aplicativo cliente externo.

   

2. Configure as configurações OAuth do aplicativo cliente externo

   • Defina a Callback URL como 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/authcode
     EMEA	https://apps.emea-west.jitterbit.com/design-studio/api/v1/oauth/authcode
     NA	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.

     

3. Configure as políticas de Client Credentials Flow do aplicativo cliente externo

   • Abra o aplicativo e selecione a guia Policies, depois clique em Edit.

   • Selecione Enable Client Credentials Flow.

   • Insira o nome de usuário do usuário Salesforce com o qual a conexão é executada (o usuário de execução). Qualquer pessoa com a chave do consumidor e o segredo do consumidor pode acessar sua organização em nome deste usuário. 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. Um escopo OAuth amplo não expande isso: o acesso é sempre limitado ao que o usuário de execução tem permissão de fazer no Salesforce.

• Clique em Save.

• Abra o aplicativo, selecione a aba Settings, expanda OAuth Settings e clique em Consumer Key and Secret. 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 do Salesforce.

  

Aplicativo conectado

Se você tiver um aplicativo conectado do Salesforce configurado anteriormente, confirme que ele está configurado para o fluxo de credenciais do cliente OAuth 2.0:

• Nas configurações de OAuth do aplicativo conectado, confirme se Enable Client Credentials Flow está selecionado.

• Na página de detalhes do aplicativo conectado, clique em Manage e depois em Edit Policies. Em Client Credentials Flow, confirme se um usuário está atribuído a Run As (para orgs da Enterprise Edition, o Salesforce recomenda um usuário com a permissão API Only User). As permissões do 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 do Studio. Políticas de 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 do Salesforce.

Navegue até o aplicativo 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 do Salesforce.

Próximas etapas

Use a URL da instância, o ID do cliente e o segredo do cliente para configurar uma conexão do Salesforce usando autenticação OAuth 2.0 de duas etapas.