Traduzido por IA. Ainda não revisado pela comunidade. Ler em inglês

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

Guia passo a passo: configurar um aplicativo conectado no Salesforce para uma integração OAuth simples

Bem-vindo a este guia de configuração de um aplicativo conectado no Salesforce para uma integração OAuth sem atritos. Neste tutorial passo a passo, você vai aprender o básico de como configurar um aplicativo conectado no Salesforce e acessá-lo pela API com o Postman. Vamos mergulhar no OAuth e começar a configurar um aplicativo conectado.

Passo 1: criar um novo aplicativo conectado

Ir ao Gerenciador de aplicativos: primeiro, abra o Gerenciador de aplicativos no Salesforce.

Habilitar o acesso à API: para que aplicativos externos acessem pela API, crie um novo aplicativo conectado e chame-o de “App One”.

Configurar o aplicativo: informe um e-mail para o aplicativo e habilite as configurações de OAuth. Alguns fluxos OAuth exigem uma URL de retorno de chamada (falaremos disso em guias futuros); por enquanto, coloque um valor provisório como “www.salesforce.com” (opens in a new tab).

Captura de tela: criação de um novo aplicativo conectado no Gerenciador de aplicativos, com as configurações de OAuth habilitadas Captura de tela: escolha dos escopos OAuth do aplicativo conectado e definição da URL de retorno de chamada

Passo 2: definir os escopos OAuth

Os escopos definem quais capacidades ficam acessíveis pela API. Para este tutorial:

Gerenciar dados de usuário: atribua o escopo que permite gerenciar dados de usuário pela API.

Salvar e aguardar: salve as configurações e aguarde cerca de 10 minutos até o processo terminar.

Passo 3: obter os detalhes do consumidor

Em seguida, você 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 do “App One”.

Passo 4: autenticar com o Postman

Captura de tela 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 usuário e a senha aos parâmetros e então faça um POST no endpoint OAuth para se autenticar.

Passo 5: token de acesso e consultas

Depois de autenticar com sucesso:

Receber o token de acesso: você 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 tela do Postman: uma consulta REST com o token de acesso no cabeçalho Authorization, devolvendo registros em JSON

Executar consultas: com o token incluído, envie a requisição para executar consultas e buscar dados.

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

Agora você pode usar a versão de endpoint do seu aplicativo conectado (por exemplo, a versão 58) para buscar dados. Essa 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

Você configurou um aplicativo conectado no Salesforce e o autenticou via OAuth para acesso à API pelo Postman. Este guia cobre o básico; outros tutoriais vão apresentar fluxos OAuth e recursos adicionais para ampliar seu aplicativo.

Fique de olho

Comece 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). Inscreva-se e aprofunde seu entendimento do Salesforce e de como integrá-lo a outros sistemas.

Ajudando a mudar o mundo compartilhando 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