Rediģēt

Kopīgot, izmantojot


Native authentication in Microsoft Entra External ID

Applies to: White circle with a gray X symbol. Workforce tenants Green circle with a white check mark symbol. External tenants (learn more)

Microsoft Entra’s native authentication allows you to have full control over the design of your mobile and desktop application sign-in experiences. Unlike browser-based solutions, native authentication enables you to create visually appealing, pixel-perfect authentication screens that seamlessly blend into your app’s interface. With this approach, you can fully customize the user interface, including design elements, logo placement, and layout, ensuring a consistent and branded look.

The standard app sign-in process, which relies on browser-delegated authentication, often results in a disruptive transition during authentication. Users are temporarily redirected to a system browser for authentication, only to be brought back to the app once the sign-in is complete.

While browser-delegated authentication offers benefits such as reduced attack vectors and support for single sign-on (SSO), it offers limited UI customization options and a poor user experience.

Available authentication methods

Currently, native authentication supports local account identity provider for two authentications methods:

  • Email with one-time passcode (OTP) sign-in.
  • Email and password sign-in with support for self-service password reset (SSPR).

Native authentication doesn't yet support federated identity providers such as social or enterprise identities.

When to use native authentication

When it comes to implementing authentication for mobile and desktop apps on External ID, you have two options:

  • Microsoft-hosted browser-delegated authentication.
  • Fully custom SDK based native authentication.

The approach you choose depends on your app’s specific requirements. While each app has unique authentication needs, there are some common considerations to keep in mind. Whether you choose native authentication or browser-delegated authentication, Microsoft Entra External ID supports both of them.

The following table compares the two authentication methods to help you decide then right option for your app.

Browser-delegated authentication Native authentication
User authentication experience Users are taken to a system browser or embedded browser for authentication only to be redirected back to the app when the sign-in is complete. This method is recommended if the redirection doesn't negatively affect the end user experience. Users have a rich, native sign-up and sign-in journey without ever leaving the app.
Customization experience Managed branding and customization options are available as an out-of-the-box feature. This API-centric approach offers a high level of customization, providing extensive flexibility in design and the ability to create tailored interactions and flows.
Applicability Suitable for workforce, B2B, and B2C apps, it can be used for native apps, single-page applications, and web apps. For customer first-party apps, when the same entity operates the authorization server and the app and the user perceives them both as the same entity.
Go live effort Low. Use it straight out of the box. High. The developer builds, owns, and maintains the authentication experience.
Maintenance effort Low. High. For each feature that Microsoft releases, you need to update the SDK to use it.
Security Most secure option. Security responsibility is shared with developers, and best practices need to be followed. It's prone to phishing attacks.
Supported languages and frameworks
  • ASP.NET Core
  • Android (Kotlin, Java)
  • iOS/macOS (Swift, Objective-C)
  • JavaScript
  • React
  • Angular
  • Nodejs
  • Python
  • Java
  • Android (Kotlin, Java)
  • iOS/macOS (Swift, Objective-C)
For other languages and platforms, you can use our native authentication API.

Feature availability

The following table shows the availability of features for browser-delegated and native authentication.

Browser-delegated authentication Native authentication
Sign-up and sign-in with email one-time passcode (OTP) ✔️ ✔️
Sign-up and sign-in with email and password ✔️ ✔️
Self-service password reset (SSPR) ✔️ ✔️
Custom claims provider ✔️ ✔️
Social identity provider sign-in ✔️
Multifactor authentication with email one-time passcode (OTP) ✔️
Multifactor authentication with SMS ✔️
Single sign-on (SSO) ✔️

How to enable native authentication

First, review the guidelines above on when to use native authentication. Then, have an internal discussion with your application's business owner, designer, and development team to determine if native authentication is necessary.

If your team has determined that native authentication is necessary for your application, follow these steps to enable native authentication in the Microsoft Entra admin center:

  1. Sign in to the Microsoft Entra admin center.
  2. Browse to Applications > App registrations and select your app.
  3. Navigate to Authentication and select the Settings tab.
  4. Select the Allow native authentication and the Allow public client flow field.

Once you have enabled both Allow native authentication and Allow public client flow, update your configuration code accordingly.

Update your configuration code

After enabling the native authentication APIs in the admin center, you still need to update your application’s configuration code to support native authentication flows for Android or iOS/macOS. To do so, you need to add the challenge type field to your configuration. Challenge types are a list of values that the app uses to notify Microsoft Entra about the authentication method it supports. You can find more information about native authentication challenge types here. If the configuration isn’t updated to integrate native authentication components, the native authentication SDKs and APIs won’t be usable.

Risk of enabling native authentication

Microsoft Entra's native authentication doesn't support single sign-on (SSO), and the responsibility for ensuring the security of the app lies with your development team.

How to use native authentication

You can build apps that use native authentication by using our native authentication APIs or the Microsoft Authentication Library (MSAL) SDK for Android and iOS/macOS. Whenever possible, we recommend using MSAL to add native authentication to your apps.

For more information on native authentication samples and tutorials, see the following table.

Language/
Platform
Code sample guide Build and integrate guide
Android (Kotlin) Sign in users Sign in users
iOS (Swift) Sign in users Sign in users
macOS (Swift) Sign in users Sign in users

If you're planning to create an app on a framework currently not supported by MSAL, you can use our authentication API. For more information, follow this API reference article.