/api/login/password/:token

Answer the prompt of the password stage

For more information see  Login process state machine and /api/login

Method

POST

Parameters

  • password — ssh password

Result

JSON object.  The object contains different members depending on the authentication stage.  Authentication has not completed until the ‘success’ stage has been reached.

Stage: keyboard-interactive

User is in the middle of authentication.
The prompts parameter contains an array of prompts that the user should make responses to.  Send the array of responses to /api/login/keyboard-interactive/:token

  • stage — ‘keyboard-interactive’
  • token — connection token which is required during authentication
  • prompt — text description of the prompt

Stage: password

Password based authentication

JSON object with the following members

  • stage — ‘password’
  • token — connection token which is required during authentication

Stage: success

User has successfully logged in and can now issue api commands

JSON object with the following members

  • stage — ‘success’
  • token — connection token which is required in api calls
  • host —  hostname where the user is connected