Fluxo de credenciais do cliente OAuth 2.0 para integração entre servidores

Solicitar uma chave de acesso

Vamos analisar o processo de obter um token de acesso com o fluxo de credenciais do cliente.

Para iniciar o fluxo, o aplicativo cliente externo publica suas credenciais de cliente no ponto de extremidade do token do Salesforce. Você pode incluir as credenciais do cliente como parâmetros no corpo da solicitação. Ou, para segurança adicional, coloque suas credenciais de cliente em um cabeçalho de Autorização básica.

Importante Ao desenvolver integrações do OAuth, sempre passe informações confidenciais no corpo de uma solicitação POST ou em um cabeçalho da solicitação. Não use parâmetros GET na string de consulta de URL para passar informações confidenciais. As informações confidenciais incluem, entre outros, nomes de usuário, senhas, tokens OAuth, segredos do cliente e quaisquer informações de identificação pessoal. Para obter mais informações sobre as melhores práticas de segurança, consulte Armazenamento de dados confidenciais no Guia de codificação segura.

Aqui está um exemplo de solicitação de POST com as credenciais de clientes no corpo da solicitação.

POST /services/oauth2/token HTTP/1.1
Host: MyDomainName.my.salesforce.com
grant_type=client_credentials&
client_id=*******************&
client_secret=*******************

Para esse fluxo, não há suporte para solicitações para https://login.salesforce.com e https://test.salesforce.com. Em vez disso, use seu URL do Meu domínio. Para localizar seu URL do Meu domínio, em Configuração, na caixa Busca rápida, insira Meu domínio e selecione Meu domínio.

Esses parâmetros devem ser incluídos na solicitação.

Aqui está um exemplo com as credenciais do cliente em um cabeçalho de autorização Básica. Com esse formato, o client_id é anexado ao client_secret no formato client_id:client_secret, e o valor resultante é codificado em Base64.

POST /services/oauth2/token HTTP/1.1
Host: MyDomainName.my.salesforce.com
Header: Authorization: Basic 
TXlDbGllbnRJRDpNeUNsaWVudFNlY3JldA==
grant_type=client_credentials

Se você usar esse formato, o grant_type será o único parâmetro necessário no corpo da solicitação. O grant_type deve ser definido como client_credentials.

Nota Uma vez que o Salesforce não oferece suporte a escopos no ponto de extremidade do token, você não pode incluir escopos na solicitação. Em vez disso, atribua escopos ao seu aplicativo cliente externo.

O Salesforce concede um token de acesso

Depois de validar as credenciais do cliente, o Salesforce retorna uma resposta contendo um token de acesso e os escopos solicitados. O aplicativo pode usar o token de acesso para acessar dados protegidos no Salesforce.

{
    "access_token": "*******************",
    "instance_url": "https://yourInstance.salesforce.com",
    "id": "https://login.salesforce.com/id/XXXXXXXXXXXXXXXXXX/XXXXXXXXXXXXXXXXXX",
    "token_type": "Bearer",
    "scope": "id api",
    "issued_at": "1657741493799",
    "signature": "c2lnbmF0dXJl"
}

Esses parâmetros são incluídos na resposta de exemplo.