Guia de Conexão do Salesforce ADO.NET

Visão Geral

Este guia descreve os requisitos do sistema e as instruções para conectar App Builder para uma fonte de dados Salesforce ADO.NET. Esta conexão faz uso de um OAuth Security Provider, com o tipo de concessão Authorization Code.

Requisitos do Sistema

Servidor de Banco de Dados

Conta Salesforce com ADO.NET

Navegador da Web do Cliente

• Chrome: 84+

• Firefox: 73+

• Safari: 13.0.1+

• Borda: 84+

Instruções de Conexão

A etapa a seguir é um pré-requisito e deve ser concluída no aplicativo Salesforce ou no ambiente sandbox.

Crie um Aplicativo OAuth Personalizado no Salesforce

1. Faça login no Salesforce .com ou no seu ambiente sandbox do Salesforce

2. Na página inicial, vá para Ferramentas da plataforma > Aplicativos > Gerenciador de aplicativos

3. Clique no botão Novo aplicativo conectado

4. Insira um Nome para exibir aos usuários quando eles efetuarem login para conceder permissões ao seu aplicativo, junto com um endereço de Email de contato

5. Clique em Ativar configurações do OAuth

6. Insira um valor no campo URL de retorno de chamada. Este deve ser o URL do seu App Builder instância com um Security Provider anexado.

   Nota

   A diferenciação entre maiúsculas e minúsculas é importante, portanto, o nome do provedor de segurança que criarmos em seguida deve corresponder à diferenciação entre maiúsculas e minúsculas no URL de retorno de chamada.

7. Escopos OAuth selecionados devem ser definidos para o escopo de permissões que o aplicativo deve solicitar do usuário.

   1. Defina como "Acesso total (full)" e "Executar solicitações a qualquer momento (refresh_token,offline_acesss)"

   

8. Clique em Gerenciar detalhes do consumidor para visualizar o valor do ID do cliente e do Segredo. Anote esses valores em um local que possa ser facilmente referenciado ao configurar a partir de App Builder.

Crie um Provedor de Segurança OAuth em App Builder

1. Configure um Provedor de Segurança em App Builder navegando até IDE > Provedores de Segurança

2. Clique no botão + Autenticação da fonte de dados

3. Forneça os seguintes detalhes:

   • Nome: Identifica o Provedor de Segurança e aparece na URL ocasionalmente. Exemplo: Salesforce

   • Tipo: OAuth

   • Tipo de autenticação: OAuth

   • Concessão OAuth: Código de autorização

   • Autenticação de cliente OAuth: Básica

   • Autenticação de recurso OAuth: Portador

   • Proprietário do Token: Usuário

   • Redirecionamento no Desafio: Verdadeiro

   

4. Clique em + Endpoints e configure os 3 registros a seguir:

   • Endpoint de autorização: https://login.salesforce.com/services/oauth2/authorize

   • Endpoint do token: https://login.salesforce.com/services/oauth2/token

   • Endpoint de informações do usuário: https://login.salesforce.com/services/oauth2/userinfo

5. Clique em + Credencial e crie o seguinte registro:

   • Tipo: Cliente

   • Nome de usuário: ID do cliente do Salesforce

   • Senha: Secreta do Salesforce

6. Clique em + Reivindicar e crie os 3 registros a seguir para provisionamento de usuários:

   • Nome: preferred_username

   • ID do nome: preferred_username

   • Endereço de email: email

Crie a Fonte de Dados Salesforce ADO.NET em App Builder

1. Vá para o App Builder IDE e clique em Servidores de Dados

2. Clique no botão + Servidor para adicionar uma nova fonte de dados

3. Atribua um Nome do Servidor. Este nome deve corresponder ao URL de retorno de chamada configurado no Salesforce. Exemplo: SalesForce

4. Selecione o Tipo como Salesforce ADO.NET

5. Expanda as Configurações de Segurança e defina o Provedor de Segurança para aquele que criamos. Exemplo: SalesForce

   

6. Por fim, se você estiver usando um ambiente sandbox do Salesforce, clique no botão Configurações avançadas e configure a URL do servidor OAuth

1. Expanda Testing e clique no botão Testar conexão para garantir que a configuração esteja funcionando conforme o esperado.

Recursos

• https://cdn.cdata.com/help/RFH/ado/pg_oauthcustomappcreate.htm