Guia de conexão OAuth com credenciais de cliente Salesforce para Jitterbit App Builder

Pré-requisitos

• Você deve ter uma conta Salesforce com pelo menos 1 licença de usuário ativa do Salesforce.

Configuração no Salesforce

Criar um perfil de integração para usuário somente API

1. No Salesforce, navegue até Configuração ou Definições, e vá para a página de Perfis. Isso está localizado no menu suspenso Administração no lado esquerdo da página.

   

2. Clique no botão Novo Perfil.

   

3. Você verá um prompt para clonar um Perfil Existente, escolha "Administrador do Sistema" que possui uma licença de usuário do Salesforce. Forneça um Nome de Perfil identificável.

   

4. Clique em Salvar.

5. Uma vez que o perfil foi criado, você verá uma página exibindo os detalhes do perfil. Clique no botão "Editar".

   

6. Role para baixo ou pesquise na página por "Usuário Somente API" para localizar a caixa de seleção de permissão na seção de Permissões Administrativas da página. Confirme que Usuário Somente API está marcado.

   

Criar um usuário de integração

1. Agora que o perfil de Integração está disponível, você criará o Usuário de Integração. Em Configuração, vá para a página "Usuários". Esta opção está localizada no menu suspenso Administração no lado esquerdo da página.

   

2. Clique no botão "Novo Usuário".

   

3. Preencha os seguintes campos:

   • Primeiro Nome – O nome do sistema que está integrando com o Salesforce.
   • Último Nome – "Integração". Recomenda-se que o primeiro e o último nome sejam compostos pelo nome do sistema e pela palavra "integração" para que seja fácil identificar a finalidade do usuário.
   • Email – Idealmente, este é um email de distribuição para que uma equipe possa monitorá-lo.
   • Licença do Usuário – Normalmente "Salesforce", mas use a correta para o perfil escolhido.
   • Perfil – O que foi criado na etapa anterior, em nosso exemplo intitulado "Integração do App Builder"

4. Clique em Salvar. Agora que o Usuário foi criado, o aplicativo conectado pode ser criado a seguir.

Criar um aplicativo OAuth personalizado

1. Faça login no Salesforce.com ou no seu ambiente sandbox do Salesforce.
2. Na página inicial, vá para Ferramentas de Plataforma > Aplicativos > Gerenciador de Aplicativos

3. Clique no botão Novo Aplicativo Conectado e insira o seguinte:

   • Nome do Aplicativo Conectado - O nome deve conter o nome do sistema e da integração, como "Integração do App Builder" para fácil identificação, mas isso pode ser o que você desejar.
   • Nome da API - Deixe o Salesforce preencher isso com base no nome do Aplicativo Conectado.
   • Email de Contato - Qualquer email que você desejar
   • Ativar Configurações de OAuth - Marque esta caixa de seleção, então as seguintes configurações aparecerão

   • URL de Retorno - Este será o URL de login com o provedor de segurança que usaremos para esta conexão. Deve terminar com "signin-SecurityProvider", por exemplo.

     

   • Escopos OAuth Selecionados - Escolha "Gerenciar dados do usuário via APIs (api)", "Acesso total (full)" e "Realizar solicitações a qualquer momento (refresh_token, offline_access)"

   • Habilitar Fluxo de Credenciais do Cliente - Certifique-se de que esta caixa de seleção esteja marcada ou habilitada.

4. Clique em Salvar e depois clique em Continuar.

5. Agora o aplicativo conectado foi criado, mas precisamos navegar para outra página para configurar o usuário em execução. Na página principal do aplicativo, clique no botão "Gerenciar".
6. Clique em "Editar Políticas", role para baixo e, na seção intitulada "Fluxo de Credenciais do Cliente", clique no botão ampulheta. Aqui, escolha o Usuário de Integração que criamos anteriormente.
7. Clique em Salvar. Em seguida, precisamos recuperar o ID do Cliente e o Segredo do Cliente para o aplicativo que acabamos de criar.
8. Na página principal do aplicativo conectado, clique no botão "Gerenciar detalhes do Consumidor". Isso deve abrir uma nova página após completar um prompt de segurança, contendo o ID do Cliente e o Segredo do Cliente. Anote essas informações, pois serão necessárias mais tarde.
9. Isso completa a seção de configuração do Salesforce.

Configuração no App Builder

Criar um provedor de segurança OAuth no App Builder

1. No App Builder, navegue até a seção "Provedores de Segurança" do IDE.
2. Clique no botão + Autenticação de Fonte de Dados.

3. Forneça os seguintes detalhes:

   • Nome - Identifica o Provedor de Segurança e aparece na URL. Exemplo: Salesforce
   • Tipo - OAuth
   • Tipo de Autenticação - OAuth
   • Concessão OAuth - Credenciais do Cliente
   • Autenticação do Cliente OAuth - Básica
   • Autenticação de Recurso OAuth - Bearer
   • Proprietário do Token - Cliente
   • Redirecionar em Desafio - Verdadeiro

4. Clique em + Endpoints e configure os seguintes 3 endpoints. A URL precisa corresponder à instância do Salesforce sandbox ou produção à qual estamos nos conectando:

   • Endpoint de Autorização - https://{{SalesforceInstanceURL}}/services/oauth2/authorize
   • Endpoint de Token - https://{{SalesforceInstanceURL}}/services/oauth2/token
   • Endpoint de Informações do Usuário - https://{{SalesforceInstanceURL}}/services/oauth2/userinfo

5. Clique em + Credencial e configure o seguinte:

   • Tipo - Cliente
   • Nome de Usuário - ID do Cliente do Salesforce
   • Senha - Segredo do Salesforce

6. Isso completa a configuração do provedor de segurança no App Builder

Crie a fonte de dados Salesforce ADO.NET no App Builder

1. Vá para o IDE do App Builder e clique em Servidores de Dados.
2. Clique no botão + Servidor para adicionar uma nova fonte de dados.
3. Atribua um Nome ao Servidor.
4. Defina o Tipo como Salesforce ADO.NET

5. Expanda as Configurações de Segurança e defina o Provedor de Segurança como aquele que criamos anteriormente. Por exemplo: SalesforceCC.

   

6. Por fim, precisamos definir a URL do servidor OAuth. Fazemos isso clicando no botão Configurações Avançadas no servidor de dados após sua criação.

   

7. Aqui podemos configurar a URL do servidor OAuth. Isso deve ser configurado para a URL da sua instância do Salesforce, seguida de services/Soap/c/55.0.

   • Por exemplo: url do servidor oauth = https://{{SalesforceInstance}}/services/Soap/c/55.0

8. Expanda Teste e clique no botão Testar Conexão para garantir que a configuração está funcionando conforme o esperado.