(Android™) Office365 IMAP with Client Credentials

See more Office365 Examples

Demonstrates how to interact with the Office365 IMAP server using OAuth2 client credentials. This example uses a new feature available starting in Chilkat v9.5.0.97, which is to provide the client ID, client secret, and tenant ID to Chilkat, and internally Chilkat will fetch OAuth2 access token via client credentials as necessary. Therefore, it is no longer necessary for the application to explicitly fetch the OAuth2 access token beforehand.

Note: This requires the Azure Entra ID application to be configured for client credentials as detailed in this guide: Office365 App Setup for SMTP, POP, IMAP OAuth2 Client Credentials

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

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 the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    boolean success;

    // ----------------------------------------------------------------------------------------
    // Important:
    // Your Azure Entra ID app must be explicitly setup to allow for the OAuth2 client credentials flow.
    // Please follow the detailed guide for how to do it here:
    // Office365 App Setup for SMTP, POP, IMAP OAuth2 Client Credentials
    // 
    // Note: Your registered App must have the SMTP.SendAsApp permission.
    // ----------------------------------------------------------------------------------------

    CkJsonObject json = new CkJsonObject();

    // Use your App's actual client ID here:
    json.UpdateString("client_id","2871da2c-8176-4b7f-869b-2311aa82e743");

    // Use your App's actual client secret here:
    json.UpdateString("client_secret","2hu9Q~r5QuryUcEkNbg1btLtnfU1VUXzhSCG6brH");

    // Use this specific scope.
    json.UpdateString("scope","https://outlook.office365.com/.default");

    // Replace the tenant ID part of the URL with your tenant ID.
    json.UpdateString("token_endpoint","https://login.microsoftonline.com/114d7ed6-71bf-4dbe-a866-748364121bf2/oauth2/v2.0/token");

    CkImap imap = new CkImap();

    imap.put_Ssl(true);
    imap.put_Port(993);

    // Connect to the Office365 IMAP server.
    success = imap.Connect("outlook.office365.com");
    if (success != true) {
        Log.i(TAG, imap.lastErrorText());
        return;
        }

    // Use OAuth2 authentication.
    imap.put_AuthMethod("XOAUTH2");

    // Here is where we use a new feature introduced in Chilkat v9.5.0.97
    // Instead of providing a previously fetched OAuth2 access token, we instead provide the information (above)
    // required for Chilkat to automatically fetch the access token via client credentials.
    success = imap.Login("OFFICE365_EMAIL_ADDRESS",json.emit());
    if (success != true) {
        Log.i(TAG, imap.lastErrorText());
        return;
        }

    Log.i(TAG, "O365 IMAP OAuth2 authentication is successful.");

    // Do something...
    success = imap.SelectMailbox("Inbox");
    if (success != true) {
        Log.i(TAG, imap.lastErrorText());
        return;
        }

    // Your application can continue to do other things in the IMAP session....

    // When finished, logout and close the connection.
    success = imap.Logout();
    success = imap.Disconnect();

    Log.i(TAG, "Finished.");

  }

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