Ir para o conteúdo

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:

  1. 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

  2. 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)
  3. 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:

  1. Faça login em sua conta do Salesforce
  2. Navegue para Apps > Connected Apps > Manage Connected Apps
  3. Clique no botão Manage Consumer Details para Consumer Key and Secret
  4. 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:

  1. Faça login na instância do App Builder como administrador
  2. Navegue para o IDE
  3. Clique em Security Providers no menu Connect
  4. Clique em + Security Provider
  5. Forneça o seguinte:

    • Name: Salesforce
    • Type: Salesforce / OpenID Connect
  6. Marque o campo Enabled

  7. Selecione User como o valor Owner dos Tokens
  8. Clique no botão Save
  9. 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.
  10. 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
  11. Clique em Save e saia da tela Credential

  12. No painel Properties, clique no botão +Property para adicionar as seguintes propriedades:

    • Parameter: Scopes
    • Value: openid profile offline_access api
  13. Clique em Salvar e saia da tela Propriedades

  14. 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
  15. 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
  16. Clique em Salvar

Registrar Salesforce como servidor de fonte de dados

Para registrar o Salesforce como servidor de fonte de dados:

  1. Faça login na instância do App Builder como administrador
  2. Navegue até o IDE
  3. Clique no botão Servidores de Dados no menu Conectar
  4. Clique em + Servidor para registrar um novo servidor
  5. Forneça o seguinte:

    • Nome do Servidor: Um nome identificável. Por exemplo: Aplicativo Conectado do Salesforce
    • Tipo: Salesforce ADO.NET
  6. Clique no botão Configurações Avançadas

  7. 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

  8. Clique em Salvar e volte para a tela de configurações do Servidor

  9. Expanda Configurações de Segurança e selecione Salesforce como Provedor de Segurança
  10. Clique em Salvar
  11. 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."