| This callback interface is used during a "keyboard-interactive"
authentication. Every time the server sends a set of challenges (however,
most often just one challenge at a time), this callback function will be
called to give your application a chance to talk to the user and to
determine the response(s).
Some copy-paste information from the standard: a command line interface
(CLI) client SHOULD print the name and instruction (if non-empty), adding
newlines. Then for each prompt in turn, the client SHOULD display the
prompt and read the user input. The name and instruction fields MAY be
empty strings, the client MUST be prepared to handle this correctly. The
prompt field(s) MUST NOT be empty strings.
Please refer to draft-ietf-secsh-auth-kbdinteract-XX.txt for the details.
Note: clients SHOULD use control character filtering as discussed in
[draft-ietf-secsh-architecture-XX.txt] to avoid attacks by including
terminal control characters in the fields to be displayed.
Parameters:
name - the name String sent by the server.
Parameters:
instruction - the instruction String sent by the server.
Parameters:
numPrompts - number of prompts - may be zero (in this case, you should justreturn a String array of length zero).
Parameters:
prompt - an array (length numPrompts) of Strings
Parameters:
echo - an array (length numPrompts) of booleans. Foreach prompt, the corresponding echo field indicates whether ornot the user input should be echoed as characters are typed. an array of reponses - the array size must match the parameternumPrompts. |