Erros de autorização do OAuth 2.0
Podem ocorrer erros durante a autorização do OAuth. Por exemplo, um usuário nega o acesso ao aplicativo conectado ou os parâmetros da solicitação estão incorretos. Quando ocorrem erros, o servidor responsável pela autorização envia um erro ao URL de retorno com um código de erro.
Edições obrigatórias
| Disponível em: Salesforce Classic e Lightning Experience |
| Disponível em: Todas as edições |
Erros de autorização do OAuth têm formatos diferentes dependendo do fluxo de autorização. Aqui estão exemplos de cada um dos fluxos do OAuth com suporte.
- Esse erro é de um fluxo de servidor web OAuth 2.0, em que o usuário negou acesso ao aplicativo conectado:
https://www.mycustomerorderstatus/code_callback.jsp?error=access-denied - Aqui está o mesmo erro de um fluxo de usuário-agente do OAuth 2.0:
https://www.customercontactinfo.com/user_callback.jsp#error=access_denied - Se houver um erro no fluxo do portador JWT do OAuth 2.0, o servidor responsável pela autorização responderá com uma resposta de erro padrão do OAuth. A resposta inclui os motivos pelos quais o token é considerado inválido. Para obter mais informações, consulte https://tools.ietf.org/html/rfc7523. Este exemplo mostra uma resposta de erro de exemplo no formato JSON.
HTTP/1.1 400 Bad Request Content-Type: application/json Cache-Control: no-store { "error":"invalid_grant", "error_description":"Audience validation failed" } - A seguir, há um exemplo de um erro retornado de um fluxo de token de atualização do OAuth 2.0.
{"error":"invalid_grant","error_description":"expired access/refresh token"} - Essa resposta de erro de exemplo ocorreu ao processar a declaração do portador SAML.
HTTP/1.1 400 Bad Request Content-Type: application/json Cache-Control: no-store { "error":"invalid_grant", "error_description":"Audience validation failed" } -
Aqui está um exemplo de erro de um fluxo de declaração SAML. Esse fluxo inclui um URI de erro, que é um link para o Validador de declaração SAML. O validador contém mais informações sobre a falha. O URI será retornado apenas quando o Salesforce puder analisar a declaração.
{"error_uri":"https://yourInstance.salesforce.com/setup/secur/SAMLValidationPage.apexp", "error":"invalid_grant","error_description":"invalid assertion"}
Códigos de erro
Para ajudar a solucionar o motivo do erro, revise os seguintes códigos de erro e causas.
| Erro | Causa |
|---|---|
access_denied
|
O usuário negou acesso ao aplicativo cliente. |
authorization_pending
|
Para o fluxo do dispositivo, o usuário ainda não aprovou o dispositivo para acesso. |
CSRF
|
O Salesforce detectou um possível ataque de Solicitação de falsificação entre sites (CSRF). Não conseguimos verificar se a solicitação de login veio do domínio correto. |
ERROR_CREATING_USER
|
Um destes cenários ocorreu.
|
immediate_unsuccessful
|
O parâmetro immediate é definido como true, e o usuário não está conectado ou não aprovou anteriormente o acesso do cliente. |
inactive_org
|
A organização está bloqueada, fechada ou suspensa. |
inactive_user
|
O usuário está definido como ativo pelo administrador da organização. |
invalid_app_access
|
O usuário não é aprovado por um administrador para acessar esse aplicativo. |
invalid_assertion_type
|
Não há suporte para o tipo de declaração especificado. |
invalid_client
|
O segredo do cliente é inválido. |
invalid_client_id
|
O identificador do cliente é inválido. |
invalid_grant
|
Uma das seguintes:
|
invalid_request
|
Um dos erros a seguir.
|
invalid_scope
|
O escopo solicitado é inválido, desconhecido ou mal formado. |
NO_ACCESS
|
Não é possível localizar um usuário. Por exemplo, não há um nome de usuário. |
No_OAuth_State
|
O estado do OAuth foi adulterado ou está ausente. |
No_Openid_Response
|
O URL do ponto de extremidade de informações do usuário é inválido. |
rate_limit_exceeded
|
Número de tentativas de login foi excedido. |
redirect_uri_mismatch
|
Incompatibilidade do URI de redirecionamento com a definição do aplicativo conectado. |
redirect_uri_missing
|
URI de redirecionamento não fornecido. |
REGISTRATION_HANDLER_ERROR
|
Para provedores de autenticação, há um problema com o Apex code do manipulador de registro. |
server_error
|
A quantidade de solicitações de autorização do aplicativo cliente excede o limite por hora. |
slow_down
|
Para o fluxo de dispositivo, o aplicativo cliente está pesquisando o servidor de autorização com mais frequência do que o intervalo mínimo recomendado. |
unsupported_response_type
|
Não há suporte para o tipo de resposta solicitado. |

