Nesta página, descrevemos como um administrador do Salesforce ativa o servidor MCP que o conector do Salesforce chama e configura a autenticação OAuth 2.0 no Salesforce. Ambos são pré-requisitos para conectar o Salesforce ao Gemini Enterprise.
Escolher um método de autenticação
Como o fluxo do OAuth 2.0 é executado nos endpoints do Meu Domínio da sua organização, em vez de um host de login compartilhado do Salesforce, sua organização precisa confiar em um app cliente OAuth antes que qualquer usuário possa autorizar o conector. É possível configurar a autenticação de duas maneiras:
- OAuth gerenciado peloGoogle (OAuth 2.0 (gerenciado pelo Google), padrão): oGoogle publica o pacote gerenciado Gemini Enterprise - Salesforce Connector no Salesforce AppExchange. Ao instalar o pacote na sua organização do Salesforce, você não cria seu próprio app do Salesforce nem insere um ID do cliente ou uma chave secreta do cliente no Gemini Enterprise. Consulte Instalar o pacote gerenciado pelo Google.
- Traga seu próprio app (OAuth 2.0 (Traga seu próprio app)): se a organização não puder instalar pacotes do AppExchange ou quiser gerenciar o próprio aplicativo OAuth e as políticas de segurança diretamente, crie seu próprio app cliente externo no Salesforce e insira o ID do cliente (token do cliente) e a chave secreta do cliente (chave secreta do cliente) no Gemini Enterprise. Consulte Criar seu próprio app OAuth.
Antes de começar
Antes de configurar o Salesforce, verifique o seguinte:
Você fez login no Salesforce como administrador:
- Para instalar o pacote gerenciado pelo Google, seu perfil de usuário precisa incluir a permissão Fazer o download de pacotes do AppExchange (incluída no perfil de Administrador do sistema).
- Para usar seu próprio app, seu perfil de usuário precisa ter permissão para criar e gerenciar apps clientes externos na Configuração do Salesforce.
Você sabe qual organização está conectando. Conclua a configuração na mesma organização em que você planeja inserir o URL do Meu Domínio como o URI da instância ao criar o repositório de dados.
Sua organização tem o Meu Domínio ativado e implantado. O conector autoriza o host do Meu domínio, por exemplo,
https://example.my.salesforce.com.Sua organização usa uma edição compatível do Salesforce. O conector é compatível com as edições Professional, Enterprise, Unlimited e Developer.
O servidor MCP SObject All está ativo na sua organização. O servidor não fica ativo por padrão. Consulte Ativar o servidor MCP na sua organização.
Todos os usuários do Salesforce que autorizam e usam o conector têm a permissão do sistema API ativada no perfil atribuído ou em um conjunto de permissões atribuído (em Configuração, acesse Usuários > Perfis ou Usuários > Conjuntos de permissões e selecione Permissões do sistema > API ativada). Os perfis de usuário padrão de administrador do sistema e usuário padrão incluem essa permissão por padrão, mas os perfis personalizados geralmente a desativam.
Ativar o servidor MCP na sua organização
O conector chama o servidor MCP SObject All hospedado no Salesforce, que expõe as operações de criação, leitura, atualização e exclusão por trás das ações do conector. O conector se conecta apenas ao endpoint do servidor MCP SObject All. Servidores MCP separados por operação não são compatíveis. A ativação é necessária para o OAuth 2.0 (gerenciado pelo Google) e o OAuth 2.0 (traga seu próprio app).
Como o servidor fica inativo por padrão, um administrador precisa ativá-lo na sua organização.
Para ativar, siga estas etapas:
No Salesforce, acesse Setup.
Acesse Integrações > Catálogo de APIs > Servidores MCP.
Na guia Servidores do Salesforce, encontre SObject All, descrito como Cria, lê, atualiza e exclui registros do Salesforce.
Defina o Status do servidor como Ativo.
A ativação do servidor MCP SObject All ativa o servidor para sua organização sem exigir uma permissão do usuário separada do servidor MCP e não concede aos usuários permissão para criar, atualizar ou excluir registros por conta própria. O acesso de gravação e exclusão é controlado em duas camadas:
- No Gemini Enterprise: as ações somente leitura são ativadas por padrão, e as ações que criam, atualizam ou excluem registros são desativadas por padrão. Ao configurar ou gerenciar o repositório de dados, o administrador do Google Cloud escolhe quais ações de criação, atualização ou exclusão ativar ou deixa todas desativadas para que o conector seja somente leitura. Consulte Ativar ações.
- No Salesforce: cada ação é executada como uma chamada de API na conta do Salesforce do usuário que autorizou. O usuário precisa ter a permissão do sistema API ativada no perfil ou em um conjunto de permissões atribuído, e o conector respeita as permissões no nível do objeto, a segurança no nível do campo e as regras de compartilhamento desse usuário.
Instalar o pacote gerenciado pelo Google
Se você planeja usar o OAuth 2.0 (gerenciado pelo Google), instale o pacote gerenciado do Gemini Enterprise no Salesforce AppExchange:
Faça login na sua organização do Salesforce como administrador.
Acesse a página do Gemini Enterprise - Salesforce Connector no Salesforce AppExchange.
Clique em Obtenha agora.
Escolha o ambiente para instalar:
- Install in Production para sua organização de produção.
- Install in Sandbox para uma organização de sandbox.
Escolha quais usuários terão acesso ao app:
- Install for Admins Only: somente usuários com o perfil de administrador do sistema podem usar o app.
- Instalar para perfis específicos: somente os usuários com os perfis selecionados podem usar o app.
- Instalar para todos os usuários (recomendado): todos os usuários da organização podem usar o app sem configuração adicional de perfil.
O pacote gerenciado já inclui os escopos OAuth necessários (
mcp_apierefresh_token). Todos os usuários que fizerem login para autorizar o conector no Gemini Enterprise precisam ter acesso ao app na opção escolhida e também precisam ter a permissão do sistema API ativada no perfil do Salesforce ou em um conjunto de permissões atribuído. Um usuário cujo perfil não tem acesso ao app não pode concluir a etapa de login, e um usuário sem a API ativada não pode executar consultas ou ações.Aprove o acesso de terceiros se o Salesforce solicitar e clique em Instalar ou Fazer upgrade.
Aguarde a conclusão da instalação. Para uma organização grande, o Salesforce pode concluir a instalação de forma assíncrona e enviar um e-mail quando terminar.
Após a instalação, o app aparece na Configuração do Salesforce como Gemini Enterprise. Em seguida, defina a política de IP de login para o app.
Criar seu próprio app OAuth
Se você planeja usar o OAuth 2.0 (Traga seu próprio app), crie e configure um app cliente externo no Salesforce para receber um token do cliente (ID do cliente) e uma chave secreta do cliente (chave secreta do cliente):
Faça login na sua organização do Salesforce como administrador e acesse Configuração.
No campo Pesquisa rápida, digite
External Client App Managere selecione Gerenciador de apps de clientes externos.Clique em Novo app cliente externo e, em Informações básicas, insira as informações necessárias (Nome do app cliente externo, Nome da API e E-mail de contato).
Na seção API (ativar configurações do OAuth), selecione Ativar OAuth e defina as seguintes configurações:
Em Configurações do app, em URL de callback, insira:
https://vertexaisearch.cloud.google.com/oauth-redirectEm Escopos do OAuth, adicione os dois escopos a seguir:
- Acessar os servidores MCP da plataforma de API do Salesforce (mcp_api)
- Fazer solicitações a qualquer momento (refresh_token, offline_access)
Eles concedem os escopos
mcp_apierefresh_tokenexigidos pelo conector.Em Segurança, verifique se as seguintes opções estão selecionadas:
- Exigir a extensão Proof Key for Code Exchange (PKCE) para fluxos de autorização compatíveis
- Emitir tokens de acesso baseados em JSON Web Token (JWT) para usuários nomeados
Clique em Criar.
Configure as políticas de OAuth do app:
Em Configuração, acesse Apps > Gerenciador de apps de clientes externos, clique no app de cliente externo, selecione a guia Políticas e clique em Editar.
Em Usuários permitidos, selecione Todos os usuários podem se autorizar (recomendado) ou Os usuários aprovados pelo administrador são pré-autorizados e atribua os perfis ou conjuntos de permissões para todos os usuários que autorizam o conector (incluindo o administrador que verifica a autenticação durante a criação do repositório de dados). Verifique se todos os usuários que autorizam o conector também têm a permissão do sistema API Enabled no perfil ou em um conjunto de permissões atribuído.
Em Relaxamento de IP, selecione Relaxar restrições de IP. Para saber por que essa configuração é necessária, consulte Definir a política de IP de login para o app.
Clique em Salvar.
Copie as credenciais do OAuth do app:
- Selecione a guia Configurações, abra Configurações do OAuth e clique em Token do cliente e chave secreta.
- Copie e salve o Token do cliente e o Secret do consumidor. Insira esses valores como ID do cliente e Chave secreta do cliente ao criar o repositório de dados no Gemini Enterprise.
Definir a política de IP de login para o app
Os endereços IP estáticos por repositório de dados não são compatíveis com o conector do Salesforce. Em vez disso, o app cliente externo no Salesforce controla a validação do IP de login:
- Chamadas de autenticação (troca e atualização de tokens OAuth): quando um usuário autoriza o conector, o Gemini Enterprise troca e atualiza os tokens do Salesforce desse usuário nos servidores do Google. Essas solicitações não vêm dos endereços IP da sua organização. Se o app aplicar restrições de IP e os perfis dos usuários tiverem intervalos de IP de login, as solicitações serão rejeitadas e a etapa Verificar autenticação ou Autorizar vai falhar. Defina a política de Flexibilização de IP do app como Flexibilizar restrições de IP. Para o app Gemini Enterprise gerenciado peloGoogle, o Google já restringe as solicitações de token aos intervalos de IP de saída do próprio Google, e essa verificação é aplicada independentemente da configuração da política.
- Chamadas de dados: somente as solicitações de login e de token são verificadas em relação às restrições de IP. Depois que um usuário autoriza o conector, o Salesforce atende às solicitações de dados do conector com base no token de acesso válido do usuário.
Para definir a política para o app gerenciado pelo Google(ou seu próprio app cliente externo):
No Salesforce, acesse Setup.
Acesse Apps > Gerenciador de apps de cliente externo e clique em Gemini Enterprise (ou no nome do seu app de cliente externo personalizado).
Selecione a guia Políticas e clique em Editar.
Na seção Políticas do OAuth, defina Relaxamento de IP como Relaxar restrições de IP.
Clique em Salvar.
Conectar uma organização de sandbox
Um sandbox é uma organização separada do Salesforce com o próprio host do Meu Domínio, pacotes e apps instalados. Configurar a produção não configura o sandbox.
Para conectar uma organização de sandbox, ative o servidor MCP SObject All no sandbox e instale o pacote do AppExchange no sandbox (escolhendo Install in Sandbox) ou crie seu app de cliente externo no sandbox. Para saber quais configurações de repositório de dados uma conexão de sandbox exige, consulte Configurar um repositório de dados do Salesforce.
O que acontece depois de configurar o Salesforce
Configurar o app no Salesforce não conecta nada por conta própria. Ele disponibiliza o app OAuth para sua organização, de modo que usuários individuais possam autorizá-lo.
Depois que um administrador do Google Cloud criar o repositório de dados do Salesforce no
Gemini Enterprise e o conectar a um app (consulte
Configurar um repositório de dados do Salesforce),
cada usuário final (incluindo administradores que usam o app da Web) autoriza
o Gemini Enterprise a acessar o Salesforce em nome dele usando
a autenticação de usuário final por usuário. Quando um usuário consulta dados do Salesforce
pela primeira vez no app da Web do Gemini Enterprise, ele é redirecionado para a página de login do Salesforce
da sua organização, onde concede ao app os
escopos mcp_api e refresh_token. Para mais informações, consulte Autorizar o
conector.
Como cada usuário autoriza individualmente, o Gemini Enterprise acessa os registros do Salesforce com as permissões do próprio usuário. Um usuário só vê e modifica registros que já pode ver e modificar no Salesforce.
Resolver problemas
| Sintoma | Causa provável |
|---|---|
| A etapa Verificar autenticação ou Autorizar falha, ou a página de login do Salesforce informa um aplicativo cliente desconhecido, inválido ou não autorizado. | Se você usa o OAuth 2.0 (gerenciado pelo Google), verifique se o pacote gerenciado está instalado na organização exata (incluindo um sandbox) para que o URI da instância aponta. Se você usar o OAuth 2.0 (Traga
seu próprio app), verifique se o ID do cliente e a chave secreta do
cliente correspondem ao app nessa organização, se o URL de callback está definido
como https://vertexaisearch.cloud.google.com/oauth-redirect,
se os escopos mcp_api e refresh_token estão
selecionados e se a opção Exigir a extensão Proof Key for Code Exchange (PKCE)
para fluxos de autorização compatíveis está ativada. |
| Alguns usuários podem autorizar, mas outros não. | A política de Usuários permitidos do app restringe o acesso a perfis ou conjuntos de permissões específicos que não incluem esses usuários, ou a Flexibilização de IP não está definida como Flexibilizar restrições de IP. Em Configuração, abra a guia Políticas do app, clique em Editar, adicione os perfis ou conjuntos de permissões afetados (ou defina Usuários permitidos como Todos os usuários podem se autorizar) e verifique se Relaxamento de IP está definido como Relaxar restrições de IP. |
| A autorização é bem-sucedida, mas as consultas ou ações falham no app da Web do Gemini Enterprise. | Verifique as seguintes configurações no Salesforce:
|
| A autorização é bem-sucedida, mas nenhum dado do Salesforce é retornado. | O usuário autorizador pode não ter acesso no nível do registro no Salesforce. O conector respeita as permissões do usuário no Salesforce. |
A seguir
- Para criar o repositório de dados, consulte Configurar um repositório de dados do Salesforce.