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 do cliente 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 o 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 Restrições de IP baseadas em perfil e acesso à rede 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 existente conforme 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 em perfis.
  4. Verifique se o perfil do usuário tem a permissão API Enabled para que o usuário possa usar a API REST do Salesforce e a API Bulk 2.0.
  5. Verifique se o perfil do 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 leitura somente para o usuário. Para mais informações, consulte Controlar quem tem acesso a quê 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: criar e configurar um app conectado

O Salesforce usa apps conectados para integrar aplicativos externos à API do Salesforce, integrar provedores de serviços à sua organização do Salesforce ou controlar quais dados um aplicativo de terceiros pode acessar na 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 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 vai abrir pedindo um código de verificação. Um e-mail com o código de verificação é enviado ao usuário a quem você atribui o fluxo de credenciais do cliente.
    6. Insira o código de verificação. Você será redirecionado para a página de detalhes do consumidor, onde poderá encontrar a chave e o secret. É necessário fornecer a chave e o secret do consumidor ao criar o perfil de conexão.

A seguir