• Introduction
• Prerequisites
• Register the application
• Build and run the sample
• Community Help and Support
• Contributing

The MSAL preview library for JavaScript gives your app the ability to begin using the Microsoft Cloud by supporting Microsoft Azure Active Directory and Microsoft Accounts in a converged experience using industry standard OAuth2 and OpenID Connect. This sample us a JavaScript Single Page with an ASP.NET backend. It demonstrates all the normal lifecycles your application should experience, including:

• How to get a token
• How to refresh a token
• How to call a backend Web API
• How to sign a user out of your application

To use this sample, you will need :

• Visual Studio 2015 or later
• Either a Microsoft account or Office 365 for business account

1. Sign into the App Registration Portal using either your personal or work or school account.

2. Choose Add an app.

3. Enter a name for the app, and choose Create application.

   The registration page displays, listing the properties of your app.

4. Copy the Application Id (also named ClientID) to the clipboard. This is the unique identifier for your app.

5. Under Platforms, choose Add Platform.

6. Choose Web.

7. Make sure the Allow Implicit Flow check box is selected, and enter https://localhost:44302/ as the Redirect URI.

8. Choose Save.

1. Download or clone the repository for this sample.

2. Using your favorite IDE, open app.js in App/scripts.

3. Replace the clientId GUID with the application ID of your registered Azure application.

4. open Web.confg in the root of the application.

5. Replace the value of the Ida::Audience application setting with the application ID of your registered Azure application.

6. Replace the value of the Ida::Tenant application setting with the name of the AAD tenant in which you have registered your application (the form should something.onmicrosoft.com)

7. Run the application in Visual Studio, for choose, from the toolback under the main menubar, which browser to use and use the Debug | Start without debugging command. The browser opens, navigating to http://localhost:44302.

8. When the page gets displayed, click on the Login button.

9. When the popup window appears, sign-in with your personal or work or school account and grant the requested permissions.

10. Click on User to see information about the Signed-in user, and TodoList to edit the todo list (you can add, delete, edit new items)

The sample was tested with Chrome, Edge and Internet Explorer. For Internet explorer, be sure to read the msal.js FAQ Using msal.js with Internet Explorer

• The creation of the user agent application is done in app.js, configured by the clientID.

• when the user presses the login button (sign-in happens, in app.js by a call to loginPopup().

• when the user presses Todo, the list is fetched from the ASP.NET backend. this happens in todoListCtrl.js, by attempting to call acquireTokenSilent, and then, if it fails calling acquireTokenPopup. The access token is then used to call the backend (which has the same clientID as the JavaScript front-end). This happens in getTodoList.

• when the user presses the logout button (sign-out happens, in app.js through a call to logout().

We use Stack Overflow with the community to provide support. We highly recommend you ask your questions on Stack Overflow first and browse existing issues to see if someone has asked your question before. Make sure that your questions or comments are tagged with [msal.js].

If you find and bug or have a feature request, please raise the issue on GitHub Issues.

To provide a recommendation, visit our User Voice page.

If you'd like to contribute to this sample, see CONTRIBUTING.MD.

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

This library controls how users sign-in and access services. We recommend you always take the latest version of our library in your app when possible.

If you find a security issue with our libraries or services please report it to [email protected] 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.

Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT License (the "License");