Skip to content
This repository has been archived by the owner on Jul 5, 2023. It is now read-only.
Santiago Gonzalez edited this page Mar 28, 2018 · 18 revisions

Microsoft Azure Active Directory Authentication Library for Java (com.microsoft.aad.adal4j) is an authentication library which enables you to acquire tokens from Azure AD and ADFS, to access protected Web APIs (Microsoft APIs or applications registered with Azure Active Directory).

Roadmap

Release Main Features
Version 1.0.1 GA release of the API to support Server-2-Server flow, resource owner grant flow for command line apps
Version 1.1.0 Add raw id_token in AuthenticationResult, Add support for WSTRUST2005, Add option to configure proxy for AuthenticationContext
Version 1.1.1 Hotfix release to handle error stream in case of 404
Version 1.1.2 Add support for SSLSocketFactory
Version 1.1.3 Fixed XXE security bugs
Version 1.2.0 Add support for RSA keys produced by sunMSCAPI provider, log details about non 200 http responses
Version 1.3.0 Add acquireTokenUsingRefreshToken API, update to nimbus version 5.24.1, throwing AdalClaimsChallengeException when claims challenge error occurs, switch to MIT license, add tenant id to user info, add sample of SSLTunnelSocketFactory with proxy authentication
Version 1.4.0 Add personal identifiable information (PII) Logger, Add support for integrated authentication

Conceptual Documentation

Introduction:

  1. Why use ADAL4J?

  2. Pre-requisite: Before using ADAL4J you will have to register you applications with Azure AD through the Azure portal (https://portal.azure). If you are not familiar with application registration, reading the following article will be valuable: Integrating applications with Azure Active Directory

  3. Instantiate a AuthenticationContext : a connection to Azure AD

  4. Acquire a token for a user. This returns an AuthenticationResult

  5. Use an access token to call a protected Web API

  6. Follow best practices for a robust enterprise ready application