Home

The Microsoft Authentication Library of JavaScript (MSAL.JS) is a token based authentication library for Single Page Applications. MSAL.JS enables you to acquire token from Azure AD to authenticate users and access Microsoft APIs such as Microsoft Graph or any API registered with Azure AD. MSAL.JS authenticate users with work or school accounts in Azure AD(AAD), Microsoft personal accounts (MSA) and accounts with social identity providers like Facebook, Google, Micosoft Accounts, etc. through Azure AD B2C service.

• Getting started with MSAL.js
• Implicit grant
• Advanced topics
• Roadmap
• Release
• Samples
• FAQ

Getting started with MSAL.js

1. Understand Single Page Application scenarios
2. Pre-requisite: you need to Register your app with Azure AD
3. Acquiring Tokens to access Web APIs

Implicit Flow

To sign-in users and acquire an access token, MSAL.JS follows Implicit Grant Oauth flow.

Advanced topics

• How to enable logging
• How to implement error handling
• Implement Single Sign On in your Single Page Application

Roadmap

Timeline	Status	Release	Main features
Dec 2019	Complete	MSAL.js 1.2.X	(Production release) Authentication support for nested iframes, conditional access and sovereign clouds(specific to first party customers only). Checkout the latest MSAL.js 1.2.0 beta.0.
Dec 2019	In Progress	MSAL.js 1.3.X	ssoSilent API / Integration / Unit testing improvements
Dec 2019	In Progress	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.
Mar 2020	In Progress (Alpha Released)	MSAL.js 2.0.0	Supporting Authorization Code Flow with PKCE for Single Page Application
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 change log.

Date	Release	Announcement	Main features
July 23rd 2019	MSAL.js 1.2.0 beta.0	Release notes	Authentication support for nested iframes, conditional access and sovereign clouds(first party customers specifc)
July 23rd 2019	MSAL.js 1.1.0	Release notes	Add forceRefresh to skip cache, add claims to IdToken type, refactoring, fix bugs including esmodule compat with base64
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

FAQ

• Learn about ADAL v/s MSAL
• How to renew tokens in MSAL.JS?