You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/active-directory/authentication/how-to-mfa-number-match.md
+33-8Lines changed: 33 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ description: Learn how to use number matching in MFA notifications
4
4
ms.service: active-directory
5
5
ms.subservice: authentication
6
6
ms.topic: conceptual
7
-
ms.date: 01/27/2023
7
+
ms.date: 01/29/2023
8
8
ms.author: justinha
9
9
author: mjsantani
10
10
ms.collection: M365-identity-device-management
@@ -68,16 +68,32 @@ AD FS adapter will require number matching on supported versions of Windows Serv
68
68
69
69
### NPS extension
70
70
71
-
Make sure you run the latest version of the [NPS extension](https://www.microsoft.com/download/details.aspx?id=54688). Until February 27, 2023, users are asked to enter a One-Time Passcode (OTP) for push notifications beginning with NPS extension 1.2.2131.2 _only_ if number matching is enabled. After February 27, 2023, number matching will be enabled by default and all users with push notifications beginning with NPS extension 1.2.2131.2 will be asked to enter an OTP.
71
+
The latest NPS extension doesn't support number matching, but it does support One-Time Passwords (OTP) methods such as SMS, the OTP available in Microsoft Authenticator, other software tokens, and hardware FOBs. Make sure you run the latest version of the [NPS extension](https://www.microsoft.com/download/details.aspx?id=54688).
72
72
73
-
The user must have an OTP authentication method registered to see this behavior. Common OTP authentication methods include the OTP available in Microsoft Authenticator, other software tokens, and so on. For OTP to work, the VPN needs to use PAP protocol. For more information, see [Determine which authentication methods your users can use](howto-mfa-nps-extension.md#determine-which-authentication-methods-your-users-can-use).
73
+
After Feb 27, 2023, when number matching is enabled for all users, anyone who performs a VPN connection with NPS extension version 1.2.2216.1 or later will be prompted to sign in with an OTP method instead. No other configuration is required on the NPS Server.
74
74
75
-
>[!NOTE]
76
-
>If the user doesn't have an OTP method registered, they'll continue to get the **Approve**/**Deny** experience. A user who can't use an OTP will always see the **Approve**/**Deny** experience with push notifications triggered by a legacy NPS extension.
75
+
Users must have an OTP authentication method registered to see this behavior. Users who don't have an OTP method registered will continue to see **Approve**/**Deny** options.
76
+
77
+
For OTP to work, the VPN needs to use PAP protocol. For more information, see [Determine which authentication methods your users can use](howto-mfa-nps-extension.md#determine-which-authentication-methods-your-users-can-use).
78
+
79
+
>[!IMPORTANT]
80
+
>Organizations using a RADIUS protocol other than PAP will see user VPN authorization failing, with these events appearing in the **AuthZOptCh** log of the NPS Extension server in Event Viewer:<br>
81
+
>NPS Extension for Azure MFA: CID: 2f6fa289-6243-4aa3-b317-907ac2324ae8 : Challenge requested in Authentication Ext for User npstesting_app with state 22088b7d-6cb9-45e1-a99c-5de60240a991
82
+
83
+
Prior to the release of NPS extension version 1.2.2216.1 after February 27, 2023, organizations that run any of these earlier versions of NPS extension can modify the registry to require users to enter an OTP:
77
84
78
-
Earlier versions of the NPS extension beginning with 1.0.1.40 also support number matching, but you need to create a registry key that overrides push notifications to ask a user to enter an OTP. If you don't create the registry key, or you run a version prior to 1.0.1.40, users who are enabled for number matching will be prompted to **Approve**/**Deny**.
85
+
- 1.2.2131.2
86
+
- 1.2.1959.1
87
+
- 1.2.1916.2
88
+
- 1.1.1892.2
89
+
- 1.0.1850.1
90
+
- 1.0.1.41
91
+
- 1.0.1.40
79
92
80
-
To create the registry key that overrides push notifications:
93
+
>[!NOTE]
94
+
>NPS extensions versions earlier than 1.0.1.40 don't support OTP enforced by number matching. These versions will continue to present users with **Approve**/**Deny**.
95
+
96
+
The NPS Server where the NPS Extension is installed must be configured to use PAP protocol. To create the registry key to override the **Approve**/**Deny** options in push notifications and require an OTP instead:
81
97
82
98
1. On the NPS Server, open the Registry Editor.
83
99
1. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\AzureMfa.
@@ -86,7 +102,16 @@ To create the registry key that overrides push notifications:
86
102
Value = TRUE
87
103
1. Restart the NPS Service.
88
104
89
-
If you're using Remote Desktop Gateway and the user is registered for OTP code along with Microsoft Authenticator push notifications, the user won't be able to meet the Azure AD MFA challenge and Remote Desktop Gateway sign-in will fail. In this case, you can set OVERRIDE_NUMBER_MATCHING_WITH_OTP = FALSE to fall back to push notifications with Microsoft Authenticator.
105
+
In addition:
106
+
107
+
- Users who perform OTP must have either Microsoft Authenticator registered as an authentication method, or some other hardware or software OATH token. A user who can't use an OTP method will always see **Approve**/**Deny** options with push notifications if they use a version of NPS extension earlier than 1.2.2216.1.
108
+
- Users must be [enabled for number matching](#enable-number-matching-in-the-portal).
109
+
- The VPN server must be configured to use PAP protocol.
110
+
111
+
>[!NOTE]
112
+
>MSCHAPv2 doesn't support One-Time Passwords.
113
+
114
+
If your organization uses Remote Desktop Gateway and the user is registered for OTP code along with Microsoft Authenticator push notifications, the user won't be able to meet the Azure AD MFA challenge and Remote Desktop Gateway sign-in will fail. In this case, you can set OVERRIDE_NUMBER_MATCHING_WITH_OTP = FALSE to fall back to **Approve**/**Deny** push notifications with Microsoft Authenticator.
90
115
91
116
### Apple Watch supported for Microsoft Authenticator
0 commit comments