Integrando com salesforce via Rest + OAuth 2.0

Diéffrei Quadros
2 min readOct 28, 2017

--

Integrar com salesforce não é uma tarefa difícil existem várias formas de se fazer isso, as formas mais populares são via SOAP ou REST.

Antes de consumir maior parte de qualquer serviço rest no salesforce você precisa se autenticar (exceto que você tenha um rest service público), para autenticar usamos OAuth, e para usar OAuth precisamos cadastrar uma Connected App e é por meio dela que estaremos nos conectando.

Connected Apps possibilitam uma forma robusta de se conectar ao salesforce, primeiro porque implementa o OAuth 2.0 (padrão largamente utilizado hoje em dia), e segundo por adicionar um camada de controle, que nos possibilita controlar quem pode usar aplicação e entre outras políticas de segurança.

Dois conceitos muito importantes que você precisa saber:

Autenticação: Quem é você (Suas credenciais)
Autorização: O que você pode acessar (Recursos)

Criando minha primeira Connected App

Para criar uma connected app, basta ir até o menu de configurações e procurar por App Manager
Uma vez acessando essa página clique em New Connected App.
Após isso a primeira seção é bem fácil informe os dados básicos.
(Até aqui nada de complexo)

Informações básicas

Agora sim vamos ao que interessa;
Começamos marcando o checkbox Enable OAuth Settings.

Preencha o campo Callback URL, esse é o campo que o salesforce vai redirecionar passando o access_token (ele vai ter o papel como o sessionId) para sua aplicação caso você utilize o fluxo Web Server.

(Aqui vai uma dica, caso você utilize algum fluxo que não utilize callback url (ex. username-password flow), você pode informar qualquer url como por exemplo a do tooltip: https://login.salesforce.com/services/oauth2/callback).

Passando para o próximo campo note que eu tenho marcado o checkbox Use digital signature.
Se você marcar, você vai precisar enviar um certificado, ele é utilizado quando for utilizar autenticação usando JWT, o certificado vai funcionar como a sua senha.
(A criação de um certificado é extremamente fácil, clique aqui para saber como criar o seu).

E por fim Selected OAuth Scopes, aqui basicamente você vai informar quais recursos sua aplicação vai ter acesso.

Basicamente com essas informações você já pode começar a integrar sua aplicação com salesforce.

Após o cadastro você deve utilizar um dos fluxos de autenticação disponíveis via OAuth:

Username-Password
SAML
Web Server
JWT

--

--