Authentication registration campaigns
Microsoft's edit ·
Microsoft's commit message in MicrosoftDocs/entra-docs · commit 43078f8 · +48 −25 lines · also on GitHub
⋯ 201 unchanged lines
202202
203203
:::image type="content" source="./media/how-to-mfa-registration-campaign/enabled-passkey-campaign.png" alt-text="Screenshot that shows the Registration campaign page in the Microsoft Entra admin center showing an enabled passkey campaign with authentication method, snooze settings, and include/exclude targets." lightbox="./media/how-to-mfa-registration-campaign/enabled-passkey-campaign.png" border="true":::
204204
205
−## Passkey nudge evaluation by platform
205
+<a id="passkey-nudge-evaluation-by-platform"></a>
206206
207
−After a user is deemed eligible to enroll a passkey based on the registration campaign settings, the campaign performs a further evaluation before nudging them. The campaign checks whether the user already has a local passkey for their current OS and browser combination (platform).
207
+## How passkey registration nudges are evaluated
208208
209
−The following table shows which platform passkey types suppress the nudge on each OS and browser combination. **A user needs at least one matching passkey type on an OS and browser combination for the nudge to be suppressed**. Otherwise, if all other campaign requirements are met, they're nudged to register a compatible passkey type.
209
+After a user meets the registration campaign’s eligibility requirements, their passkey profile determines whether existing registered passkeys suppress the nudge across all platforms or only for the current operating system and browser combination (platform). **Start with the profile table. Use the platform table only when platform-specific evaluation applies.**
210210
211
+These rules apply to passkey campaigns in both the **Enabled** and **Microsoft managed** states. They are separate from the Microsoft managed profile eligibility check, which determines whether a user is eligible for the campaign.
211212
212
−| Available passkey type | Windows + Chrome | Windows + other browsers | macOS + Chrome | macOS + other browsers | iOS | Android |
213
−|---|---|---|---|---|---|---|
214
−| Windows Hello for Business | ✔️ | ✔️ | — | — | — | — |
215
−| Microsoft Entra passkey on Windows | ✔️ | ✔️ | — | — | — | — |
216
−| Google Password Manager | ✔️ | — | ✔️ | — | — | ✔️ |
217
−| iCloud Keychain (including Managed) | — | — | ✔️ | ✔️ | ✔️ | — |
218
−| macOS Platform SSO | — | — | ✔️ | ✔️ | — | — |
219
−| Samsung Pass | — | — | — | — | — | ✔️ |
220
−| Passkey in Microsoft Authenticator | — | — | — | — | ✔️ | ✔️ |
221
−| Any cross-platform provider, such as a security key | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
213
+<a id="how-the-passkey-profile-affects-the-nudge-evaluation"></a>
222214
223
−✔️ Nudge is suppressed in this combination
215
+### Step 1: Determine how the passkey profile affects the nudge
224216
225
−For example, if a user has a Windows Hello for Business credential and signs in on Windows with Chrome, the nudge is suppressed. But if the same user signs in on a Mac with Chrome browser, they're nudged because that credential is not available to be used on this OS and browser combination.
217
+Some passkey profiles evaluate credentials separately for each OS and browser combination. Other profiles suppress nudges across platforms after the user registers an eligible passkey.
226218
219
+| Passkey profile configuration | Does platform-specific evaluation apply? | When is the nudge suppressed? |
220
+| --- | --- | --- |
221
+| **Unrestricted** | Yes | When the user has a qualifying credential available for the current OS and browser combination. See the platform table below. |
222
+| **Synced-only** | Yes | When the user has a qualifying local **synced** passkey available for the current platform. Otherwise, the user is nudged on platforms where a compatible synced passkey can be registered. |
223
+| **Device-bound-only** | Yes | When the user has a qualifying local **device-bound** passkey available for the current platform. Otherwise, the user is nudged on platforms where a compatible device-bound passkey can be registered. |
224
+| **AAGUID-restricted** | No | After the user registers **one eligible passkey**, the nudge is suppressed across OS and browser combinations under this profile’s rule. |
225
+| **Device-bound with attestation enforced** | No | After the user registers **one eligible passkey**, the nudge is suppressed across OS and browser combinations under this profile’s rule. |
226
+
227
+An **eligible passkey** must meet the applicable profile requirements. Registering a passkey that doesn’t meet those requirements doesn’t satisfy the profile’s nudge-suppression condition.
228
+
229
+### Step 2: Evaluate the platform, when required
230
+
231
+For **unrestricted, synced-only, and device-bound-only profiles**, the campaign evaluates whether a qualifying credential is available for the user’s current OS and browser combination.
232
+
233
+A credential registered on the account doesn’t necessarily suppress the nudge on every platform. It must qualify under the applicable profile and satisfy the platform-specific rule.
234
+
235
+The following table shows which available credential types suppress the nudge on each platform.
236
+
237
+| Available credential type | Windows + Chrome | Windows + other browsers | macOS + Chrome | macOS + other browsers | iOS | Android |
238
+| --- | --- | --- | --- | --- | --- | --- |
239
+| Windows Hello for Business | ✓ | ✓ | — | — | — | — |
240
+| Microsoft Entra passkey on Windows | ✓ | ✓ | — | — | — | — |
241
+| Google Password Manager | ✓ | — | ✓ | — | — | ✓ |
242
+| iCloud Keychain, including Managed | — | — | ✓ | ✓ | ✓ | — |
243
+| macOS Platform SSO | — | — | ✓ | ✓ | — | — |
244
+| Samsung Pass | — | — | — | — | — | ✓ |
245
+| Passkey in Microsoft Authenticator | — | — | — | — | ✓ | ✓ |
246
+| Any cross-platform provider, such as a security key | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
247
+
248
+**✓** The available credential suppresses the platform-specific nudge, subject to the applicable profile requirements.
249
+
250
+**—** The credential doesn’t suppress the nudge under this platform-specific rule. This symbol is **not** a statement about whether the credential can be used to authenticate on that platform.
251
+
227252
> [!NOTE]
228
−> Linux users aren't nudged by passkey registration campaigns.
253
+> Linux users aren’t nudged by passkey registration campaigns.
229254
230
−### How the passkey profile affects the nudge evaluation
255
+### Examples
231256
232
−The passkey nudge evaluation by platform applies when the campaign is in either the Enabled or Microsoft managed state. The evaluation also depends on the passkey profiles configured for the user. The following table describes the behavior for each passkey profile type the user is in scope for.
257
+The following examples assume that all other campaign requirements are met and that the user is scoped only to the profile described.
233258
234
−| Passkey profile configuration | How the nudge is evaluated |
235
−|---|---|
236
−| Unrestricted | Suppressed per OS and browser according to the preceding table, once the user has a qualifying local passkey for that platform. |
237
−| Synced-only | The user is nudged to register a local **synced** passkey on each platform where one is possible. The nudge is suppressed on a platform after the user has a qualifying local synced passkey available. |
238
−| Device-bound-only | The user is nudged to register a local **device-bound** passkey on each platform where one is possible. The nudge is suppressed on a platform after the user has a qualifying local device-bound passkey available. |
239
−| AAGUID-restricted | The per-platform evaluation doesn't apply. After the user registers **one eligible** passkey, the nudge stops on all OS and browser combinations. |
240
−| Device-bound with attestation enforced | The per-platform evaluation doesn't apply. After the user registers **one eligible** passkey, the nudge stops on all OS and browser combinations. |
259
+| Scenario | Expected nudge behavior |
260
+| --- | --- |
261
+| A user has an unrestricted profile and Windows Hello for Business available on Windows with Chrome. | The nudge is suppressed for that platform. |
262
+| The same user signs in on macOS with Chrome and has no qualifying credential available there. | The user is nudged to register a compatible passkey. Their Windows Hello for Business credential doesn’t suppress the macOS nudge. |
263
+| A user has an AAGUID-restricted profile and has registered a passkey that meets its requirements. | The nudge is suppressed across OS and browser combinations under that profile’s rule; the platform table isn’t used. |
241264
242265
## Enable the registration campaign policy by using Graph Explorer
243266
⋯ 304 unchanged lines
Microsoft's Markdown source from MicrosoftDocs/entra-docs, © Microsoft Corporation, under MIT. Changed lines with up to 3 unchanged lines around each; ChangeIntel kept this copy 13 Oct 00:24 UTC. The commit date is when the source changed, which can be hours or days before Learn published it.