Android™

How to Generate an Azure Service Bus Shared Access Signature (SAS)

See more Azure Service Bus Examples

Demonstrates generating and using an Azure Service Bus Shared Access Signature (SAS).

Note: This example requires Chilkat v9.5.0.65 or greater.

Android™

// 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);

    // Note: Requires Chilkat v9.5.0.65 or greater.

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

    // -------------------------------------------------------------------
    // Create a Shared Access Signature (SAS) token for Azure Service Bus.
    // -------------------------------------------------------------------

    CkAuthAzureSAS authSas = new CkAuthAzureSAS();
    authSas.put_AccessKey("AzureServiceBus_PrimaryKey");

    // The SAS token for Service Bus will look like this:
    // (The order of params will be different.  The order does not matter.)
    // sig=<signature-string>&se=<expiry>&skn=<keyName>&sr=<URL-encoded-resourceURI>

    // Specify the format of the string to sign.
    authSas.put_StringToSign("resourceURI,expiry");

    // Create an expiry to 30 days in the future.
    CkDateTime dtExpiry = new CkDateTime();
    dtExpiry.SetFromCurrentSystemTime();
    dtExpiry.AddDays(30);
    authSas.SetTokenParam("expiry","se",dtExpiry.getAsUnixTimeStr(true));

    // Set the skn (keyname)
    // This example uses the key "RootManageSharedAccessKey".  This give full access.
    // In a typical scenario, you would create a new Azure key (for the service bus)
    // in the Azure portal, such that the key has limited permissions.  This would
    // allow you to give the SAS token to others for specific access for some period of time.
    authSas.SetTokenParam("keyName","skn","RootManageSharedAccessKey");

    // Set the URL-encoded-resourceURI
    CkStringBuilder sbResourceUri = new CkStringBuilder();
    sbResourceUri.Append("https://<yournamespace>.servicebus.windows.net/");
    sbResourceUri.Encode("url","utf-8");
    authSas.SetTokenParam("resourceURI","sr",sbResourceUri.getAsString());

    // Generate the SAS token.
    String sasToken = authSas.generateToken();
    if (authSas.get_LastMethodSuccess() != true) {
        Log.i(TAG, authSas.lastErrorText());
        return;
        }

    Log.i(TAG, "SAS token: " + sasToken);

    // Save the SAS token to a file.
    // We can then use this pre-generated token for future Service Bus operations.
    CkFileAccess fac = new CkFileAccess();
    fac.WriteEntireTextFile("qa_data/tokens/serviceBusSas.txt",sasToken,"utf-8",false);

  }

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