Skip to content

Commit a5a1bf8

Browse files
committed
review fixes
1 parent 8ac57a9 commit a5a1bf8

File tree

2 files changed

+36
-27
lines changed

2 files changed

+36
-27
lines changed

articles/active-directory/authentication/how-to-mfa-additional-context.md

Lines changed: 19 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ ms.collection: M365-identity-device-management
1111

1212
# 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.
1313
---
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
1515

1616
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.
1717

@@ -45,12 +45,12 @@ You can enable and disable application name and geographic location separately.
4545

4646
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::
4747

48-
https://graph.microsoft.com/beta/authenticationMethodsPolicy/authenticationMethodConfigurations/MicrosoftAuthenticator
48+
`https://graph.microsoft.com/beta/authenticationMethodsPolicy/authenticationMethodConfigurations/MicrosoftAuthenticator`
4949

5050
>[!NOTE]
5151
>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.
5252
53-
#### MicrosoftAuthenticatorAuthenticationMethodConfiguration properties
53+
### MicrosoftAuthenticatorAuthenticationMethodConfiguration properties
5454

5555
**PROPERTIES**
5656

@@ -66,7 +66,7 @@ https://graph.microsoft.com/beta/authenticationMethodsPolicy/authenticationMetho
6666
| includeTargets | [microsoftAuthenticatorAuthenticationMethodTarget](/graph/api/resources/passwordlessmicrosoftauthenticatorauthenticationmethodtarget) collection | A collection of users or groups who are enabled to use the authentication method. |
6767
| featureSettings | [microsoftAuthenticatorFeatureSettings](/graph/api/resources/passwordlessmicrosoftauthenticatorauthenticationmethodtarget) collection | A collection of Microsoft Authenticator features. |
6868

69-
#### MicrosoftAuthenticator includeTarget properties
69+
### MicrosoftAuthenticator includeTarget properties
7070

7171
**PROPERTIES**
7272

@@ -76,7 +76,7 @@ https://graph.microsoft.com/beta/authenticationMethodsPolicy/authenticationMetho
7676
| id | String | Object ID of an Azure AD user or group. |
7777
| targetType | authenticationMethodTargetType | Possible values are: **user**, **group**.|
7878

79-
#### MicrosoftAuthenticator featureSettings properties
79+
### MicrosoftAuthenticator featureSettings properties
8080

8181
**PROPERTIES**
8282

@@ -86,7 +86,7 @@ https://graph.microsoft.com/beta/authenticationMethodsPolicy/authenticationMetho
8686
| displayAppInformationRequiredState | authenticationMethodFeatureConfiguration | Determines whether the user is shown application name in Microsoft Authenticator notification. |
8787
| displayLocationInformationRequiredState | authenticationMethodFeatureConfiguration | Determines whether the user is shown geographic location context in Microsoft Authenticator notification. |
8888

89-
#### Authentication Method Feature Configuration properties
89+
### Authentication Method Feature Configuration properties
9090

9191
**PROPERTIES**
9292

@@ -96,7 +96,7 @@ https://graph.microsoft.com/beta/authenticationMethodsPolicy/authenticationMetho
9696
| includeTarget | featureTarget | A single entity that is included in this feature. <br>You can only include one group for each feature.|
9797
| 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. |
9898

99-
#### Feature Target properties
99+
### Feature Target properties
100100

101101
**PROPERTIES**
102102

@@ -105,7 +105,7 @@ https://graph.microsoft.com/beta/authenticationMethodsPolicy/authenticationMetho
105105
| id | String | ID of the entity targeted. |
106106
| targetType | featureTargetType | The kind of entity targeted, such as group, role, or administrative unit. The possible values are: ‘group’, 'administrativeUnit’, ‘role’, unknownFutureValue’. |
107107

108-
#### Example of how to enable additional context for all users
108+
### Example of how to enable additional context for all users
109109

110110
In **featureSettings**, change **displayAppInformationRequiredState** and **displayLocationInformationRequiredState** from **default** to **enabled**.
111111

@@ -162,7 +162,7 @@ Only users who are enabled for Microsoft Authenticator under Microsoft Authentic
162162
```
163163

164164

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
166166

167167
In **featureSettings**, change **displayAppInformationRequiredState** and **displayLocationInformationRequiredState** from **default** to **enabled.**
168168
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
213213
}
214214
```
215215

216-
To verify, RUN GET again and verify the ObjectID
216+
To verify, RUN GET again and verify the ObjectID:
217+
218+
```http
217219
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
220223

221224
In **featureSettings**, change the state of **displayAppInformationRequiredState** to **default** or **disabled** and **displayLocationInformationRequiredState** to **enabled.**
222225
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
267270
}
268271
```
269272

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
271274

272275
In **featureSettings**, change the states of **displayAppInformationRequiredState** and **displayLocationInformationRequiredState** to from **default** to **enabled.**
273276
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
319322
]
320323
}
321324
```
322-
#### Example of removing the excluded group
325+
326+
### Example of removing the excluded group
323327

324328
In **featureSettings**, change the states of **displayAppInformationRequiredState** from **default** to **enabled.**
325329
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
359363
}
360364
```
361365

362-
### Turn off additional context
366+
## Turn off additional context
363367

364368
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.
365369

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

Lines changed: 17 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -90,12 +90,12 @@ To create the registry key that overrides push notifications:
9090
9191
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:
9292

93-
```
93+
```http
9494
https://graph.microsoft.com/beta/authenticationMethodsPolicy/authenticationMethodConfigurations/MicrosoftAuthenticator
9595
```
9696

9797

98-
#### MicrosoftAuthenticatorAuthenticationMethodConfiguration properties
98+
### MicrosoftAuthenticatorAuthenticationMethodConfiguration properties
9999

100100
**PROPERTIES**
101101

@@ -111,7 +111,7 @@ https://graph.microsoft.com/beta/authenticationMethodsPolicy/authenticationMetho
111111
| 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 |
112112
| featureSettings | [microsoftAuthenticatorFeatureSettings](/graph/api/resources/passwordlessmicrosoftauthenticatorauthenticationmethodtarget) collection | A collection of Microsoft Authenticator features. |
113113

114-
#### MicrosoftAuthenticator includeTarget properties
114+
### MicrosoftAuthenticator includeTarget properties
115115

116116
**PROPERTIES**
117117

@@ -123,7 +123,7 @@ https://graph.microsoft.com/beta/authenticationMethodsPolicy/authenticationMetho
123123

124124

125125

126-
#### MicrosoftAuthenticator featureSettings properties
126+
### MicrosoftAuthenticator featureSettings properties
127127

128128
**PROPERTIES**
129129

@@ -133,7 +133,7 @@ https://graph.microsoft.com/beta/authenticationMethodsPolicy/authenticationMetho
133133
| displayAppInformationRequiredState | authenticationMethodFeatureConfiguration | Determines whether the user is shown application name in Microsoft Authenticator notification. |
134134
| displayLocationInformationRequiredState | authenticationMethodFeatureConfiguration | Determines whether the user is shown geographic location context in Microsoft Authenticator notification. |
135135

136-
#### Authentication Method Feature Configuration properties
136+
### Authentication Method Feature Configuration properties
137137

138138
**PROPERTIES**
139139

@@ -143,7 +143,7 @@ https://graph.microsoft.com/beta/authenticationMethodsPolicy/authenticationMetho
143143
| 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. |
144144
| 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. |
145145

146-
#### Feature Target properties
146+
### Feature Target properties
147147

148148
**PROPERTIES**
149149

@@ -155,7 +155,7 @@ https://graph.microsoft.com/beta/authenticationMethodsPolicy/authenticationMetho
155155
>[!NOTE]
156156
>Number matching can be enabled only for a single group.
157157
158-
#### Example of how to enable number matching for all users
158+
### Example of how to enable number matching for all users
159159

160160
In **featureSettings**, you will need to change the **numberMatchingRequiredState** from **default** to **enabled**.
161161

@@ -205,10 +205,12 @@ Only users who are enabled for Microsoft Authenticator under Microsoft Authentic
205205
```
206206

207207
To confirm this has applied, please run the GET request below using the endpoint below.
208-
GET - https://graph.microsoft.com/beta/authenticationMethodsPolicy/authenticationMethodConfigurations/MicrosoftAuthenticator
209-
208+
209+
```http
210+
GET https://graph.microsoft.com/beta/authenticationMethodsPolicy/authenticationMethodConfigurations/MicrosoftAuthenticator
211+
```
210212

211-
#### Example of how to enable number matching for a single group
213+
### Example of how to enable number matching for a single group
212214

213215
In **featureSettings**, you will need to change the **numberMatchingRequiredState** value from **default** to **enabled.**
214216
Inside the **includeTarget**, you will need to change the **id** from **all_users** to the ObjectID of the group from the Azure AD portal.
@@ -249,9 +251,12 @@ Only users who are enabled for Microsoft Authenticator under Microsoft Authentic
249251
```
250252

251253
To verify, RUN GET again and verify the ObjectID
254+
255+
```http
252256
GET https://graph.microsoft.com/beta/authenticationMethodsPolicy/authenticationMethodConfigurations/MicrosoftAuthenticator
257+
```
253258

254-
#### Example of removing the excluded group from number matching
259+
### Example of removing the excluded group from number matching
255260

256261
In **featureSettings**, you will need to change the **numberMatchingRequiredState** value from **default** to **enabled.**
257262
You need to change the **id** of the **excludeTarget** to `00000000-0000-0000-0000-000000000000`.
@@ -291,7 +296,7 @@ Only users who are enabled for Microsoft Authenticator under Microsoft Authentic
291296
}
292297
```
293298

294-
### Turn off number matching
299+
## Turn off number matching
295300

296301
To turn number matching off, you will need to PATCH remove **numberMatchingRequiredState** from **enabled** to **disabled**/**default**.
297302

0 commit comments

Comments
 (0)