Configurar uma organização do Salesforce para CDC

Para replicar dados de uma organização do Salesforce para um destino compatível, como o BigQuery ou o Cloud Storage, conecte sua organização ao Datastream. Para preparar a origem, configure um perfil de usuário com permissões de API, objeto e campo, adicione endereços IP do Datastream à lista de acesso à rede, se necessário, e, se quiser, configure o OAuth 2.0.

Antes de começar

Antes de começar a configurar o Salesforce para uso com o Datastream, você precisa:

  • 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 se autenticar com um nome de usuário e uma senha ou com o fluxo de credenciais do cliente OAuth 2.0. Para usar o segundo, crie um app conectado do Salesforce ou um app cliente externo.

Se a 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 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, use as instruções a seguir para criar um usuário ou ajustar as configurações de um usuário já criado.
  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 IPs do Datastream à lista de endereços permitidos. Para mais informações, consulte Restringir endereços IP de login em perfis.
  4. Verifique se o perfil de 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. Confirme que o perfil de usuário tem as permissões para ler todos os objetos e campos que você quer incluir no stream. Por motivos de segurança, conceda ao usuário permissões de somente leitura. Para mais informações, consulte Controlar quem pode acessar partes da documentação do Salesforce.
  6. Opcional: por padrão, o Salesforce retorna campos criptografados como campos mascarados. Se você precisar que o usuário veja os valores reais dos campos criptografados, conceda a ele a permissão View Encrypted Data. Para conceder a permissão, edite 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. Confirme que o app conectado está com 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, digite App na caixa de pesquisa rápida e selecione Gerenciador de apps.
    2. Encontre o app conectado na lista e expanda o menu suspenso à direita da linha.
    3. Selecione Ver.
    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 o token do cliente e o Secret para criar seu perfil de conexão.

A seguir