Ruby

Start SSH Tunnel Keyboard-Interactive Authentication

Demonstrates the Chilkat SshTunnel.StartKeyboardAuth method, which begins keyboard-interactive authentication. The only argument is the login name. It returns XML describing the server's prompts, which are answered with ContinueKeyboardAuth.

Background: Keyboard-interactive is the prompt-driven authentication method: the server sends one or more questions — a password, a one-time code, a security question — and the client answers each. This is how a tunnel supports two-factor and other challenge-response schemes. The returned XML says exactly what to ask and whether to mask the input.

Chilkat Ruby Downloads

Download Chilkat for Ruby

Ruby

require 'chilkat'

success = false

#  Demonstrates the SshTunnel.StartKeyboardAuth method, which begins keyboard-interactive
#  authentication.  The only argument is the login name.  It returns XML describing the server's
#  prompts, which are answered with ContinueKeyboardAuth.

tunnel = Chilkat::CkSshTunnel.new()

#  The tunnel forwards accepted local connections to this destination through the SSH server.
tunnel.put_DestHostname("db.internal.example.com")
tunnel.put_DestPort(5432)

#  Connect to the SSH server.  This performs the TCP/proxy connection and SSH handshake, but
#  does not authenticate yet.
sshPort = 22
success = tunnel.Connect("ssh.example.com",sshPort)
if (success == false)
    print tunnel.lastErrorText() + "\n";
    exit
end

#  Begin keyboard-interactive authentication.  The returned XML describes the server's prompts.
infoRequestXml = tunnel.startKeyboardAuth("mySshLogin")
if (tunnel.get_LastMethodSuccess() == false)
    print tunnel.lastErrorText() + "\n";
    exit
end

print infoRequestXml + "\n";

#  Answer the prompt(s) with ContinueKeyboardAuth, then call BeginAccepting.

waitForThreadExit = true
success = tunnel.CloseTunnel(waitForThreadExit)
if (success == false)
    print tunnel.lastErrorText() + "\n";
    exit
end