Azure Active Directory B2C: Register your application

Prerequisite

To build an application that accepts consumer sign-up and sign-in, you first need to register the application with an Azure Active Directory B2C tenant. Get your own tenant by using the steps outlined in Create an Azure AD B2C tenant. After you follow all the steps in that article, you will have the B2C features blade pinned to your Startboard.

Important

You cannot use applications registered in the Applications tab on the classic Azure Management Portal for this.

If you have the B2C features blade pinned to your Startboard, you will see the blade as soon as you sign in to the Azure portal as the Global Administrator of the B2C tenant.

You can also access the blade by clicking Browse and then Azure AD B2C in the left navigation pane on the Azure portal.

Important

You need to be a Global Administrator of the B2C tenant to be able to access the B2C features blade. A Global Administrator from any other tenant or a user from any tenant cannot access it. You can switch to your B2C tenant by using the tenant switcher in the top right corner of the Azure Portal.

Register an application

  1. On the B2C features blade on the Azure portal, click Applications.
  2. Click +Add at the top of the blade.
  3. Enter a Name for the application that will describe your application to consumers. For example, you could enter "Contoso B2C app".
  4. If you are writing a web-based application, toggle the Include web app / web API switch to Yes. The Reply URLs are endpoints where Azure AD B2C will return any tokens that your application requests. For example, enter https://localhost:44321/. If your web application will also be calling some web API secured by Azure AD B2C, you'll want to create an Application Secret as well by clicking the Generate Key button.

    Note

    An Application Secret is an important security credential, and should be secured appropriately.

  5. If you are writing a mobile application, toggle the Include native client switch to Yes. Copy down the default Redirect URI that is automatically created for you.
  6. Click Create to register your application.
  7. Click the application that you just created and copy down the globally unique Application Client ID that you'll use later in your code.
Important

Applications created in the B2C features blade have to be managed in the same location. If you edit B2C applications using PowerShell or another portal, they become unsupported and will likely not work with Azure AD B2C.

Build a Quick Start Application

Now that you have an application registered with Azure AD B2C, you can complete one of our quick-start tutorials to get up and running. Here are a few recommendations:

Mobile & Native Apps Web Apps & Web APIs Integrate Directly with Protocols
Add Sign Up & Sign In to an iOS App Add Sign Up & Sign In to a .NET MVC App Register an Application
Add Sign Up & Sign In to a Windows Desktop App Use a Sign Up/Sign In Policy in a .NET MVC App Mobile Apps with OAuth 2.0
Secure a .NET Web API Web Apps with OpenID Connect
Call a Web API from a .NET Web App
Add Sign Up & Sign In to a ASP.NET Core app