package auth

Get desktop application:
View/edit binary Protocol Buffers messages

A authentication message

Used in: meta.NetworkMessage

• oneof msg

  The inner message type

  • NameMessage name = 1

    Send the name

  • ServerStatus server_status = 2

    Send the status

  • ClientStatus client_status = 3

    Send the client status

  • Challenge server_challenge = 4

    Server's challenge to the client

  • ChallengeReply client_challenge = 5

    Client's reply to server's challenge and client's own challenge to the server

  • ChallengeAck server_ack = 6

    Server's reply to the client's challenge

The server's initial challenge request

Used in: AuthenticationMessage

• string name = 1

  The server's name

• optional NodeFlags flags = 2

  The node's capability flags

• uint32 challenge = 3

  The challenge value

• string connection_string = 4

  The node's incoming connection string

The server's reply to the client about their own challenge

Used in: AuthenticationMessage

• bytes digest = 1

  Another MD5 digest that the server constructed from the client's challenge value

The reply to the server's challenge.

Used in: AuthenticationMessage

• uint32 challenge = 1

  The client's own challenge for the server to handle

• bytes digest = 2

  An MD5 digest that the client constructed from the server's challenge value

The client's status reply if the `ServerStatus` was ALIVE If status was alive, node A answers with another status message containing either true, which means that the connection is to continue (the old connection from this node is broken), or false, which means that the connection is to be closed (the connection attempt was a mistake.

Used in: AuthenticationMessage

• bool status = 1

  The status

A message containing the node's name

Used in: AuthenticationMessage, control.ControlMessage, control.NodeSessions

• string name = 1

  The node's full name Format: `node_name@hostname`

• optional NodeFlags flags = 2

  The node's capability flags

• string connection_string = 3

  This node's connection details

Placeholder to represent a node's flags

Used in: Challenge, NameMessage

• uint32 version = 1

  The node version

Server -> Client: `SendStatus` is the server replying with the handshake status to the client

Used in: AuthenticationMessage

• ServerStatus.Status status = 1

  The status

Status types

Used in: ServerStatus

• OK = 0

  The handshake will continue

• OK_SIMULTANEOUS = 1

  The handshake will continue, but A is informed that B has another ongoing connection attempt that will be shut down (simultaneous connect where A's name is greater than B's name, compared literally).

• NOT_OK = 2

  The handshake will not continue, as B already has an ongoing handshake, which it itself has initiated (simultaneous connect where B's name is greater than A's).

• NOT_ALLOWED = 3

  The connection is disallowed for some (unspecified) security reason.

• ALIVE = 4

  A connection to the node is already active, which either means that node A is confused or that the TCP connection breakdown of a previous node with this name has not yet reached node B.