Back to product page

LoginChallenge event


Fires when the remote server requires keyboard-interactive authentication.

Syntax

  • Basic
Private Sub object_LoginChallenge(Challenge, Response)
The LoginChallenge(object,Challenge,Response) syntax has these parts:
objectA wodTunnel object.
ChallengeA String value. Holds the challenge text sent by the server.
ResponseA String value. Should be set to the response to the server's challenge. Usually this is your password.

Remarks

This event will be fired for the SSH2 protocol only. It gives you the ability to authenticate with the server using the "interactive" session. The server will send a challenge string, you must reply with the correct responses to successfully authenticate.

A typical scenario is where the server sends the challenge "user's password:" and you have to provide your password in the Response argument. However, the server may require different forms of authentication, such as various tokens, security devices etc.. Recently, many servers have removed "password" authentication completely, allowing only "keyboard-interactive" authentication to be used.

You should print the Challenge on the screen and ask for a Response when you use this event.

If you don't use this event, but the server still requires this type of authentication, the server will use the value from the Password property - line by line for each challenge that the server sends. As there is usually only one challenge, you will be able to login without using this event.

"keyboard-interactive" is used when the Authentication property is set to authKeyboardInteractive of authPassword.

Platforms

Windows