Skip to content
Thomas Norling edited this page Jul 28, 2020 · 57 revisions

The Microsoft Authentication Library of JavaScript (MSAL.JS) is a token based authentication library for Single Page Applications. MSAL.JS enables you to acquire tokens 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

  1. Understand Single Page Application scenarios
  2. Register your app with Azure AD
  3. Initialize your application
  4. Acquire tokens to access Web APIs
  5. Review vanillaJS and Angular quickstart guides.

Supported OAuth 2.0 Grant Types

To sign-in users and acquire access tokens:

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.1.
Apr 2020 In Progress (Beta Released) MSAL.js 2.0.0 Supporting Authorization Code Flow with PKCE for Single Page Applications.
Apr 2020 In Progress MSAL.js 1.3.X ssoSilent API / Integration / Unit testing improvements. Checkout the latest MSAL.js 1.3.0.
May 2020 Complete MSAL Angular 1.0.0 Bringing 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 In Progress MSAL.js B2C Enhancements Enhancements to usage of MSAL.js with Azure AD B2C. Please refer to list of known issues and requests.
TBD In Progress 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
May 03, 2020 MSAL Angular 1.0.0 Readme Production ready version is now GA supporting Angular versions 6, 7, 8 and 9.
April 28, 2020 MSAL.js 1.3.0 Release notes ssoSilent API added, registering a handleRedirectCallback function is now optional.
January 14, 2020 MSAL.js 1.2.1 Release notes allow-forms added for sandboxed iframes, removing isAngular for redirect use cases.
Dec 10th 2019 MSAL.js 1.2.0 Release notes Authentication support for nested iframes, conditional access and sovereign clouds (first party customers specific).
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].(https://docs.microsoft.com/en-us/azure/active-directory/develop/msal-js-prompt-behavior) for details.
  • Support shared cache format to allow migration from ADAL.js to MSAL.js without sign in prompts. Read [more here].(https://docs.microsoft.com/en-us/azure/active-directory/develop/msal-js-sso).
  • September 11th 2018 MSAL.js 0.2.3 Release notes
  • Fix for redirect flow issues on IE and Edge browsers. Read [more here].(https://github.com/AzureAD/microsoft-authentication-library-for-js/wiki/Known-issues-on-IE-and-Edge-Browser).
  • 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