Skip to content


Switch branches/tags

This library, ADAL for Java, will no longer receive new feature improvements. Instead, use the new MSAL4J.

  • If you are starting a new project, you can get started with the MSAL4J docs for details about the scenarios, usage, and relevant concepts.
  • If your application is using the previous ADAL for Java library, you can follow this migration guide to update to MSAL4J.
  • Existing applications relying on ADAL for Java will continue to work.

Microsoft Azure Active Directory Authentication Library (ADAL) for Java

master branch dev branch Reference Docs
Build Status Build Status Javadocs
Getting Started Docs Samples Support Feedback

The ADAL for Java library enables Java applications to authenticate with Azure AD and get tokens to access Azure AD protected web resources.

Update to MSAL4J now!

MSAL4J is the new authentication library to be used with the Microsoft identity platform.

Building on top of ADAL, MSAL works with both the Open ID Connect certified Azure AD V2 endpoint and the new social identity solution from Microsoft, Azure AD B2C.

ADAL4J is in maintenance mode and no new features will be added going forward except for security fixes. All our ongoing efforts will be focused on improving MSAL4J.

Installation and usage

You can find the steps for installation and basic usage documented in the ADAL4J Basics Wiki.


Current version - 1.6.7

Minimum recommended version - 1.6.7

From version 1.3.0 support for handling Conditional Access claims challenge was added. You can read about CA here and refer this sample to handle it.

You can find the changes for each version in the change log.


All code is licensed under the MIT License and we triage actively on GitHub. We encourage and welcome contributions to the library. Please read the contributing guide before starting.

Build and Run

Refer this page for information on building the project and running tests.

Samples and Documentation

Refer these code samples using ADAL4J in some basic scenarios.

We also provide a full suite of sample applications and documentation to help you get started with learning the Azure Identity system. This includes tutorials for native clients such as Windows, Windows Phone, iOS, macOS, Android, and Linux. We also provide full walkthroughs for authentication flows such as OAuth2, OpenID Connect, Graph API, and other awesome features.

Community Help and Support

We leverage Stack Overflow to work with the community on supporting Azure Active Directory and its SDKs, including this one! We highly recommend you ask your questions on Stack Overflow (we're all on there!) Also browser existing issues to see if someone has had your question before.

We recommend you use the "adal" tag so we can see it! Here is the latest Q&A on Stack Overflow for ADAL:

Submit Feedback

We'd like your thoughts on this library. Please complete this short survey.

Security Reporting

If you find a security issue with our libraries or services please report it to with as much detail as possible. Your submission may be eligible for a bounty through the Microsoft Bounty program. Please do not post security issues to GitHub Issues or any other public site. We will contact you shortly upon receiving the information. We encourage you to get notifications of when security incidents occur by visiting this page and subscribing to Security Advisory Alerts.

We Value and Adhere to the Microsoft Open Source Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact with any additional questions or comments.