Skip to content

Commit a8840d4

Browse files
committed
edits from Ananda and Mayur
1 parent 95b9cdd commit a8840d4

File tree

2 files changed

+33
-8
lines changed

2 files changed

+33
-8
lines changed

articles/active-directory/authentication/how-to-mfa-number-match.md

Lines changed: 33 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to use number matching in MFA notifications
44
ms.service: active-directory
55
ms.subservice: authentication
66
ms.topic: conceptual
7-
ms.date: 01/27/2023
7+
ms.date: 01/29/2023
88
ms.author: justinha
99
author: mjsantani
1010
ms.collection: M365-identity-device-management
@@ -68,16 +68,32 @@ AD FS adapter will require number matching on supported versions of Windows Serv
6868

6969
### NPS extension
7070

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).
7272

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

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:
7784

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
7992

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:
8197

8298
1. On the NPS Server, open the Registry Editor.
8399
1. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\AzureMfa.
@@ -86,7 +102,16 @@ To create the registry key that overrides push notifications:
86102
Value = TRUE
87103
1. Restart the NPS Service.
88104

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

91116
### Apple Watch supported for Microsoft Authenticator
92117

-1.65 KB
Loading

0 commit comments

Comments
 (0)