Skip to content

Revise device registration steps for Shared Device Mode#65

Open
CarHern wants to merge 1 commit into
MicrosoftDocs:mainfrom
CarHern:patch-1
Open

Revise device registration steps for Shared Device Mode#65
CarHern wants to merge 1 commit into
MicrosoftDocs:mainfrom
CarHern:patch-1

Conversation

@CarHern

@CarHern CarHern commented May 28, 2026

Copy link
Copy Markdown

Updated instructions for registering a device in Shared Device Mode, including automatic registration and credential prompts. (current steps are WRONG and mislead customers) However, the screenshots need to be updated. please contact me directly (CAHER) to further discuss I can show you a video from last week on how the actual procedure looks like

image SDMCorrectFlow

Updated instructions for registering a device in Shared Device Mode, including automatic registration and credential prompts. (current steps are WRONG and mislead customers)
However, the screenshots need to be updated. please contact me directly (CAHER) to further discuss I can show you a video from last week on how the actual procedure looks like
@learn-build-service-prod

Copy link
Copy Markdown

Learn Build status updates of commit 024201c:

✅ Validation status: passed

File Status Preview URL Details
msal-objc-articles/set-up-ios-device-shared-mode.md ✅Succeeded View

For more details, please refer to the build report.

@learn-build-service-prod

Copy link
Copy Markdown

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@CarHern

CarHern commented Jun 26, 2026

Copy link
Copy Markdown
Author

#sign-off

:::image type="content" source="media/share-device-mode/cloud-administrator-provide-credentials.png " alt-text="Screenshot of the sign-in page in Authenticator app":::

1. Upon providing credentials, the device is successfully set in shared device mode.
1. f teh registration successed, the device is successfully set in shared device mode.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typos:
Current:
f teh registration successed, the device is successfully set in shared device mode.

Correction:
If the registration succeeded, the device is successfully set in shared device mode.

:::image type="content" source="media/share-device-mode/microsoft-authenticator-set-up-shared-device-mode.png " alt-text="Screenshot showing the device registration screen in app":::

1. The Authenticator app prompts you to provide your credentials, as shown:
1. If The Authenticator app prompts you to provide your credentials, as shown (please close the app and validate the SSO profile has been installed, DO NOT enter any email addess):

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typos:
Current:
If The Authenticator app prompts you to provide your credentials, as shown (please close the app and validate the SSO profile has been installed, DO NOT enter any email addess):

Possible Correction:
If The Authenticator app prompts you to provide your credentials, as shown, please close the app and validate the SSO profile has been installed (DO NOT enter any email addess):

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the customer-facing documentation for registering an iOS device in Shared Device Mode to reflect the actual (automatic) registration flow when an SSO profile is present, and to clarify what to do when Authenticator unexpectedly prompts for credentials.

Changes:

  • Replaces the prior “manual setup UI” guidance with an auto-registration-first flow.
  • Adds troubleshooting guidance instructing admins to verify the SSO profile/payload when unexpected prompts appear.
  • Adjusts the final “success” step to align with the updated flow (but currently contains typos).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.


1. Launch the Authenticator App.
1. On the Shared Device Mode manual setup UI, enter the organizational email and select “Register as Shared Device**, as shown:
1. The App should automatically start registering the device (as long as the SSO profile is already on the device) without any user interaction needed. If it doesn't try closing the app and validating the SSO payload is on the devcie and then re-open the Authenticator app:
Comment thread msal-objc-articles/set-up-ios-device-shared-mode.md
Comment thread msal-objc-articles/set-up-ios-device-shared-mode.md
@ShannonLeavitt

Copy link
Copy Markdown

@Dickson-Mwendia - Could you review the proposed changes? If you approve, we can fix the typos before we merge, unless @CarHern fixes them before we do.

IMPORTANT: When the changes are ready for publication, adding a #sign-off comment is the best way to signal that the PR is ready for the review team to merge.

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

@ShannonLeavitt ShannonLeavitt added the aq-pr-triaged Tracking label for the vendor PR Review team label Jul 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

aq-pr-triaged Tracking label for the vendor PR Review team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants