Configure uma organização do Salesforce para CDC

Este documento descreve como configurar a captura de dados de alterações (CDC) para transmitir dados de uma organização do Salesforce para um destino suportado, como o BigQuery ou o Cloud Storage.

Antes de começar

Antes de começar a configurar o Salesforce para utilização com o Datastream, tem de:

  • Ter acesso a uma organização ativa do Salesforce
  • Ter conhecimentos sobre como navegar e alterar as definições no Salesforce
  • Ter conhecimentos sobre como criar utilizadores e perfis no Salesforce

Configure uma organização do Salesforce para utilização com o Datastream

Para estabelecer uma ligação entre a sua organização do Salesforce e o Datastream, tem de fazer a autenticação através de um nome de utilizador e uma palavra-passe ou através do fluxo de credenciais de cliente do OAuth 2.0. Para usar a última opção, pode criar uma app associada do Salesforce ou uma app de cliente externa.

Se a sua organização do Salesforce estiver configurada para permitir o acesso a partir de endereços IP específicos, certifique-se de que o Salesforce aceita os endereços IP da stream de dados. Para ver informações sobre como gerir as restrições de acesso à rede, consulte os artigos Acesso à rede e restrições de IP baseadas em perfis e Defina intervalos de IP fidedignos para a sua organização na documentação do Salesforce.

Configure um utilizador

  1. No Salesforce, crie um utilizador ou ajuste as definições de um utilizador existente de acordo com as instruções que se seguem.
  2. Crie um perfil dedicado e atribua-o ao utilizador.
  3. Se a sua organização tiver restrições de endereços IP configuradas, certifique-se de que adiciona os endereços IP da stream de dados à lista de endereços IP permitidos. Para mais informações, consulte o artigo Restrinja os endereços IP de início de sessão nos perfis.
  4. Certifique-se de que o perfil do utilizador tem a autorização API Enabled para que o utilizador possa usar a API REST Salesforce e a API em massa 2.0.
  5. Certifique-se de que o perfil do utilizador tem as autorizações para ler todos os objetos e campos que quer incluir na sua stream. Por motivos de segurança, considere conceder ao utilizador autorizações só de leitura. Para mais informações, consulte a secção Controle quem vê o quê na documentação do Salesforce.
  6. Opcional: por predefinição, o Salesforce devolve campos encriptados como campos ocultos. Se precisar que o utilizador veja os valores reais dos campos encriptados, conceda-lhe a autorização View Encrypted Data. Pode conceder a autorização editando o conjunto de autorizações do utilizador.

Opcional: crie e configure uma app associada

O Salesforce usa apps associadas para integrar aplicações externas com a API Salesforce, integrar fornecedores de serviços com a sua organização do Salesforce ou controlar os dados aos quais uma aplicação de terceiros pode aceder a partir da sua organização do Salesforce. Se preferir usar uma app associada para autenticar a sua instância do Salesforce no Datastream, siga estes passos:

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

  2. Configure a sua app associada para o fluxo de credenciais de cliente OAuth 2.0.

  3. Certifique-se de que a app associada tem o âmbito Manage user data via APIs (api) ativado. Para mais informações sobre âmbitos, consulte o artigo Tokens e âmbitos do OAuth.

  4. Certifique-se de que a sua app associada pode aceder às APIs Salesforce com os endereços IP do fluxo de dados. Para mais informações, consulte os artigos Restrinja o acesso às APIs com apps associadas e Configure intervalos de IPs fidedignos para uma app associada.

  5. Obtenha a chave de consumidor e o segredo do consumidor:

    1. No Salesforce, introduza App na caixa de pesquisa rápida e, de seguida, selecione Gestor de apps.
    2. Encontre a app associada na lista e expanda o menu pendente à direita da linha.
    3. Selecione Ver.
    4. Na página de detalhes Gerir apps associadas, clique em Gerir detalhes do consumidor.
    5. É aberto um ecrã que lhe pede um código de validação. É enviado um email com o código de validação ao utilizador ao qual atribui o fluxo de credenciais do cliente.
    6. Introduza o código de validação. Em seguida, é feito o redirecionamento para a página de detalhes do consumidor, onde pode encontrar a chave e o segredo. Tem de fornecer a chave e o segredo do consumidor quando cria o seu perfil de associação.

O que se segue?