Home

Welcome to the Microsoft Authentication Library For JavaScript wiki!

The MSAL library for JavaScript enables browser-based client-side Single Page Applications to authenticate users with work or school accounts in Azure Active Directory (AAD), personal Microsoft accounts (MSA) through Azure AD service as well as accounts in social identity providers like Facebook, Google, Micosoft Accounts, etc. through Azure AD B2C service. It also enables your app to get tokens to access Microsoft APIs such as Microsoft Graph and any API registered with Azure AD.

The identity management services that the library interacts with are Microsoft Azure AD and Microsoft Azure AD B2C.

Overview

1. Pre-requisite: Before using MSAL JS you will have to Register your app with Azure AD.

2. Learn about the scenario where MSAL.js is used and the basic steps to integrate MSAL.js in MSAL Basics.

3. Refer FAQS for common issues and known bugs.

4. Follow the Advanced Topics for building robust enterprise ready applications.

5. Track announcements of new features, releases and upcoming changes in MSAL JS under News and the Roadmap below.

Roadmap

First and foremeost we want to listen to our users, and work on the things that are the highest leverage for the most people. We strive to be able communicate openly and regularly about what we are working on and what we are prioritizing. Getting to a high level of detail and accuracy on our roadmap will be a work in progress. Hearing your feedback, challenges, and requests will absolutley factor into the work we do.

Timeline	Status	Release	Main features
May-Jun 2019	In Progress	MSAL.js 1.0.x	Post GA release we are focussing on addressing any bugs or feedback we hear. Improving tests.
Jun 2019	In Progress	MSAL.js 1.1.0	Add support for telemetry, conditional access, sovereign clouds, and other GA fast follow features.
July-Sep 2019	Planning	MSAL Angular 1.0.0	Brining MSAL-Angular up to date with msal core 1.0.0 and ready to GA. Improvements and feature enhancements for MSAL Angular wrapper based on preview feedback. Please refer to list of known issues and requests.
TBD	Not Started	MSAL.js B2C Enhancements	Enhancements to usage of MSAL.js with Azure AD B2C. Please refer to list of known issues and requests.
TBD	Not Started	MSAL Node.js Preview	Preview version of a server side authentication library for node.js. Support of Oauth2 auth-code and device-code flow.
TBD	Not Started	MSAL React Preview	Preview version of a client side library for adding authentication to React applications.

Releases

Expect us to detail our major and minor releases moving forward, while leaving out our patch releases. Patch release notes can be found in our changelog.

Date	Release	Announcement	Main features
May 3rd 2019	MSAL.js 1.0.0	Release notes	API changes to support Configuration, Request, Response and Error object models to provide more control and access to parameters during token requests. Read MSAL.js 1.0.0 with API changes released for details on usage.
January 4th 2019	MSAL.js 0.2.4	Release notes	Support single sign on by removing default prompt parameter. See prompt behavior for details. Support shared cache format to allow migration from ADAL.js to MSAL.js without sign in prompts. Read more here.
September 11th 2018	MSAL.js 0.2.3	Release notes	Fix for redirect flow issues on IE and Edge browsers. Read more here. Support single sign on when not logged in with MSAL.js. Read SSO with MSAL.js.
September 10th 2018	MSAL Angular 0.1.2	Readme	Preview version of wrapper library for Angular (4.3 to 5) framework.
August 14th 2018	MSAL AngularJS 0.1.1	Readme	Preview version of wrapper library for AngularJS framework.
Previous releases	MSAL.js 0.1.0 - 0.2.2	Releases