Guia de conexão OAuth com credenciais do cliente Salesforce para o 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

Crie um perfil de integração somente para usuários de API

1. No Salesforce, navegue até Configuração e acesse a página Perfis. Ela está localizada 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. Após a criação do perfil, 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 da API *" para localizar a caixa de seleção de permissão na seção *Permissões Administrativas da página. Confirme se Usuário Somente da 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, acesse a página "Usuários". Ela 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:

   • Nome - Nome do sistema que está sendo integrado ao Salesforce.
   • Sobrenome - "Integração". Recomenda-se que o nome e o sobrenome sejam compostos pelo nome do sistema e pela palavra "integração" para que seja possível identificar facilmente o que o usuário deseja.
   • Email - O ideal é que este seja um email de distribuição para que uma equipe possa monitorá-lo.
   • Licença de Usuário - Normalmente "Salesforce", mas use a correta para o perfil escolhido.
   • Perfil - O 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 em seguida.

Crie um aplicativo OAuth personalizado

1. Faça login no Salesforce .com ou no seu ambiente sandbox do Salesforce
2. Na página inicial, acesse Ferramentas da plataforma > Aplicativos > Gerenciador de aplicativos

3. Clique no botão Novo aplicativo conectado e digite 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 identificá-lo facilmente, mas 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
   • Habilitar configurações do OAuth - Marque esta caixa de seleção e as seguintes configurações aparecerão

   • URL de retorno de chamada - Esta será a 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 por meio de APIs (api)", "Acesso total (full)" e "Executar 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 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 a tela 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". Uma nova página deverá ser aberta após a conclusão de um prompt de segurança, contendo o ID do cliente e o Segredo do cliente. Anote essas informações, pois serão necessárias posteriormente.
9. Isso conclui a seção de configuração do Salesforce.

Configuração no App Builder

Crie 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 da 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 de cliente OAuth - Básica
   • Autenticação de Recurso OAuth - Portador
   • Proprietário do Token - Cliente
   • Redirecionamento no Desafio - Verdadeiro

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

   • Endpoint de autorização - https://{{URL da instância do Salesforce}}/services/oauth2/authorize
   • Endpoint do token - https://{{URL da instância do Salesforce}}/services/oauth2/token
   • Endpoint de informações do usuário - https://{{URL da instância do Salesforce}}/services/oauth2/userinfo

5. Clique em + Credencial e configure o seguinte:

   • Tipo - Cliente
   • Nome de usuário - ID do cliente do Salesorce
   • Senha - Segredo do Salesforce

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

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

1. Acesse o App Builder IDE e clique em Servidores de Dados.
2. Clique no botão + Servidor para adicionar uma nova fonte de dados.
3. Atribua um Nome de 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 o 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. Ela deve ser configurada para a URL da sua instância do Salesforce, seguida por services/Soap/c/55.0.

   • Por exemplo: url do servidor oauth = https://{{Instância do Salesforce}}/services/Soap/c/55.0

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