Interface InteractiveCallback

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      java.lang.String[] replyToChallenge​(java.lang.String name, java.lang.String instruction, int numPrompts, java.lang.String[] prompt, boolean[] echo)
      This callback interface is used during a "keyboard-interactive" authentication.
    • Method Detail

      • replyToChallenge

        java.lang.String[] replyToChallenge​(java.lang.String name,
                                            java.lang.String instruction,
                                            int numPrompts,
                                            java.lang.String[] prompt,
                                            boolean[] echo)
                                     throws java.lang.Exception
        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 RFC4251 to avoid attacks by including terminal control characters in the fields to be displayed.

        Parameters:
        name - the name String sent by the server.
        instruction - the instruction String sent by the server.
        numPrompts - number of prompts - may be zero (in this case, you should just return a String array of length zero).
        prompt - an array (length numPrompts) of Strings
        echo - an array (length numPrompts) of booleans. For each prompt, the corresponding echo field indicates whether or not the user input should be echoed as characters are typed.
        Returns:
        an array of reponses - the array size must match the parameter numPrompts.
        Throws:
        java.lang.Exception