page_type | name | description | languages | products | urlFragment | extensions | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
sample |
Vanilla JavaScript single-page application (SPA) using MSAL.js to authenticate users against Azure AD B2C |
Vanilla JavaScript single-page application (SPA) using MSAL.js to authenticate users against Azure AD B2C |
|
|
ms-identity-javascript-tutorial |
|
Vanilla JavaScript single-page application (SPA) using MSAL.js to authenticate users against Azure AD B2C
- Overview
- Scenario
- Contents
- Prerequisites
- Setup the sample
- Explore the sample
- Troubleshooting
- About the code
- Next Steps
- Contributing
- Learn More
This sample demonstrates a Vanilla JavaScript single-page application (SPA) that lets users sign-in with Azure Active Directory B2C using the Microsoft Authentication Library for JavaScript) (MSAL.js). In doing so, it also illustrates various authentication and B2C concepts, such as ID tokens, external identity providers , consumer social accounts, single-sign on (SSO), account selection, silent requests and more.
- The client application uses MSAL.js to obtain an ID Token from Azure AD B2C.
- The ID Token proves that the user has successfully authenticated against Azure AD B2C.
File/folder | Description |
---|---|
App/authPopup.js |
Main authentication logic resides here (using popup flow). |
App/authRedirect.js |
Use this instead of authPopup.js for authentication with redirect flow. |
App/authConfig.js |
Contains configuration parameters for the sample. |
App/ui.js |
Contains UI logic. |
server.js |
Simple Node server to index.html . |
- Node.js must be installed to run this sample.
- Visual Studio Code is recommended for running and editing this sample.
- VS Code Azure Tools extension is recommended for interacting with Azure through VS Code Interface.
- A modern web browser.
- An Azure AD B2C tenant. For more information, see: How to get an Azure AD B2C tenant
- A user account in your Azure AD B2C tenant.
From your shell or command line:
git clone https://github.com/Azure-Samples/ms-identity-javascript-tutorial.git
or download and extract the repository .zip file.
⚠️ To avoid path length limitations on Windows, we recommend cloning into a directory near the root of your drive.
cd 1-Authentication\2-sign-in-b2c
npm install
⚠️ This sample comes with a pre-registered application for demo purposes. If you would like to use your own Azure AD B2C tenant and application, follow the steps below to register and configure the application on Azure portal. Otherwise, continue with the steps for Running the sample.
- follow the steps below for manually register your apps
To manually register the apps, as a first step you'll need to:
- Sign in to the Azure portal.
- If your account is present in more than one Azure AD B2C tenant, select your profile at the top right corner in the menu on top of the page, and then switch directory to change your portal session to the desired Azure AD B2C tenant.
Please refer to: Tutorial: Create userflows in Azure Active Directory B2C
⚠️ This sample requires B2C user-flows to emit the emails claim in the ID token, which is used as username by MSAL. To do so, navigate to the Azure portal and locate the Azure AD B2C service. Then, navigate to the User flows blade. Select the User Attributes tab and make sure Email Address is checked. Then select the Application Claims tab and make sure Email Addresses is checked.You may want additional claims (such as object ID (oid) and etc.) to appear in the ID tokens obtained from Azure AD B2C user-flows. In that case, please refer to User profile attributes to learn about how to configure your user-flows to emit those claims.
Please refer to: Tutorial: Add identity providers to your applications in Azure Active Directory B2C
- Navigate to the Azure portal and select the Azure Active Directory B2C service.
- Select the App Registrations blade on the left, then select New registration.
- In the Register an application page that appears, enter your application's registration information:
- In the Name section, enter a meaningful application name that will be displayed to users of the app, for example
ms-identity-javascript-c1s2
. - Under Supported account types, select Accounts in any identity provider or organizational directory (for authenticating users with user flows)
- Select Register to create the application.
- In the Name section, enter a meaningful application name that will be displayed to users of the app, for example
- In the Overview blade, find and note the Application (client) ID. You use this value in your app's configuration file(s) later in your code.
- In the app's registration screen, select the Authentication blade to the left.
- If you don't have a platform added, select Add a platform and select the Single-page application option.
- In the Redirect URI section enter the following redirect URIs:
http://localhost:6420
http://localhost:6420/redirect
- Click Save to save your changes.
- In the Redirect URI section enter the following redirect URIs:
Open the project in your IDE (like Visual Studio or Visual Studio Code) to configure the code.
In the steps below, "ClientID" is the same as "Application ID" or "AppId".
- Open the
App\authConfig.js
file. - Find the key
clientId
and replace the existing value with the application ID (clientId) ofms-identity-javascript-c1s2
app copied from the Azure portal.
To setup your B2C user-flows, do the following:
- Find the key
names
and populate it with your policy names e.g.signUpSignIn
. - Find the key
authorities
and populate it with your policy authority strings e.g.https://<your-tenant-name>.b2clogin.com/<your-tenant-name>.onmicrosoft.com/b2c_1_susi
. - Find the key
authorityDomain
and populate it with the domain portion of your authority string e.g.<your-tenant-name>.b2clogin.com
.
cd 1-Authentication\2-sign-in-b2c
npm start
- Open your browser and navigate to
http://localhost:6420
. - Click on the sign-in button on the top right corner.
ℹ️ Did the sample not work for you as expected? Then please reach out to us using the GitHub Issues page.
ℹ️ if you believe your issue is with the B2C service itself rather than with the sample, please file a support ticket with the B2C team by following the instructions here.
Were we successful in addressing your learning objective? Consider taking a moment to share your experience with us.
Expand for troubleshooting info
Use Stack Overflow to get support from the community. 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 [azure-active-directory
react
ms-identity
adal
msal
].
To provide feedback on or suggest features for Azure Active Directory, visit User Voice page.
MSAL.js provides 3 login APIs: loginPopup()
, loginRedirect()
and ssoSilent()
:
myMSALObj.loginPopup(loginRequest)
.then((response) => {
// your logic
})
.catch(error => {
console.error(error);
});
To use the redirect flow, you must register a handler for redirect promise. MSAL.js provides handleRedirectPromise()
API:
myMSALObj.handleRedirectPromise()
.then((response) => {
// your logic
})
.catch(err => {
console.error(err);
});
myMSALObj.loginRedirect(loginRequest);
The recommended pattern is that you fallback to an interactive method should the silent SSO fails.
const silentRequest = {
scopes: ["openid", "profile"],
loginHint: "[email protected]"
};
myMSALObj.ssoSilent(silentRequest)
.then((response) => {
// your logic
}).catch(error => {
console.error("Silent Error: " + error);
if (error instanceof msal.InteractionRequiredAuthError) {
myMSALObj.loginRedirect(loginRequest);
}
});
You can pass custom query string parameters to your sign-in request, using the extraQueryParameters
property. For instance, in order to customize your B2C user interface, you can:
const loginRequest = {
scopes: ["openid", "profile"],
extraQueryParameters: { campaignId: 'hawaii', ui_locales: 'es' }
};
myMSALObj.loginRedirect(loginRequest);
See here for more: Customize the user interface of your application in Azure AD B2C
You can get all the active accounts of a signed-in user with the get getAllAccounts()
API. If you know the home ID of an account, you can select it by:
myMSALObj.getAccountByHomeId(homeId);
⚠️ MSAL.js also provides agetAccountByUsername()
API, which is not recommended with B2C as the B2C server may not return a username and as such, home ID is a more robust identifier to select an account.
The application redirects the user to the Microsoft identity platform logout endpoint to sign out. This endpoint clears the user's session from the browser. If your app did not go to the logout endpoint, the user may re-authenticate to your app without entering their credentials again, because they would have a valid single sign-in session with the Microsoft identity platform endpoint. See for more: Send a sign-out request.
The sign-out clears the user's single sign-on session with Azure AD B2C, but it might not sign the user out of their social identity provider session. If the user selects the same identity provider during a subsequent sign-in, they might re-authenticate without entering their credentials. Here the assumption is that, if a user wants to sign out of the application, it doesn't necessarily mean they want to sign out of their social account (e.g. Facebook) itself.
A single-page application does not benefit from validating ID tokens, since the application runs without a back-end and as such, attackers can intercept and edit the keys used for validation of the token.
Using the event API, you can register an event callback that will do something when an event is emitted. When registering an event callback in a react component you will need to make sure you do 2 things.
- The callback is registered only once
- The callback is unregistered before the component unmounts.
Here, we use the event API when integrating the B2C user-flows (discussed below).
- Sign-up/sign-in
This user-flow allows your users to sign-in to your application if the user has an account already, or sign-up for an account if not. This is the default user-flow that we pass during the initialization of MSAL instance.
- Password reset
When a user clicks on the forgot your password? link during sign-in, Azure AD B2C will throw an error. To initiate the password reset user-flow, you need to catch this error and handle it by sending another login request with the corresponding password reset authority string.
myMSALObj.loginPopup(loginRequest)
.then(handleResponse)
.catch(error => {
console.error(error);
if (error.errorMessage) {
if (error.errorMessage.indexOf("AADB2C90118") > -1) {
myMSALObj.loginPopup(b2cPolicies.authorities.forgotPassword)
.then(response => {
console.log(response);
window.alert("Password has been reset successfully. \nPlease sign-in with your new password.");
})
}
}
});
In case if you are using redirect flow, you should catch the error inside handleRedirectPromise()
:
myMSALObj.handleRedirectPromise()
.then(handleResponse)
.catch(error => {
console.error(error);
if (error.errorMessage.indexOf("AADB2C90118") > -1) {
try {
myMSALObj.loginRedirect(b2cPolicies.authorities.forgotPassword);
} catch(err) {
console.log(err);
}
}
});
Then, in addEventCallback()
:
if (event.payload.idTokenClaims['tfp'] === b2cPolicies.names.forgotPassword) {
let signUpSignInFlowRequest = {
authority: b2cPolicies.authorities.signUpSignIn.authority,
};
myMSALObj.loginPopup(signUpSignInFlowRequest)
.then(handleResponse)
.catch((error) => {
console.log(error)
})
}
- Edit Profile
When a user selects the Edit Profile button on the navigation bar, we simply initiate a sign-in flow. Like password reset, edit profile user-flow requires users to sign-out and sign-in again.
/**
* For the purpose of setting an active account for UI update, we want to consider only the auth
* response resulting from SUSI flow. "tfp" claim in the id token tells us the policy (NOTE: legacy
* policies may use "acr" instead of "tfp"). To learn more about B2C tokens, visit:
* https://docs.microsoft.com/en-us/azure/active-directory-b2c/tokens-overview
*/
if (event.payload.idTokenClaims['tfp'] === b2cPolicies.names.editProfile) {
const originalSignInAccount = myMSALObj
.getAllAccounts()
.find(
(account) =>
account.idTokenClaims.oid === event.payload.idTokenClaims.oid &&
account.idTokenClaims.sub === event.payload.idTokenClaims.sub &&
account.idTokenClaims['tfp'] === b2cPolicies.names.signUpSignIn
);
let signUpSignInFlowRequest = {
authority: b2cPolicies.authorities.signUpSignIn.authority,
account: originalSignInAccount,
};
// silently login again with the signUpSignIn policy
myMSALObj.ssoSilent(signUpSignInFlowRequest).catch((error) => {
console.log(error);
if (error instanceof msal.InteractionRequiredAuthError) {
myMSALObj.loginPopup({
...signUpSignInFlowRequest,
});
}
});
}
Learn how to:
- Vanilla JavaScript single-page application (SPA) using MSAL.js to authorize users for calling a protected web API on Azure AD B2C
- JavaScript single-page application calling Microsoft Graph with delegated permissions to manage Azure AD B2C user accounts
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.
- What is Azure Active Directory B2C?
- Application types that can be used in Active Directory B2C
- Recommendations and best practices for Azure Active Directory B2C
- Azure AD B2C session
- Building Zero Trust ready apps
- Initialize client applications using MSAL.js
- Single sign-on with MSAL.js
- Handle MSAL.js exceptions and errors
- Logging in MSAL.js applications
- Pass custom state in authentication requests using MSAL.js
- Prompt behavior in MSAL.js interactive requests
- Use MSAL.js to work with Azure AD B2C