How to register an app with the v2.0 endpoint

To build an app that accepts both MSA & Azure AD sign-in, you'll first need to register an app with Microsoft. 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.

Note

Not all Azure Active Directory scenarios & features are supported by the v2.0 endpoint. To determine if you should use the v2.0 endpoint, read about v2.0 limitations.

Visit the Microsoft app registration portal

First things first - navigate to https://apps.dev.microsoft.com/?deeplink=/appList. This is a new app registration portal where you can manage your Microsoft apps.

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. Go ahead, it won't take long - we'll wait here.

Done? You should now be looking at your list of Microsoft apps, which is probably empty. Let's change that.

Click 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.

Optionally, you can customize the look and feel of your sign-in page in the Profile section. Make sure to click Save before moving on.

Note

When you create an application using https://apps.dev.microsoft.com/?deeplink=/appList, 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.

Build a quick start app

Now that you have a Microsoft app, you can complete one of our v2.0 quick start tutorials. Here are a few recommendations:

Mobile and native apps Web apps and web APIs Integrate directly with protocols
Add sign-in to an iOS application Add sign-in to a JavaScript Single Page Application (SPA) Register an application
Add sign-in to an Android application Add sign-in to a .NET model-view-controller (MVC) application Mobile applications with the OAuth 2.0 protocol
Add sign-in to a Windows Desktop application Add sign-in to a Node.js web application Web applications with the OpenID Connect protocol
Add sign-in to a multi-platform Xamarin application JavaScript SPAs with the OpenID Connect protocol
Daemon applications with the OAuth 2.0 client credentials flow