Quickstart: Register an app with the Azure Active Directory v2.0 endpoint
To build an app that accepts both personal Microsoft account (MSA), and work or school account (Azure AD) sign-in, you'll need to register an app with the Azure Active Directory (Azure AD) v2.0 endpoint. At this time, you won't be able to use any existing apps you may have with Azure AD or MSA - you'll need to create a brand new one.
Not all Azure AD scenarios and features are supported by the v2.0 endpoint. To determine if you should use the v2.0 endpoint, read about the v2.0 limitations.
Registering a new app? Try out the new App registrations (Preview) experience in the Azure portal. See Register an app (Preview) to get started.
Step 1: Sign in to the Microsoft application registration portal
- Navigate to the Microsoft app registration portal at https://apps.dev.microsoft.com/.
- Sign in with either a personal or work or school Microsoft account. If you don't have either, sign up for a new personal account.
- Done? You should now be looking at your list of Microsoft apps, which is probably empty. Let's change that.
Step 2: Register an app
- Select Add an app, and give it a name. The portal will assign your app a globally unique Application ID that you'll use later in your code. If your app includes a server-side component that needs access tokens for calling APIs (think: Office, Azure, or your own web API), you'll want to create an Application Secret here as well.
- Next, add the Platforms that your app will use.
- For web-based apps, provide a Redirect URI where sign-in messages can be sent.
- For mobile apps, copy down the default redirect URI automatically created for you.
- For web APIs, a default scope to access the Web API is automatically created for you. You can add additional scopes using the Add Scope button. You can also add any applications that are pre-authorized to use your Web API using the Pre-authorized applications form.
- Optionally, customize the look and feel of your sign-in page in the Profile section.
- Save your changes before moving on.
When you register an application using https://apps.dev.microsoft.com/, the application will be registered in the home tenant of the account that you use to sign into the portal. This means that you can not register an application in your Azure AD tenant using a personal Microsoft account. If you explicitly wish to register an application in a particular tenant, sign in with an account originally created in that tenant.
Now that you have a Microsoft app, you can complete one of the v2.0 quickstart2. Here are a few recommendations:
We'd love to hear your thoughts. Choose the type you'd like to provide:
Our feedback system is built on GitHub Issues. Read more on our blog.