Edit

Tutorial: Register a Single-page application with the Microsoft identity platform

  • Article

To interact with the Microsoft identity platform, Microsoft Entra ID must be made aware of the application you create. This tutorial shows you how to register a single-page application (SPA) in a tenant on the Microsoft Entra admin center.

In this tutorial:

  • Register the application in a tenant
  • Add a Redirect URI to the application
  • Record the application's unique identifiers

Prerequisites

  • An Azure account with an active subscription. Create an account for free.
  • This Azure account must have permissions to manage applications. Any of the following Microsoft Entra roles include the required permissions:
    • Application administrator
    • Application developer
    • Cloud application administrator

Register the application and record identifiers

Tip

Steps in this article may vary slightly based on the portal you start from.

To complete registration, provide the application a name, specify the supported account types, and add a redirect URI. Once registered, the application Overview pane displays the identifiers needed in the application source code.

  1. Sign in to the Microsoft Entra admin center.

  2. If access to multiple tenants is available, use the Directories + subscriptions filter in the top menu to switch to the tenant in which to register the application.

  3. Browse to Identity > Applications > App registrations, select New registration.

  4. Enter a Name for the application, such as NewSPA1.

  5. For Supported account types, select Accounts in this organizational directory only. For information on different account types, select the Help me choose option.

  6. Under Redirect URI (optional), use the drop-down menu to select Single-page-application (SPA) and enter http://localhost:3000 into the text box.

  7. Select Register.

    Screenshot that shows how to enter a name and select the account type in the Azure portal.

  8. The application's Overview pane is displayed when registration is complete. Record the Directory (tenant) ID and the Application (client) ID to be used in your application source code.

    Screenshot that shows the identifier values on the overview page on the Azure portal.

    Note

    The Supported account types can be changed by referring to Modify the accounts supported by an application.

Next steps

Tutorial: Prepare an application for authentication