Salesforce. Guia de Conexão NET¶

Visão Geral¶

Este guia descreve os requisitos do sistema e as instruções para conectar o Vinyl a uma fonte de dados ADO.NET do Salesforce. Esta conexão utiliza um Provedor de Segurança OAuth, com o tipo de concessão Código de Autorização.

Para conectar seus servidores, você deve ter o Vinyl 3.3+ instalado.

Requisitos de Sistema¶

Servidor de Banco de Dados¶

Conta Salesforce com ADO.NET

Navegador da Web do Cliente¶

• Chrome: 84+

• Firefox: 73+

• Safari: 13.0.1+

• Edge: 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 em Salesforce .com ou em 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 fizerem login para conceder permissões ao seu aplicativo, junto com um endereço de Email de contato

5. Clique em Ativar configurações de OAuth

6. Insira um valor no campo URL de retorno de chamada. Este deve ser o URL da sua instância do Vinyl com um provedor de segurança anexado.

   Nota

   A distinção entre maiúsculas e minúsculas é importante, portanto, o nome do provedor de segurança que criaremos a seguir deve corresponder à distinçã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 (completo)" e "Executar solicitações a qualquer momento (refresh_token,offline_acesss)"

   

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

Crie um Provedor de Segurança OAuth em Vinyl¶

1. Configure um provedor de segurança no Vinyl navegando até IDE > Security Providers

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

   • Redirecionar 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: Segredo do Salesforce

6. Clique em + Reivindicação e crie os três registros a seguir para provisionamento de usuários:

   • Nome: nome_de_usuario_preferencial

   • ID do nome: nome_usuário_preferencial

   • Endereço de email: email

Crie a Fonte de Dados Salesforce ADO.NET no Vinyl¶

1. Acesse Vinyl IDE e clique em Data Servers

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

3. Atribua um Nome de servidor. Esse nome deve corresponder ao URL de retorno de chamada configurado no Salesforce. Exemplo: SalesForce

4. Selecione Tipo como Salesforce ADO.NET

5. Expanda Configurações de segurança e defina Provedor de segurança como aquele que criamos. Exemplo: SalesForce

   

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

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

Recursos¶

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