Associe o Salesforce

Pré-visualização: tem de estar na lista de autorizações para usar este conector.Para ser adicionado à lista de autorizações, contacte a sua equipa da conta ou a equipa de vendas.

Esta página descreve como ligar o Salesforce ao Gemini Enterprise.

Recomendamos que use o conetor do Salesforce V2 (recomendado) para carregar dados do Salesforce para o Gemini Enterprise. O conetor do Salesforce existente vai ser descontinuado. Se estiver a usar um arquivo de dados existente que usa o conetor do Salesforce, crie um novo arquivo de dados com o conetor do Salesforce V2.

Associe o Salesforce V2 (recomendado)

Versões suportadas

O conetor do Salesforce V2 suporta a versão 30.0 ou posterior da API SOAP.

Antes de começar

Antes de configurar a ligação, faça o seguinte:

1. Usar um plano empresarial do Salesforce ou um plano de programador do Salesforce. As contas de avaliação não são suportadas.

2. Configure o Salesforce para a conetividade com base no tipo de autenticação escolhido. Os tipos de autenticação suportados são:

   • Nome de utilizador e palavra-passe

   • OAuth 2.0 – Portador de JWT

   • OAuth 2.0 – Credenciais de cliente

Gere um anexo de serviço

Siga estes passos para gerar uma associação de serviço:

• Para o ponto final Público: se o Tipo de destino do centro de dados do Salesforce for Público, não tem de criar a configuração para a associação de serviços. Em alternativa, pode usar o seu URL público no campo URL do domínio da Google Cloud consola.

• Para o ponto final privado:

  1. Use o PSC para ativar ligações de instâncias privadas a Google Cloud.
  2. Crie uma rede de nuvem privada virtual e as sub-redes necessárias.
  3. Crie uma instância de máquina virtual (VM) e instale o serviço de back-end.
  4. Opcional: configure uma sondagem de verificação de funcionamento para monitorizar o estado de funcionamento do back-end.
  5. Adicione um balanceador de carga para encaminhar o tráfego para a VM ou o back-end.
  6. Defina regras de firewall para permitir o tráfego entre o ponto final do PSC e o back-end.
  7. Publique o ponto final criando uma associação de serviço do PSC.

Nota: a criação de uma configuração de PSC já não é obrigatória para projetos com o VPC-SC ativado.

Configure o Salesforce para a conetividade

Para associar uma origem de dados do Salesforce ao Gemini Enterprise, tem de concluir configurações específicas no Salesforce. Estas configurações variam com base no tipo de autenticação que escolher.

Configuração para autenticação de nome de utilizador e palavra-passe

Para a autenticação de nome de utilizador e palavra-passe, use um token de segurança existente ou reponha o token de segurança para receber um novo no seu email registado.

Para repor o seu símbolo de segurança:

1. Clique no ícone do perfil e selecione Definições.

   

   Definições

2. Navegue para o separador Repor o meu token de segurança e clique em Repor token de segurança.

   

   Reponha o token de segurança

   O Salesforce envia o novo token de segurança para o seu email registado.

Configuração para autenticação de portador JWT do OAuth 2.0

Tem de configurar o Gemini Enterprise como uma app de cliente externa (app associada) no Salesforce para a integração da API.

Depois de associar o Gemini Enterprise como uma app de cliente externa (app associada), pode obter as seguintes informações de autenticação necessárias para criar um conector do Salesforce no Gemini Enterprise.

• Chave de cliente
• Chave pública
• Nome de utilizador (pré-autorizado a usar a aplicação)

Nota: se estiver a usar a autenticação OAuth, tem de instalar a app associada na sua conta do Salesforce depois de criar a associação. Para ver detalhes, consulte o artigo Instale a app associada de OAuth.

Gere a chave privada e o certificado público

1. Execute o seguinte comando OpenSSL para gerar uma chave privada RSA de 2048 bits.

   openssl genrsa -out server.key 2048

   Este comando cria um ficheiro denominado server.key, que contém a sua chave privada. Mantenha este ficheiro seguro e confidencial.

2. Execute o seguinte comando OpenSSL para gerar um certificado público autoassinado através da chave privada.

   openssl req -new -x509 -sha256 -days 3650 -key server.key -out server.crt

   Este comando gera um ficheiro denominado server.crt, que é o seu certificado público. Pode carregar este certificado para o Salesforce durante a configuração da app cliente externa (app associada).

Crie e configure a app cliente externa no Salesforce

1. Na app Salesforce, clique no ícone de configuração e, de seguida, selecione Configuração.

   

   Configuração

2. Introduza Apps na caixa de pesquisa rápida e selecione Gestor de apps.

3. Selecione Nova app cliente externa.

   

   Nova app cliente externa

4. Introduza as informações básicas necessárias para a sua app cliente externa (app associada), como o nome da app cliente externa, o nome da API e o email de contacto.

5. Na secção API (ativar definições de OAuth), configure as seguintes definições de OAuth. Para mais informações, consulte o artigo Ative as definições do OAuth para a integração da API.

   1. Selecione a caixa de verificação Ativar OAuth.
   2. Introduza o URL de retorno como https://vertexaisearch.cloud.google.com/console/oauth/salesforce_oauth.html.
   3. Na secção Âmbitos do OAuth selecionados, adicione Acesso total (full), Gerir dados do utilizador através de APIs (api) e Realizar pedidos em qualquer altura (refresh_token, offline_access). Para mais informações, consulte o artigo Símbolos OAuth e âmbitos.

   4. Na secção Ativação do fluxo:

   5. Selecione a caixa de verificação Ativar fluxo de suporte de JWT.

   6. Carregue o certificado público criado em Gere a chave privada e o certificado público.

      

      Ativar definições de OAuth – JWT do OAuth2

   7. Clique em Criar.

Pré-autorize o acesso de apps de cliente externas

Depois de criar a app de cliente externa, tem de autorizar explicitamente utilizadores ou conjuntos de autorizações específicos a acederem à mesma.

1. Introduza External client app na caixa de pesquisa rápida e selecione Gestor de apps de cliente externas.
2. Encontre e abra a app de cliente externa que criou anteriormente.
3. No separador Políticas, clique em Editar para modificar os detalhes da app.

4. Na secção Políticas de OAuth, faça o seguinte:

   1. No campo Utilizadores permitidos, selecione Os utilizadores aprovados pelo administrador estão pré-autorizados.
   2. No campo Política de tokens de atualização, selecione O token de atualização é válido até ser revogado.
   3. No campo Relaxamento de IP, selecione Relaxar restrições de IP.

      

      Políticas de OAuth – Portador de JWT OAuth2

   A funcionalidade de relaxamento de IP controla se as aplicações cliente externas (apps associadas) estão restritas por intervalos de endereços IP definidos. As restrições de IP são aplicadas com base nas definições do perfil de utilizador. Tem de verificar se uma aplicação de intervalo de IPs ao nível da organização está ativa nas definições do utilizador. Se a opção Aplicar intervalos de IP de início de sessão em todos os pedidos estiver ativada, a definição de Flexibilização de IP como Flexibilizar restrições de IP não substitui as restrições de IP existentes. Para mais informações, consulte o artigo Relaxamento do IP da app associada e aplicação contínua do IP.

   • Se quiser aplicar restrições de IP na app de cliente externa (app associada), configure um IP fidedigno. Para mais informações, consulte o artigo Configure intervalos de IPs fidedignos para uma app associada.
   • Se não quiser ter restrições de acesso por IP, verifique se a opção Aplicar intervalos de IPs de início de sessão em todos os pedidos não está selecionada.

5. Na secção Políticas de apps, selecione os perfis e os conjuntos de autorizações para os quais este tipo de autenticação tem de ser autorizado.

   

   Políticas de apps

6. Clique em Guardar.

7. Navegue para o separador Definições.

8. Na secção Definições do OAuth, clique em Chave de consumidor e segredo e copie Consumer key e Consumer secret.

Configuração para OAuth 2.0 – Autenticação de credenciais de cliente

Tem de configurar o Gemini Enterprise como uma app de cliente externa (app associada) no Salesforce para a integração da API.

Depois de associar o Gemini Enterprise como uma app de cliente externa (app associada), pode obter as seguintes informações de autenticação necessárias para criar um conector do Salesforce no Gemini Enterprise.

• ID de consumidor ou ID de cliente
• Segredo do consumidor ou chave de cliente

Nota: se estiver a usar a autenticação OAuth, tem de instalar a app de cliente externa (app associada) na sua conta do Salesforce depois de criar a associação. Para ver detalhes, consulte o artigo Instale a app associada de OAuth.

Crie e configure uma app cliente externa

1. Na app Salesforce, clique no ícone de configuração e, de seguida, selecione Configuração.

2. Introduza Apps na caixa de pesquisa rápida e selecione Gestor de apps.

3. Selecione Nova app cliente externa.

4. Introduza as informações básicas necessárias para a sua app cliente externa (app associada), como o nome da app cliente externa, o nome da API e o email de contacto.

5. Na secção API (ativar definições de OAuth), configure as seguintes definições de OAuth. Para mais informações, consulte o artigo Ative as definições do OAuth para a integração da API.

   1. Selecione a caixa de verificação Ativar OAuth.
   2. Introduza o URL de retorno como https://vertexaisearch.cloud.google.com/console/oauth/salesforce_oauth.html.
   3. Na secção Âmbitos do OAuth selecionados, selecione Acesso total (completo), Gerir dados do utilizador através de APIs (api) e Efetuar pedidos em qualquer altura (refresh_token, offline_access). Para mais informações, consulte o artigo Símbolos OAuth e âmbitos.
   4. Na secção Ativação do fluxo, selecione a caixa de verificação Ativar fluxo de credenciais de cliente.

      

      Ativar definições OAuth: credenciais do cliente OAuth2

6. Clique em Criar.

Pré-autorize o acesso de apps de cliente externas

Depois de criar a app de cliente externa, tem de autorizar explicitamente utilizadores ou conjuntos de autorizações específicos a acederem à mesma.

1. Introduza External client app na caixa de pesquisa rápida e selecione Gestor de apps de cliente externas.
2. Clique no nome da app cliente externa que criou.
3. No separador Políticas, clique em Editar para modificar os detalhes da app.

4. Na secção Políticas de OAuth, faça o seguinte:

   1. No campo Utilizadores permitidos, selecione Os utilizadores aprovados pelo administrador estão pré-autorizados.

   2. Na secção Fluxo OAuth e melhoramento do cliente externo:

      1. Selecione a caixa de verificação Ativar fluxo de credenciais de cliente.
      2. Introduza o ID de email do utilizador.

   3. No campo Política de tokens de atualização, selecione O token de atualização é válido até ser revogado.

   4. No campo Relaxamento de IP, selecione Relaxar restrições de IP.

      

      Políticas de OAuth – Credenciais do cliente OAuth2

   A funcionalidade de relaxamento de IP controla se as aplicações cliente externas (apps associadas) estão restritas por intervalos de endereços IP definidos. As restrições de IP são aplicadas com base nas definições do perfil de utilizador. Tem de verificar se uma aplicação de intervalo de IPs ao nível da organização está ativa nas definições do utilizador. Se a opção Aplicar intervalos de IP de início de sessão em todos os pedidos estiver ativada, a definição de Flexibilização de IP como Flexibilizar restrições de IP não substitui as restrições de IP existentes. Para mais informações, consulte o artigo Relaxamento do IP da app associada e aplicação contínua do IP.

   • Se quiser aplicar restrições de IP na app de cliente externa (app associada), configure um IP fidedigno. Para mais informações, consulte o artigo Configure intervalos de IPs fidedignos para uma app associada.
   • Se não quiser ter restrições de acesso por IP, verifique se a opção Aplicar intervalos de IPs de início de sessão em todos os pedidos não está selecionada.

5. Na secção Políticas de apps, selecione os perfis e os conjuntos de autorizações para os quais este tipo de autenticação tem de ser autorizado.

   

   Políticas de apps

6. Clique em Guardar.

7. Navegue para o separador Definições.

8. Na secção Definições do OAuth, clique em Chave de consumidor e segredo e, de seguida, copie Consumer key e Consumer secret.

Obtenha o URL de início de sessão

Para obter o URL de início de sessão da sua instância do Salesforce, faça o seguinte:

1. Introduza My domain na caixa de pesquisa rápida e selecione O meu domínio.
2. Copie o domínio que termina em my.salesforce.com.
3. Adicione https:// ao início do domínio copiado. Este é o URL da instância de que precisa quando cria o conetor do Salesforce no Gemini Enterprise. O URL da instância tem de estar no seguinte formato: https://DOMAIN_NAME.my.salesforce.com.

Configure as autorizações mínimas do utilizador

Para verificar se o utilizador que está a configurar o conector tem as autorizações mínimas necessárias para obter dados, conclua os seguintes passos:

1. Introduza Profiles na caixa de pesquisa rápida e selecione Perfis.
2. Selecione o perfil do utilizador que executa o conetor.
3. Navegue para a secção Autorizações de objetos padrão e valide as autorizações.

Verifique se o utilizador selecionado tem acesso às autorizações. Este processo tem de ser repetido para cada entidade que pretenda carregar. Isto envolve verificar se o acesso predefinido ao nível do perfil do utilizador está definido como Private. Quando o acesso de uma entidade está definido como Private, o seu Google Cloud conector não consegue aceder ao objeto necessário e regista um erro no Cloud Logging. Para permitir o acesso, faça o seguinte:

1. Crie um conjunto de autorizações e partilhe-o com o utilizador.

   1. Introduza Permission sets na caixa de pesquisa rápida e selecione Conjuntos de autorizações.

   2. Clique em Novo.

   3. Introduza um nome e guarde o conjunto de autorizações.

   4. Abra o conjunto de autorizações criado e navegue para a secção Apps.

   5. Selecione Definições do objeto.

   6. Selecione a caixa de verificação Ver todos os registos.

   7. Na secção Autorizações de campos, conceda acesso de leitura a todos os campos que quer sincronizar.

      

      Definições de objetos

   8. Guarde as definições e navegue para trás.

   9. Na secção Sistema, selecione Autorizações do sistema.

   10. Ative as seguintes autorizações mínimas:

       • API enabled

       • View all users

       • View roles and role hierarchy

       • View setup and configuration

2. Adicione o utilizador ao conjunto de autorizações:

   1. Introduza Users na caixa de pesquisa rápida e selecione Utilizadores.

   2. Selecione o utilizador.

   3. Na secção Atribuições de conjuntos de autorizações, selecione Editar atribuições.

   4. Adicione o conjunto de autorizações criado recentemente à secção Conjuntos de autorizações ativados.

Para mais informações, consulte os artigos Acesso aos dados no Salesforce e Predefinições de partilha ao nível da organização.

Crie um arquivo de dados do Salesforce V2

Consola

Para usar a Google Cloud consola para sincronizar dados do Salesforce com o Gemini Enterprise , siga estes passos:

1. Na Google Cloud consola, aceda à página Gemini Enterprise.

   Gemini Enterprise

2. No menu de navegação, clique em Armazenamentos de dados.

3. Clique em Criar arquivo de dados.

4. Na página Selecione uma origem de dados, desloque a página ou pesquise Salesforce V2 para associar a sua origem de terceiros.

5. Na secção Autenticações, selecione o método de autenticação e introduza as informações de autenticação.

6. Na secção Destinos, selecione Público ou Privado.

   1. Para o tipo de destino Público, não tem de criar a configuração para a associação de serviços. No campo URL de início de sessão, introduza o URL de início de sessão no servidor do Salesforce.

   2. Para o tipo de destino Privado, introduza todas as informações necessárias:

      1. Associação do serviço: introduza a associação do serviço.
      2. Nome do domínio base: introduza o seu domínio base.
      3. URL de início de sessão: introduza o URL de início de sessão no servidor do Salesforce.

7. Clique em Continuar.

8. Na secção Entidades a sincronizar, faça o seguinte:

   1. Selecione as entidades que quer sincronizar.

      • Opcional: Nome do campo de URL: introduza um nome de coluna para substituir o URL da entidade predefinido por um URL personalizado da tabela do Salesforce. Este campo é sensível a maiúsculas e minúsculas.

        Por exemplo: se a tabela de contas do Salesforce que está a sincronizar tiver uma coluna website com um endereço do Website específico para cada conta, pode introduzir website aqui. Quando um utilizador vê uma conta nos resultados da pesquisa e clica no link, é redirecionado para o URL armazenado na coluna website em vez do URL da página de registo padrão do Salesforce.

   2. Opcional: para adicionar entidades personalizadas, clique em Adicionar entidades manualmente. O nome da entidade personalizada tem de estar no seguinte formato custom_object_name__c. Por exemplo: MyObject__c.

      

      Entidades a sincronizar

   3. Selecione a Frequência de sincronização para a Sincronização completa e a Frequência de sincronização incremental para a Sincronização de dados incremental. Para mais informações, consulte o artigo Sincronize agendas.

      

      Definir frequência de sincronização.

      • Opcional: para agendar sincronizações completas separadas de entidades e identidade, expanda o menu em Sincronização completa. Selecione Opções personalizadas. Na caixa de diálogo Opções de sincronização personalizadas, defina a frequência para entidades e identidade.

      

      Definir agendas separadas para a sincronização completa de entidades e a sincronização completa de identidades.

9. Clique em Continuar.

10. Na secção Configure o conetor de dados, faça o seguinte:

    1. Selecione uma região para o seu repositório de dados.
    2. Introduza um nome para o seu repositório de dados.
    3. Clique em Criar. O Gemini Enterprise cria o seu arquivo de dados e apresenta os seus arquivos de dados na página Arquivos de dados.

       

       Configure o conetor de dados

11. Para verificar o estado do carregamento, aceda à página Armazenamentos de dados e clique no nome do armazenamento de dados para ver os respetivos detalhes na página Dados. O Estado do conetor muda de A criar para Em execução quando começa a sincronizar dados. Quando o carregamento estiver concluído, o estado muda para Ativo para indicar que a ligação à sua origem de dados está configurada e a aguardar a próxima sincronização agendada.

    Consoante o tamanho dos seus dados, a carregamento pode demorar minutos ou horas.

Instale a app associada OAuth

Se estiver a usar a autenticação OAuth, tem de instalar a app de cliente externa que criou na secção Crie e configure a app associada no Salesforce. Navegue para a página Utilização de OAuth de apps associadas na sua conta do Salesforce e instale a app. Para mais informações, consulte o artigo Alteração das restrições de utilização de apps associadas.

Limites de taxas

O limite de taxa predefinido para o conetor do Salesforce é de 5 pedidos por segundo.

Mensagens de erro

A tabela seguinte apresenta as mensagens de erro que pode receber quando usa o conetor do Salesforce:

Mensagem de erro	Descrição	Resolução de problemas
A inicialização do conector falhou devido a uma falha do pipeline. Elimine o conetor e tente criá-lo novamente.	O conector não foi inicializado devido a uma falha no pipeline. Isto deve-se a um erro interno do serviço.	Elimine o conetor existente e volte a criá-lo.
O conector está bloqueado porque o projeto foi adicionado ao perímetro do VPC-SC. Recrie o arquivo de dados.	Depois de o repositório de dados ter sido criado, este projeto foi adicionado ao perímetro do VPC Service Controls.	Elimine o arquivo de dados existente e volte a criá-lo. Isto garante que o repositório de dados está configurado corretamente para funcionar dentro do perímetro dos VPC Service Controls.
A associação não está no estado ativo. Estado da associação: ERROR e descrição: Failed to retrieve OAuth token information. [INVALID_GRANT] Nenhum utilizador com credenciais de cliente ativado.	Quando usa a autenticação de credenciais de cliente JWT, a ligação não está ativa porque não é possível obter o token OAuth.	Na instância do Salesforce, navegue para a app cliente externa e encontre a app cliente usada para o arquivo de dados. Na secção Fluxo de credenciais do cliente, adicione o email de um utilizador com as autorizações necessárias ao campo Executar como utilizador. Clique em Guardar. Na Google Cloud consola, elimine e, em seguida, recrie o arquivo de dados.
A associação não está no estado ativo. Estado da associação: ERROR e descrição: INVALID_LOGIN: nome de utilizador, palavra-passe ou token de segurança inválido; ou utilizador bloqueado.	A ligação falhou devido a informações de início de sessão incorretas. A ligação não está num estado ativo devido a um nome de utilizador, uma palavra-passe ou um token de segurança inválido.	Verifique se o nome de utilizador e a palavra-passe estão corretos. Normalmente, o nome de utilizador é um endereço de email, como [e-mail]. Confirme que o token de segurança está correto e atualizado. Sempre que repõe a palavra-passe, o token de segurança torna-se inválido. Se o seu token de segurança for inválido, pode repô-lo.
A associação não está no estado ativo. Estado da associação: ERROR e descrição: Failed to retrieve OAuth token information. [INVALID_GRANT] O público-alvo é inválido.	A ligação falhou porque a obtenção do token OAuth para autenticação JWT devolveu um público-alvo inválido, provavelmente devido a credenciais de utilizador incorretas.	Verifique se o nome de utilizador e a palavra-passe estão corretos. Normalmente, o nome de utilizador é um endereço de email, como [e-mail].
[INVALID_SESSION_ID] Sessão inválida ou expirada. Tente voltar a ligar. Se o problema persistir, pode dever-se ao seguinte: A) Excedeu os limites de sessão para este utilizador. B) Pode estar relacionado com a MFA necessária para a sua conta. C) A opção "Bloquear sessões ao IP a partir do qual são geradas" está ativada nos controlos de segurança do Salesforce e o seu IP está a mudar entre pedidos.	A sessão já não é válida. Isto pode acontecer se tiver excedido os limites da sessão ou se a sua conta exigir a autenticação multifator (AMF). Também pode ocorrer se estiver ativada uma definição de segurança que bloqueia a sua sessão a um endereço IP específico e o seu endereço IP for alterado.	Navegue para as definições do Salesforce e certifique-se de que a opção Bloquear sessões ao endereço IP de origem está definida como Desativada. Nas definições do perfil do utilizador, verifique se a opção Nível de segurança da sessão necessário no início de sessão está definida como Nenhum.

Limitações conhecidas

• As listas de controlo de acesso baseadas em categorias para versões de artigos de conhecimentos não são suportadas.

• As tarefas só são visíveis para utilizadores com a autorização Ver todos os dados, proprietários de tarefas e pessoas que têm acesso através da hierarquia.

• Quando adiciona um projeto a um perímetro dos VPC Service Controls (VPC-SC) depois de criar uma associação, a execução da sincronização do conetor falha.

• Quando adiciona manualmente entidades, apenas são suportados objetos Custom Object__c do Salesforce (objetos personalizados com nomes de variáveis que terminam em __c).

Associe o Salesforce (V1)

Antes de começar

Antes de configurar a ligação, faça o seguinte:

1. Usar um plano Enterprise ou Developer. As contas de avaliação não são suportadas.
2. Configure o controlo de acesso para a sua origem de dados. Para ver informações sobre a configuração do controlo de acesso, consulte o artigo Use o controlo de acesso à origem de dados.
3. Verifique se a lista de autorizações de CORS da Salesforce contém Google Cloud.
   1. Para configurar a lista de autorizações, consulte o artigo Ative o CORS para pontos finais OAuth.
   2. Para incluir o Google Cloud, adicione https://console.cloud.google.com/ como URL de origem e guarde a configuração.

Crie e configure uma app cliente externa no Salesforce

Tem de configurar o Gemini Enterprise como uma app de cliente externa (app associada) no Salesforce para a integração da API.

Depois de associar o Gemini Enterprise como uma app de cliente externa (app associada), pode obter as seguintes informações de autenticação necessárias para criar um conector do Salesforce no Gemini Enterprise.

• URL da instância
• ID de consumidor ou ID de cliente
• Segredo do consumidor ou chave de cliente

Para ativar o OAuth 2.0 e obter as informações de autenticação, faça o seguinte:

1. Na app Salesforce, clique no ícone de configuração e, de seguida, selecione Configuração.

   

   Configuração

2. Introduza Apps na caixa de pesquisa rápida e selecione Gestor de apps.

3. Selecione Nova app cliente externa.

   

   Nova app cliente externa

4. Introduza as informações básicas necessárias para a sua app cliente externa (app associada), como o nome da app cliente externa, o nome da API e o email de contacto.

5. Na secção API (ativar definições de OAuth), configure as seguintes definições de OAuth. Para mais informações, consulte o artigo Ative as definições do OAuth para a integração da API.

   1. Selecione a caixa de verificação Ativar OAuth.
   2. Introduza o URL de retorno como https://vertexaisearch.cloud.google.com/console/oauth/salesforce_oauth.html.
   3. Na secção Âmbitos do OAuth selecionados, adicione Acesso total (full), Gerir dados do utilizador através de APIs (api) e Realizar pedidos em qualquer altura (refresh_token, offline_access). Para mais informações, consulte o artigo Símbolos OAuth e âmbitos.
   4. Selecione a caixa de verificação Ativar fluxo de credenciais de cliente.
   5. Selecione a caixa de verificação Ativar fluxo de código de autorização e credenciais.
   6. Clique em Criar.

      

      Ativar definições de OAuth – JWT OAuth2

Pré-autorize o acesso de apps de cliente externas

Depois de criar a app de cliente externa, tem de autorizar explicitamente utilizadores ou conjuntos de autorizações específicos a acederem à mesma.

1. Introduza External client app na caixa de pesquisa rápida e selecione Gestor de apps de cliente externas.
2. Clique no nome da app cliente externa que criou.
3. No separador Políticas, clique em Editar para modificar os detalhes da app.

4. Na secção Políticas de OAuth, faça o seguinte:

   1. No campo Utilizadores permitidos, selecione Os utilizadores aprovados pelo administrador estão pré-autorizados.

   2. Na secção Fluxo OAuth e melhoramento do cliente externo:

      1. Selecione a caixa de verificação Ativar fluxo de credenciais de cliente.
      2. Introduza o ID de email do utilizador.

   3. No campo Política de tokens de atualização, selecione O token de atualização é válido até ser revogado.

   4. No campo Relaxamento de IP, selecione Relaxar restrições de IP.

      

      Políticas de OAuth – Credenciais do cliente OAuth2

   A funcionalidade de relaxamento de IP controla se as aplicações cliente externas (apps associadas) estão restritas por intervalos de endereços IP definidos. As restrições de IP são aplicadas com base nas definições do perfil de utilizador. Tem de verificar se uma aplicação de intervalo de IPs ao nível da organização está ativa nas definições do utilizador. Se a opção Aplicar intervalos de IP de início de sessão em todos os pedidos estiver ativada, a definição de Flexibilização de IP como Flexibilizar restrições de IP não substitui as restrições de IP existentes. Para mais informações, consulte o artigo Relaxamento do IP da app associada e aplicação contínua do IP.

   • Se quiser aplicar restrições de IP na app de cliente externa (app associada), configure um IP fidedigno. Para mais informações, consulte o artigo Configure intervalos de IPs fidedignos para uma app associada.
   • Se não quiser ter restrições de acesso por IP, verifique se a opção Aplicar intervalos de IPs de início de sessão em todos os pedidos não está selecionada.

5. Na secção Políticas de apps, selecione os perfis e os conjuntos de autorizações para os quais este tipo de autenticação tem de ser autorizado.

   

   Políticas de apps

6. Clique em Guardar.

7. Navegue para o separador Definições.

8. Na secção Definições do OAuth, clique em Chave de consumidor e segredo e, de seguida, copie Consumer key e Consumer secret.

Obtenha o URL de início de sessão

Para obter o URL de início de sessão da sua instância do Salesforce, faça o seguinte:

1. Introduza My domain na caixa de pesquisa rápida e selecione O meu domínio.
2. Copie o domínio que termina em my.salesforce.com.
3. Adicione https:// ao início do domínio copiado. Este é o URL da instância de que precisa quando cria o conetor do Salesforce no Gemini Enterprise. O URL da instância tem de estar no seguinte formato: https://DOMAIN_NAME.my.salesforce.com.

Configure as autorizações mínimas do utilizador

Para verificar se o utilizador que está a configurar o conector tem as autorizações mínimas necessárias para obter dados, conclua os seguintes passos:

1. Introduza Profiles na caixa de pesquisa rápida e selecione Perfis.
2. Selecione o perfil do utilizador que executa o conetor.
3. Navegue para a secção Autorizações de objetos padrão e valide as autorizações.

Verifique se o utilizador selecionado tem acesso às autorizações. Este processo tem de ser repetido para cada entidade que pretenda carregar. Isto envolve verificar se o acesso predefinido ao nível do perfil do utilizador está definido como Private. Quando o acesso de uma entidade está definido como Private, o seu Google Cloud conetor não consegue aceder ao objeto necessário e regista um erro no Cloud Logging.

Para permitir o acesso, faça o seguinte:

1. Crie um conjunto de autorizações e partilhe-o com o utilizador.

   1. Introduza Permission sets na caixa de pesquisa rápida e selecione Conjuntos de autorizações.

   2. Clique em Novo.

   3. Introduza um nome e guarde o conjunto de autorizações.

   4. Abra o conjunto de autorizações criado e navegue para a secção Apps.

   5. Selecione Definições do objeto.

   6. Selecione a caixa de verificação Ver todos os registos.

   7. Na secção Autorizações de campos, conceda acesso de leitura a todos os campos que quer sincronizar.

      

      Definições de objetos

   8. Guarde as definições e navegue para trás.

   9. Na secção Sistema, selecione Autorizações do sistema.

   10. Ative as seguintes autorizações mínimas:

       • API enabled

       • View all users

       • View roles and role hierarchy

       • View setup and configuration

2. Adicione o utilizador ao conjunto de autorizações:

   1. Introduza Users na caixa de pesquisa rápida e selecione Utilizadores.

   2. Selecione o utilizador.

   3. Na secção Atribuições de conjuntos de autorizações, selecione Editar atribuições.

   4. Adicione o conjunto de autorizações criado recentemente à secção Conjuntos de autorizações ativados.

Para mais informações, consulte os artigos Acesso aos dados no Salesforce e Predefinições de partilha ao nível da organização.

Crie um arquivo de dados do Salesforce (V1)

Consola

Para usar a Google Cloud consola para sincronizar dados do Salesforce com o Gemini Enterprise , siga estes passos:

1. Na Google Cloud consola, aceda à página Gemini Enterprise.

   Gemini Enterprise

2. No menu de navegação, clique em Armazenamentos de dados.

3. Clique em Criar arquivo de dados.

4. Na página Selecione uma origem de dados, desloque a página ou pesquise Salesforce para associar a sua origem de terceiros.

5. Introduza as suas informações de autenticação do Salesforce.

6. Selecione as entidades a sincronizar e clique em Continuar.

7. Selecione a Frequência de sincronização para a Sincronização completa e a Frequência de sincronização incremental para a Sincronização de dados incremental. Para mais informações, consulte o artigo Sincronize programações.

   Se quiser agendar sincronizações completas separadas de dados de entidades e identidades, expanda o menu em Sincronização completa e, de seguida, selecione Opções personalizadas.

   

   Definir agendas separadas para a sincronização completa de entidades e a sincronização completa de identidades.

8. Selecione uma região para o seu repositório de dados.

9. Introduza um nome para o seu repositório de dados.

10. Clique em Criar. O Gemini Enterprise cria o seu arquivo de dados e apresenta os seus arquivos de dados na página Arquivos de dados.

11. Para verificar o estado do carregamento, aceda à página Armazenamentos de dados e clique no nome do armazenamento de dados para ver os respetivos detalhes na página Dados. O Estado do conetor muda de A criar para Em execução quando começa a sincronizar dados. Quando o carregamento estiver concluído, o estado muda para Ativo para indicar que a ligação à sua origem de dados está configurada e a aguardar a próxima sincronização agendada.

    Consoante o tamanho dos seus dados, a carregamento pode demorar minutos ou horas.

Passos seguintes

• Para anexar o seu arquivo de dados a uma app, crie uma app e selecione o seu arquivo de dados seguindo os passos em Criar uma app.

• Para pré-visualizar a apresentação dos resultados da pesquisa após a configuração da app e do arquivo de dados, consulte o artigo Pré-visualizar resultados da pesquisa. Se usou o controlo de acesso de terceiros, consulte o artigo Pré-visualize os resultados das apps com controlo de acesso de terceiros.

• Para ativar alertas para o arquivo de dados, consulte o artigo Configure alertas para arquivos de dados de terceiros.