Traduzido com IA. Ainda não revisto pela comunidade. Ler em inglês

Blog · 3 de outubro de 2023 · Steve Simpson · Identidade

Guia passo a passo: configurar uma aplicação ligada no Salesforce para uma integração OAuth simples

Bem-vindo a este guia de configuração de uma aplicação ligada no Salesforce para uma integração OAuth sem atritos. Neste tutorial passo a passo, vai aprender o básico de como configurar uma aplicação ligada no Salesforce e aceder-lhe pela API com o Postman. Vamos mergulhar no OAuth e começar por configurar uma aplicação ligada.

Passo 1: criar uma nova aplicação ligada

Ir ao Gestor de aplicações: primeiro, abra o Gestor de aplicações no Salesforce.

Ativar o acesso à API: para que aplicações externas acedam pela API, crie uma nova aplicação ligada e chame-lhe «App One».

Configurar a aplicação: indique um e-mail para a aplicação e ative as definições de OAuth. Alguns fluxos OAuth exigem um URL de retorno de chamada (falaremos disso em guias futuros); por agora, coloque um valor provisório como «www.salesforce.com» (opens in a new tab).

Captura de ecrã: criação de uma nova aplicação ligada no Gestor de aplicações, com as definições de OAuth ativadas Captura de ecrã: escolha dos âmbitos OAuth da aplicação ligada e definição do URL de retorno de chamada

Passo 2: definir os âmbitos OAuth

Os âmbitos (scopes) definem que capacidades ficam acessíveis pela API. Para este tutorial:

Gerir dados de utilizador: atribua o âmbito que permite gerir dados de utilizador pela API.

Guardar e aguardar: guarde as definições e aguarde cerca de 10 minutos até o processo terminar.

Passo 3: obter os detalhes do consumidor

Em seguida, vai precisar de duas informações importantes e não públicas: a chave do consumidor (Consumer Key) e o segredo do consumidor (Consumer Secret). Clique em cada botão para se autenticar e obter esses detalhes da «App One».

Passo 4: autenticar com o Postman

Captura de ecrã do Postman: um POST para o endpoint de token OAuth do Salesforce que devolve um token de acesso

Iniciar uma chamada POST: no Postman, crie uma chamada POST para o servidor OAuth em «login.salesforce.com/services/oauth2/token».

Definir os parâmetros: no corpo, inclua os parâmetros, entre eles grant type (password), client ID (a chave do consumidor) e o Client Secret.

Incluir as credenciais: acrescente o nome de utilizador e a palavra-passe aos parâmetros e depois faça um POST no endpoint OAuth para se autenticar.

Passo 5: token de acesso e consultas

Depois de se autenticar com sucesso:

Receber o token de acesso: recebe um token de acesso, necessário para fazer chamadas à API.

Incluir o token: no Postman, na sua consulta, coloque o token de acesso na linha Authorization do cabeçalho, precedido de «Bearer».

Captura de ecrã do Postman: uma consulta REST com o token de acesso no cabeçalho Authorization, a devolver registos em JSON

Executar consultas: com o token incluído, envie o pedido para executar consultas e obter dados.

Passo 6: versões de endpoint e próximos passos

Agora pode usar a versão de endpoint da sua aplicação ligada (por exemplo, a versão 58) para obter dados. Esta configuração básica não cobre todos os outros elementos de fluxo ou retornos de chamada, mas é um primeiro passo na integração OAuth com o Postman e o Salesforce.

Conclusão e próximos passos

Configurou uma aplicação ligada no Salesforce e autenticou-a via OAuth para acesso à API através do Postman. Este guia cobre o básico; outros tutoriais vão apresentar fluxos OAuth e recursos adicionais para alargar a sua aplicação.

Fique atento

Comece a sua jornada pelas APIs do Salesforce com confiança! Para mais ideias e dicas, acompanhe aqui em www.SteveTechArc.com e no canal do YouTube @SteveTechArc (opens in a new tab). Subscreva e aprofunde o seu entendimento do Salesforce e de como integrá-lo com outros sistemas.

A ajudar a mudar o mundo, partilhando conhecimento sobre integração com outros arquitetos e com quem está na jornada para se tornar um!

Transcrição feita com a ajuda de IA

STA 3.11