Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

...

Anchor
Authentication
Authentication
Authentication
 

Description

This response type is returned when an error occurs with any command type.

Response

 

Pass client credentials to the server's security manager.  Credentials are passed in as key, value pairs of strings and are interpreted by the security manager on the server.  For a default Shiro security manager, the credentials might be as simple as 

Pre
{{"user", "bob"}, {"password", "bobspassword"}}


Request

AuthenticationRequestErrorResponse
Field NameData typeDescriptionMandatory?
errorCodecredentialsIntAn Integer representing the error code for a specific errorY
errorMessageStringA description of the error.N

Possible Errors

...

map<string,string>A set of key, value properties defined by the server's security managerY

Response 

AuthenticationResponse
Field NameData typeDescriptionMandatory?
authenticatedbooleanWhether authenticated succeeded.Y

Expected behavior 

  • If authentication is required, after the connection has completed handshaking, any request other than authentication will fail with an AUTHENTICATION_FAILED error.

  • Once a connection is authenticated with user credentials, any operations that user doesn't have permission for will fail with AUTHORIZATION_FAILED.
  • It's not possible to change the credentials associated with a connection. Changing credentials requires creating a new connection.

Errors

There was an error whilst decoding a data entry (key / value)
Error Code
Error Definition
Error Description
13001103LOW
UNSUPPORTED_AUTHENTICATION_
MEMORY
Server does not have enough free memory to complete the operation
1000UNCLASSIFIED_FAILUREThis error will be thrown as a last resort if an exception cannot be classified. This error will then have to be investigated and correctly classified
1100ENCODING_ERRORThere was an error whilst encoding a data entry (key / value)
MODE
The server's security manager is not compatible with protobuf authentication
1202
ALREADY_AUTHENTICATED
The connection has already been authenticated
1203
AUTHENTICATION_NOT_SUPPORTED
The server doesn't support authentication DECODING_ERROR