Skip to content
Last updated
Edit

Login Error Codes

Unstoppable Login uses the OAuth 2.0 framework. The error codes below are based on that framework and only include codes specific to the Login feature.

400 Error: Bad Request

These errors are the most common and are generally perceived as client errors (e.g., malformed syntax, invalid request parameters, etc.).

Error CodeDescription
invalid_request

The request is missing a required parameter, includes an invalid parameter value, includes a parameter more than once, or is otherwise malformed.

Ensure the various parameters are correct, be aware of case sensitivity, and trim the parameters. Ensure that the client being used has added the specified redirect_url to its allowlist.

unauthorized_client

The client is not authorized to request a token using this method.

Make sure that client id and secret are correctly specified and that the client exists.

unsupported_response_typeThe authorization server does not support obtaining a token using this method.
unsupported_response_modeThe authorization server does not support obtaining a response using this response mode.
invalid_scope

The requested scope is invalid, unknown, malformed, or exceeds the scope granted by the resource owner.

Make sure that the requested scope has been previously configured inside the client's configuration (inside the advanced section).

unsupported_grant_typeThe authorization grant type is not supported by the authorization server.
invalid_grantThe provided authorization grant (e.g., authorization code, resource owner credentials) or refresh token is invalid, expired, revoked, does not match the redirection URI used in the authorization request, or was issued to another client.
invalid_stateThe state is missing or does not have enough characters and is therefore considered too weak.
insufficient_entropyThe request used a security parameter (e.g., anti-replay, anti-csrf) with insufficient entropy.
invalid_tokenInvalid token format. Ensure that a valid token has been provided in the right format.
login_requiredThe Authorization Server requires End-User authentication. This error MAY be returned when the prompt parameter value in the Authentication Request is none. Still, you cannot complete the Authentication Request without displaying a user interface for End-User authentication.
interaction_requiredThe Authorization Server requires End-User interaction of some form to proceed. This error MAY be returned when the prompt parameter value in the Authentication Request is none. Still, you cannot complete the Authentication Request without displaying a user interface for End-User interaction.
consent_requiredThe Authorization Server requires End-User consent. This error MAY be returned when the prompt parameter value in the Authentication Request is none. Still, you cannot complete the Authentication Request without displaying a user interface for End-User consent.
request_not_supportedThe OpenID Connect Provider (OP) does not support using the request parameter.
request_uri_not_supportedThe OpenID Connect Provider (OP) does not support using the request_uri parameter.
invalid_request_uriThe request_uri in the Authorization Request returns an error or contains invalid data.
invalid_request_objectThe request parameter contains an invalid Request Object.
jti_knownThe jti was already used.
errorThe handler is not responsible for this request.

401 Error: Unauthorized

These errors are the second-most common and generally occur when either the user or the client lacks valid authentication credentials to perform.

Error CodeDescription
token_inactiveToken is inactive because it is malformed, expired, or invalid. Token validation failed.
invalid_tokenThe token expired.
request_unauthorizedThe request could not be authorized. Ensure that valid credentials are provided in the correct format.
invalid_clientClient authentication failed (e.g., unknown client, no client authentication included, or unsupported authentication method). The authorization server MAY return an HTTP 401 (Unauthorized) status code to indicate which HTTP authentication schemes are supported.

403 Error: Forbidden

Error CodeDescription
scope_not_grantedYou did not grant the token the requested scope. The resource owner did not grant the requested scope.
access_denied

The resource owner or authorization server denied the request.

Make sure that the request is valid. Maybe the credential or request parameters being used are limited in scope or otherwise restricted.

request_forbiddenThe request is not allowed. This action is not allowed to be performed.

404 Error: Resource Not Found

Error CodeDescription
not_foundCould not find the requested resource(s).

500 Error: Internal Server Error

Error CodeDescription
misconfigurationThe request failed because of an internal error that is probably caused by misconfiguration.
server_errorThe authorization server encountered an unexpected condition that prevented it from fulfilling the request.

503 Error: Service Unavailable

Error CodeDescription
temporarily_unavailableThe authorization server cannot handle the request due to the server's temporary overloading or maintenance.