Provedor de segurança Salesforce / OpenID Connect no Jitterbit App Builder
Nota
Este guia de conexão é o processo recomendado para autenticação de usuário entre o App Builder e o Salesforce. Consulte o guia de conexão JWT OAuth do Salesforce se você está procurando configurar autenticação de Conta de Serviço.
O provedor de segurança Salesforce / OpenID Connect (SF/OIDC) é uma implementação específica do fornecedor do provedor de segurança OpenID Connect. A implementação do Salesforce permite que o App Builder autentique usuários do Salesforce. Também pode ser usado para autorizar solicitações aos seguintes servidores de dados:
- Salesforce ADO.NET
- REST
Limitações
- O provedor de segurança SF/OIDC não pode ser usado com servidores de dados Salesforce1 Platform
- O provedor de segurança SF/OIDC não oferece suporte ao parâmetro ReplaceIssuerTenantId
Configurar no Salesforce
Para começar, você precisará fazer login em sua conta do Salesforce e criar um Aplicativo Conectado.
Na tela Manage Connected Apps do Salesforce:
-
Forneça o valor da Callback URL. Esta é a URL invocada após a autorização OAuth para o aplicativo conectado do consumidor. Este é o diretório raiz do App Builder/signin-[Scheme of Security Provider].
Por exemplo:https://example.com/Vinyl/signin-Salesforce -
Adicione os seguintes Available OAuth Scopes à lista Selected OAuth Scopes:
- Access the identity URL service (id, profile, email, address, phone)
- Access unique user identifiers (openid)
- Full access (full)
- Manage user data via APIs (api)
- Perform requests at any time (refresh_token, offline_access)
-
Certifique-se de que as seguintes opções estão ativadas:
- Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows
- Require Secret for Web Server Flow
- Require Secret for Refresh Token Flow
- Enable Client Credentials Flow
A Consumer Key e a Consumer Secret do Aplicativo Conectado do Salesforce são obrigatórias para a configuração do App Builder. Certifique-se de ter esses valores à mão para consultar.
Para obter as credenciais do aplicativo conectado do Salesforce:
- Faça login em sua conta do Salesforce
- Navegue para Apps > Connected Apps > Manage Connected Apps
- Clique no botão Manage Consumer Details para Consumer Key and Secret
- Copie os valores de Consumer Key e Consumer Secret
Configurar o Salesforce como um provedor de segurança no App Builder
O provedor de segurança SF/OIDC requer:
- Credenciais de cliente (Consumer Key e Consumer Secret)
Para configurar o provedor de segurança do Salesforce:
- Faça login na instância do App Builder como administrador
- Navegue para o IDE
- Clique em Security Providers no menu Connect
- Clique em + Security Provider
-
Forneça o seguinte:
- Name: Salesforce
- Type: Salesforce / OpenID Connect
-
Marque o campo Enabled
- Selecione User como o valor Owner dos Tokens
- Clique no botão Save
- No painel Endpoints, o App Builder fornece endpoints padrão e nenhuma configuração adicional é necessária, a menos que você deseje substituir o padrão. O valor padrão de OpenID Connect Issuer é
https://login.salesforce.com. -
No painel Credentials, clique no botão + Credential para adicionar a seguinte credencial:
- Type: Client
- User Name: forneça a Salesforce Consumer Key
- Password: forneça a Salesforce Consumer Secret
-
Clique em Save e saia da tela Credential
-
No painel Properties, clique no botão +Property para adicionar as seguintes propriedades:
- Parameter: Scopes
- Value:
openid profile offline_access api
-
Clique em Salvar e saia da tela Propriedades
-
Clique em + Declaração no painel Declarações e adicione o seguinte:
- Identificador:
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name - Uso: Nome
- Identificador:
-
Clique em Salvar e adicione um registro de Declarações adicional:
- Identificador:
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier - Uso: ID do Nome
- Identificador:
-
Clique em Salvar
Registrar Salesforce como servidor de fonte de dados
Para registrar o Salesforce como servidor de fonte de dados:
- Faça login na instância do App Builder como administrador
- Navegue até o IDE
- Clique no botão Servidores de Dados no menu Conectar
- Clique em + Servidor para registrar um novo servidor
-
Forneça o seguinte:
- Nome do Servidor: Um nome identificável. Por exemplo: Aplicativo Conectado do Salesforce
- Tipo: Salesforce ADO.NET
-
Clique no botão Configurações Avançadas
-
Forneça as informações do servidor OAuth no campo Avançado:
https://<sua instância>.salesforce.com/services/Soap/c/56.0/<seu ID da organização>
Para encontrar sua instância, faça login no Salesforce e a URL começará com a instância correta.
O ID da organização pode ser encontrado seguindo este artigo do Salesforce: Encontrar sua ID de Organização do Salesforce -
Clique em Salvar e volte para a tela de configurações do Servidor
- Expanda Configurações de Segurança e selecione Salesforce como Provedor de Segurança
- Clique em Salvar
-
Expanda Testes e clique no botão Testar Conexão
- Clique no botão Prosseguir para confirmar. Se todas as informações estiverem configuradas corretamente, você receberá a mensagem "O teste de conexão passou."