Era.Common.NetworkMessage.ConsoleApi.SessionManagement.RpcAuthGrpcLoginRequest

Description

Authenticates a user for current connection and creates a new session. After successful call, the user is authenticated for this network connection and may send requests corresponding to the user's access rights.

Properties

Name JsonSchemaType Description
connectedFrom reference to Era.Common.DataDefinition.Network.Connection The address, from which the user connected. This information is not used during authentication, but may be logged and displayed to the user.
isDomainUser boolean Set to false for native users, true for domain users.
locale string Locale to be used for the new session. 4-letter ISO codes should be used, e.g. en_US.
loginOneTimeToken string This is alternative to username, password. You can use this to login, this token was retrieved by RpcGenerateLoginOneTimeToken. If this is set username and password are ignored however they must be set to empty string (because of the required specifier)
password string User password.
userAgent string User Agent that represents a client (e.g.: web browser).
username string User login.

Dual message (request/response)

Era.Common.NetworkMessage.ConsoleApi.SessionManagement.RpcAuthGrpcLoginResponse

Referenced in messages

No references.

JsonSchema

{
    "title": "Era.Common.NetworkMessage.ConsoleApi.SessionManagement.RpcAuthGrpcLoginRequest",
    "type": "object",
    "$schema": "http://json-schema.org/draft-04/schema#",
    "additionalProperties": false,
    "required": [
        "Era.Common.NetworkMessage.ConsoleApi.SessionManagement.RpcAuthGrpcLoginRequest"
    ],
    "properties": {
        "Era.Common.NetworkMessage.ConsoleApi.SessionManagement.RpcAuthGrpcLoginRequest": {
            "$ref": "#/definitions/RpcAuthGrpcLoginRequest"
        }
    },
    "definitions": {
        "RpcAuthGrpcLoginRequest": {
            "additionalProperties": false,
            "required": [
                "isDomainUser",
                "locale",
                "password",
                "username"
            ],
            "type": "object",
            "properties": {
                "connectedFrom": {
                    "$ref": "Era.Common.DataDefinition.Network.Connection#/definitions/Connection"
                },
                "isDomainUser": {
                    "type": "boolean"
                },
                "locale": {
                    "type": "string"
                },
                "loginOneTimeToken": {
                    "type": "string"
                },
                "password": {
                    "type": "string"
                },
                "userAgent": {
                    "type": "string"
                },
                "username": {
                    "type": "string"
                }
            }
        }
    }
}