Configurar uma organização do Salesforce

Esta página descreve como configurar uma instância do Salesforce para uso com o Datastream.

Antes de começar

Antes de começar a configurar o Salesforce para uso com o Datastream, é necessário:

  • Ter acesso a uma organização ativa do Salesforce
  • Saber como navegar e mudar as configurações no Salesforce
  • Saber como criar usuários e perfis no Salesforce

Configurar uma organização do Salesforce para uso com o Datastream

Para estabelecer uma conexão entre sua organização do Salesforce e o Datastream, é necessário fazer a autenticação usando um nome de usuário e uma senha ou o fluxo de credenciais de cliente do OAuth 2.0. Para usar o último, crie um app conectado do Salesforce ou um app cliente externo.

Se a sua organização do Salesforce estiver configurada para permitir acesso de endereços IP específicos, verifique se o Salesforce aceita endereços IP do Datastream. Para saber como gerenciar as restrições de acesso à rede, consulte Acesso à rede e restrições de IP com base no perfil e Definir intervalos de IP confiáveis para sua organização na documentação do Salesforce.

Configurar um usuário

  1. No Salesforce, crie um usuário ou ajuste as configurações de um usuário já criado de acordo com as instruções a seguir.
  2. Crie um perfil dedicado e atribua ao usuário.
  3. Se a organização tiver restrições de endereço IP configuradas, adicione os endereços IP do Datastream à lista de endereços IP permitidos. Para mais informações, consulte Restringir endereços IP de login nos perfis.
  4. Verifique se o perfil do usuário tem a permissão API Enabled para que ele possa usar a API REST do Salesforce e a API Bulk 2.0.
  5. Confirme se o perfil de usuário tem as permissões para ler todos os objetos e campos que você quer incluir no fluxo. Por motivos de segurança, conceda permissões de somente leitura ao usuário. Para mais informações, consulte Controlar quem pode acessar partes da documentação na documentação do Salesforce.
  6. Opcional: por padrão, o Salesforce retorna campos criptografados como campos mascarados. Se você precisar que o usuário visualize os valores reais dos campos criptografados, conceda a permissão View Encrypted Data. Você pode conceder a permissão editando o conjunto de permissões do usuário.

Opcional: crie e configure um app conectado

O Salesforce usa apps conectados para integrar aplicativos externos à API Salesforce, integrar provedores de serviços à sua organização do Salesforce ou controlar os dados que um aplicativo externo pode acessar da sua organização do Salesforce. Se você preferir usar um app conectado para autenticar sua instância do Salesforce no Datastream, siga estas etapas:

  1. Crie um app conectado. Para mais informações, consulte a documentação do Salesforce.

  2. Configure o app conectado para o fluxo de credenciais do cliente OAuth 2.0.

  3. Confira se o app conectado tem o escopo Manage user data via APIs (api) ativado. Para mais informações sobre escopos, consulte Tokens e escopos do OAuth.

  4. Verifique se o app conectado pode acessar as APIs do Salesforce com os endereços IP do Datastream. Para mais informações, consulte Restringir o acesso a APIs com apps conectados e Configurar intervalos de IP confiáveis para um app conectado.

  5. Receber a chave do cliente e o Secret do consumidor:

    1. No Salesforce, insira App na caixa de pesquisa rápida e selecione App Manager.
    2. Encontre o app conectado na lista e abra o menu suspenso à direita da linha.
    3. Selecione Visualizar.
    4. Na página de detalhes Gerenciar apps conectados, clique em Gerenciar detalhes do consumidor.
    5. Uma tela aparece solicitando um código de verificação. Um e-mail com o código de verificação é enviado para o usuário a quem você atribuiu o fluxo de credenciais do cliente.
    6. Digite o código de verificação. Você vai voltar para a página de detalhes do consumidor, onde estão sua chave e seu secret. É preciso informar a chave e o secret do consumidor ao criar o perfil de conexão.

A seguir