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
# Customer intent: As an identity administrator, I want to encourage users to use the Microsoft Authenticator app in Azure AD to improve and secure user sign-in events.
13
13
---
14
-
# How to use additional context in Microsoft Authenticator notifications (Preview) - Authentication Methods Policy
14
+
# How to use additional context in Microsoft Authenticator notifications (Preview) - Authentication methods policy
15
15
16
16
This topic covers how to improve the security of user sign-in by adding the application name and geographic location of the sign-in to Microsoft Authenticator push and passwordless notifications.
17
17
@@ -45,12 +45,12 @@ You can enable and disable application name and geographic location separately.
45
45
46
46
Identify your single target group for each of the features. Then use the following API endpoint to change the displayAppInformationRequiredState or displayLocationInformationRequiredState properties under featureSettings to **enabled** and include or exclude the groups you want::
>For Passwordless phone sign-in, the Authenticator app does not retrieve policy information just in time for each sign-in request. Instead, the Authenticator app does a best effort retrieval of the policy once every 7 days. We understand this limitation is less than ideal and are working to optimize the behavior. In the meantime, if you want to force a policy update to test using additional context with Passwordless phone sign-in, you can remove and re-add the account in the Authenticator app.
| includeTargets |[microsoftAuthenticatorAuthenticationMethodTarget](/graph/api/resources/passwordlessmicrosoftauthenticatorauthenticationmethodtarget) collection | A collection of users or groups who are enabled to use the authentication method. |
67
67
| featureSettings |[microsoftAuthenticatorFeatureSettings](/graph/api/resources/passwordlessmicrosoftauthenticatorauthenticationmethodtarget) collection | A collection of Microsoft Authenticator features. |
| displayAppInformationRequiredState | authenticationMethodFeatureConfiguration | Determines whether the user is shown application name in Microsoft Authenticator notification. |
87
87
| displayLocationInformationRequiredState | authenticationMethodFeatureConfiguration | Determines whether the user is shown geographic location context in Microsoft Authenticator notification. |
| includeTarget | featureTarget | A single entity that is included in this feature. <br>You can only include one group for each feature.|
97
97
| State | advancedConfigState | Possible values are:<br>**enabled** explicitly enables the feature for the selected group.<br>**disabled** explicitly disables the feature for the selected group.<br>**default** allows Azure AD to manage whether the feature is enabled or not for the selected group. |
| targetType | featureTargetType | The kind of entity targeted, such as group, role, or administrative unit. The possible values are: ‘group’, 'administrativeUnit’, ‘role’, unknownFutureValue’. |
107
107
108
-
####Example of how to enable additional context for all users
108
+
### Example of how to enable additional context for all users
109
109
110
110
In **featureSettings**, change **displayAppInformationRequiredState** and **displayLocationInformationRequiredState** from **default** to **enabled**.
111
111
@@ -162,7 +162,7 @@ Only users who are enabled for Microsoft Authenticator under Microsoft Authentic
162
162
```
163
163
164
164
165
-
####Example of how to enable application name and geographic location for separate groups
165
+
### Example of how to enable application name and geographic location for separate groups
166
166
167
167
In **featureSettings**, change **displayAppInformationRequiredState** and **displayLocationInformationRequiredState** from **default** to **enabled.**
168
168
Inside the **includeTarget** for each featureSetting, change the **id** from **all_users** to the ObjectID of the group from the Azure AD portal.
@@ -213,10 +213,13 @@ Only users who are enabled for Microsoft Authenticator under Microsoft Authentic
213
213
}
214
214
```
215
215
216
-
To verify, RUN GET again and verify the ObjectID
216
+
To verify, RUN GET again and verify the ObjectID:
217
+
218
+
```http
217
219
GET https://graph.microsoft.com/beta/authenticationMethodsPolicy/authenticationMethodConfigurations/MicrosoftAuthenticator
218
-
219
-
#### Example of how to disable application name and only enable geographic location
220
+
```
221
+
222
+
### Example of how to disable application name and only enable geographic location
220
223
221
224
In **featureSettings**, change the state of **displayAppInformationRequiredState** to **default** or **disabled** and **displayLocationInformationRequiredState** to **enabled.**
222
225
Inside the **includeTarget** for each featureSetting, change the **id** from **all_users** to the ObjectID of the group from the Azure AD portal.
@@ -267,7 +270,7 @@ Only users who are enabled for Microsoft Authenticator under Microsoft Authentic
267
270
}
268
271
```
269
272
270
-
####Example of how to exclude a group from application name and geographic location
273
+
### Example of how to exclude a group from application name and geographic location
271
274
272
275
In **featureSettings**, change the states of **displayAppInformationRequiredState** and **displayLocationInformationRequiredState** to from **default** to **enabled.**
273
276
Inside the **includeTarget** for each featureSetting, change the **id** from **all_users** to the ObjectID of the group from the Azure AD portal.
@@ -319,7 +322,8 @@ Only users who are enabled for Microsoft Authenticator under Microsoft Authentic
319
322
]
320
323
}
321
324
```
322
-
#### Example of removing the excluded group
325
+
326
+
### Example of removing the excluded group
323
327
324
328
In **featureSettings**, change the states of **displayAppInformationRequiredState** from **default** to **enabled.**
325
329
You need to change the **id** of the **excludeTarget** to `00000000-0000-0000-0000-000000000000`.
@@ -359,7 +363,7 @@ Only users who are enabled for Microsoft Authenticator under Microsoft Authentic
359
363
}
360
364
```
361
365
362
-
###Turn off additional context
366
+
## Turn off additional context
363
367
364
368
To turn off additional context, you'll need to PATCH **displayAppInformationRequiredState** and **displayLocationInformationRequiredState** from **enabled** to **disabled**/**default**. You can also turn off just one of the features.
Copy file name to clipboardExpand all lines: articles/active-directory/authentication/how-to-mfa-number-match.md
+17-12Lines changed: 17 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -90,12 +90,12 @@ To create the registry key that overrides push notifications:
90
90
91
91
Identify your single target group for the schema configuration. Then use the following API endpoint to change the numberMatchingRequiredState property under featureSettings to **enabled** and include or exclude groups:
| includeTargets |[microsoftAuthenticatorAuthenticationMethodTarget](/graph/api/resources/passwordlessmicrosoftauthenticatorauthenticationmethodtarget?view=graph-rest-beta&preserve-view=true) collection | A collection of users or groups who are enabled to use the authentication method |
112
112
| featureSettings |[microsoftAuthenticatorFeatureSettings](/graph/api/resources/passwordlessmicrosoftauthenticatorauthenticationmethodtarget) collection | A collection of Microsoft Authenticator features. |
| displayAppInformationRequiredState | authenticationMethodFeatureConfiguration | Determines whether the user is shown application name in Microsoft Authenticator notification. |
134
134
| displayLocationInformationRequiredState | authenticationMethodFeatureConfiguration | Determines whether the user is shown geographic location context in Microsoft Authenticator notification. |
| includeTarget | featureTarget | A single entity that is included in this feature. <br> Please note: You will be able to only set one group for number matching. |
144
144
| State | advancedConfigState | Possible values are:<br>**enabled** explicitly enables the feature for the selected group.<br>**disabled** explicitly disables the feature for the selected group.<br>**default** allows Azure AD to manage whether the feature is enabled or not for the selected group. |
0 commit comments