(Android™) SSH Keyboard Authentication

Demonstrates how to implement keyboard authentication with an SSH server.

Chilkat Android™ Downloads Android™ Java Libraries Android C/C++ Libraries

// Important: Don't forget to include the call to System.loadLibrary
// as shown at the bottom of this code sample.
package com.test;

import android.app.Activity;
import com.chilkatsoft.*;

import android.widget.TextView;
import android.os.Bundle;

public class SimpleActivity extends Activity {

  private static final String TAG = "Chilkat";

  // Called when the activity is first created.
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // This example assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    CkSsh ssh = new CkSsh();

    // Set some timeouts, in milliseconds:
    ssh.put_ConnectTimeoutMs(5000);
    ssh.put_IdleTimeoutMs(15000);

    // Connect to the SSH server.  
    // The standard SSH port = 22
    // The hostname may be a hostname or IP address.
    String hostname = "sftp.example.com";
    int port = 22;
    boolean success = ssh.Connect(hostname,port);
    if (success != true) {
        Log.i(TAG, ssh.lastErrorText());
        return;
        }

    // Begin keyboard authentication..
    String xmlResponse = ssh.startKeyboardAuth("myLogin");
    if (ssh.get_LastMethodSuccess() != true) {
        Log.i(TAG, ssh.lastErrorText());
        return;
        }

    // If a user authentication banner was received, then your app
    // may display it prior to prompting for the password.
    Log.i(TAG, "UserAuthBanner: " + ssh.userAuthBanner());

    CkXml xml = new CkXml();

    success = xml.LoadXml(xmlResponse);
    // Assume LoadXml succeeds for the example..
    if (xml.HasChildWithTag("success") == true) {
        Log.i(TAG, "No password required, already authenticated.");
        return;
        }

    if (xml.HasChildWithTag("error") == true) {
        Log.i(TAG, "Authentication already failed.");
        return;
        }

    // See the online reference documentation for Chilkat SSH.
    // The XML returned by StartKeyboardAuth will contain an infoRequest
    // with one or more prompts that your application may choose to display.

    // Call ContinueKeyboardAuth, passing in the whatever information is requires (such as the password).
    // Typically, keyboard authentication requires one call to ContinueKeyboardAuth 
    // using the password.  Theoretically, the SSH server could prompt for additional pieces
    // of information.  The authentication is completed when the XML returned contains
    // either a "success" or "error" child node.

    // This example asumes only one call to ContinueKeyboardAuth is required.
    xmlResponse = ssh.continueKeyboardAuth("myPassword");
    if (ssh.get_LastMethodSuccess() != true) {
        Log.i(TAG, ssh.lastErrorText());
        return;
        }

    success = xml.LoadXml(xmlResponse);
    // Assume LoadXml succeeds for the example..
    if (xml.HasChildWithTag("success") == true) {
        Log.i(TAG, "SSH Keyboard Authentication Successful!");
        return;
        }

    if (xml.HasChildWithTag("error") == true) {
        Log.i(TAG, "Authentication failed.");
        return;
        }


  }

  static {
      System.loadLibrary("chilkat");

      // Note: If the incorrect library name is passed to System.loadLibrary,
      // then you will see the following error message at application startup:
      //"The application <your-application-name> has stopped unexpectedly. Please try again."
  }
}