Login - Neuron Agent API

Overview

Authenticates a user and returns a JWT. This method is intended for programmatic clients and is an alternative to browser-based login flows.

POST /Agent/Account/Login

Sign the request using HMAC-SHA256 with the account password as the key. Signature message:

userName:host:nonce

{
  "userName": "alice",
  "nonce": "random-unique-string-at-least-32-chars",
  "signature": "base64-hmac",
  "seconds": 3600
}

Field	Type	Required	Description
`userName`	string	yes	Username to authenticate.
`nonce`	string	yes	Unique random string (minimum 32 chars).
`signature`	string	yes	HMAC signature of the request.
`seconds`	number	yes	JWT lifetime in seconds (`0 < seconds <= 3600`).

{
  "jwt": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires": "2024-08-02T11:22:11Z"
}

Field	Type	Description
`jwt`	string	JWT bearer token.
`expires`	string	JWT expiration timestamp.