(Android™) Xero 2 Legged OAuth for Private Application

This example demonstrates the REST object for 2-legged OAuth for a private application.

Note: This example requires Chilkat v9.5.0.64 or later.

An application can setup OAuth1 for a given instance of the Chilkat REST object, and then use the instance for many REST API calls. This example demonstrates the OAuth1 setup and initial connection. This code would typically be placed in a subroutine/function to "initalize" the REST object before beginning to use it for REST HTTP requests.

Note: Xero private applications use 2 legged OAuth and bypass the user authorization workflow in the standard OAuth process. Private applications are linked to a single Xero organisation which is chosen when you register your application. In summary: 2-legged OAuth1 is for applications that access the data that they themselves own.

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 requires Chilkat v9.5.0.64 or later

    // This sample code would typically be placed in a subroutine or function
    // where the rest object is passed by reference.
    // It does the OAuth1 setup and makes the initial connection.
    CkRest rest = new CkRest();

    String consumerKey = "XERO_PRIVATE_APP_KEY";
    String consumerSecret = "XERO_PRIVATE_APP_SECRET";

    // Let's get our private key from our PFX (password protected), or the PEM (unprotected).
    // You can decide which to use.  Either is OK, although I would recommend keeping your
    // private keys in a PFX and not in an unprotected PEM.
    CkPfx pfx = new CkPfx();
    boolean success = pfx.LoadPfxFile("qa_data/certs/xero_private_app/public_privatekey.pfx","PFX_PASSWORD");
    if (success != true) {
        Log.i(TAG, pfx.lastErrorText());
        return;
        }

    CkPrivateKey privKeyFromPfx = pfx.GetPrivateKey(0);
    if (pfx.get_LastMethodSuccess() != true) {
        Log.i(TAG, pfx.lastErrorText());
        return;
        }

    // Or we can load from a PEM..
    CkPrivateKey privKeyFromPem = new CkPrivateKey();
    success = privKeyFromPem.LoadPemFile("qa_data/certs/xero_private_app/privatekey.pem");
    if (success != true) {
        Log.i(TAG, privKeyFromPem.lastErrorText());
        return;
        }

    // Note: There are many other means for loading a private key, including
    // from other formats and directly from memory (i.e. not file-based).

    CkOAuth1 oauth1 = new CkOAuth1();
    oauth1.put_ConsumerKey(consumerKey);
    oauth1.put_ConsumerSecret(consumerSecret);
    oauth1.put_Token(consumerKey);
    oauth1.put_TokenSecret(consumerSecret);
    oauth1.put_SignatureMethod("RSA-SHA1");
    oauth1.SetRsaKey(privKeyFromPfx);

    // Make the initial connection.
    // A single REST object, once connected, can be used for many Xero REST API calls.
    // The auto-reconnect indicates that if the already-established HTTPS connection is closed,
    // then it will be automatically re-established as needed.
    boolean bAutoReconnect = true;
    success = rest.Connect("api.xero.com",443,true,bAutoReconnect);
    if (success != true) {
        Log.i(TAG, rest.lastErrorText());
        return;
        }

    // Finally, install the OAuth1 authenticator.
    // (It make no difference whether this happens before or after the
    // connection is established.)
    rest.SetAuthOAuth1(oauth1,false);

    Log.i(TAG, "OK, the Xero OAuth1 is initialized and the REST object is ready to make REST API calls..");

  }

  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."
  }
}