Azure Active Directory certificate-based authentication on Android

Certificate-based authentication (CBA) enables you to be authenticated by Azure Active Directory with a client certificate on a Windows, Android or iOS device when connecting your Exchange online account to:

  • Office mobile applications such as Microsoft Outlook and Microsoft Word
  • Exchange ActiveSync (EAS) clients

Configuring this feature eliminates the need to enter a username and password combination into certain mail and Microsoft Office applications on your mobile device.

This topic provides you with the requirements and the supported scenarios for configuring CBA on an iOS(Android) device for users of tenants in Office 365 Enterprise, Business, Education, US Government, China, and Germany plans.

This feature is available in preview in Office 365 US Government Defense and Federal plans.

Microsoft mobile applications support

Apps Support
Azure Information Protection app Check
Intune Company Portal Check
Microsoft Teams Check
OneNote Check
OneDrive Check
Outlook Check
Power BI Check
Skype for Business Check
Word / Excel / PowerPoint Check
Yammer Check

Implementation requirements

The device OS version must be Android 5.0 (Lollipop) and above.

A federation server must be configured.

For Azure Active Directory to revoke a client certificate, the ADFS token must have the following claims:

    (The serial number of the client certificate)
    (The string for the issuer of the client certificate)

Azure Active Directory adds these claims to the refresh token if they are available in the ADFS token (or any other SAML token). When the refresh token needs to be validated, this information is used to check the revocation.

As a best practice, you should update the ADFS error pages with instructions on how to get a user certificate.
For more details, see Customizing the AD FS Sign-in Pages.

Some Office apps (with modern authentication enabled) send ‘prompt=login’ to Azure AD in their request. By default, Azure AD translates this in the request to ADFS to ‘wauth=usernamepassworduri’ (asks ADFS to do U/P auth) and ‘wfresh=0’ (asks ADFS to ignore SSO state and do a fresh authentication). If you want to enable certificate-based authentication for these apps, you need to modify the default Azure AD behavior. Just set the ‘PromptLoginBehavior’ in your federated domain settings to ‘Disabled‘. You can use the MSOLDomainFederationSettings cmdlet to perform this task:

Set-MSOLDomainFederationSettings -domainname <domain> -PromptLoginBehavior Disabled

Exchange ActiveSync clients support

Certain Exchange ActiveSync applications on Android 5.0 (Lollipop) or later are supported. To determine if your email application does support this feature, please contact your application developer.

Next steps

If you want to configure certificate-based authentication in your environment, see Get started with certificate-based authentication on Android for instructions.