Auth code errors
Errors returned in browser
If the redirect URI parameter is missing, or the redirect URI does not match one of the registered redirect URLs for the application, the user is not redirected back to your application (as this would leave your application vulnerable to an open redirector attack). Instead, a Bad Request error is displayed to the user, similar to the image below.
Example
HTTP Code/Error | Error Description | Possible issue |
200 | No "connector" returns an incorrect login screen | |
400 Bad Request | Unregistered redirect_uri (e.g. https://wrong/v1/callback) | The redirect_uri is incorrect or not registered |
400 Bad Request | Invalid ConnectorID | The providerId is incorrect |
400 Bad Request | Invalid client_id ("client_id"). | The clientId is incorrect |
400 Bad Request | Requested resource does not exist | Verify your clientId. If it is correct, please contact Akoya. |
404/500 | 404 and 500 server errors do not return custom messaging to the browser. | |
501 | 501 errors, subsystem is unavailable or temporarily unavailable |
Error codes returned in URL (invalid parameters)
For other errors, the server will redirect the application to the redirect URI. It will include an error in the query string matching the types below:
Example
"error" | "error_description" | Possible issue |
invalid_request | Invalid+response+type | The request is missing a parameter, contains an invalid parameter, includes a parameter more than once, or is otherwise invalid. |
invalid_scope | Missing+required+scope | The requested scope is invalid or unknown. |
access_denied | The user or authorization server denied the request. | |
unauthorized_client | The client is not allowed to request an authorization code using this method. | |
unsupported_response_type | Set the response_type in authorizationURL to 'code'. | |
server_error | Instead of displaying a 500 Internal Server error page to the user, the server can redirect with this error code. | |
temporarily_unavailable | If the server is undergoing maintenance, or is otherwise unavailable, this error code can be returned instead of responding with a 503 Service Unavailable status code. |