Skip to content

docs: SSO troubleshooting, MI setup, and preview status updates#2891

Merged
corinagum merged 5 commits into
mainfrom
cg/sso-docs-and-preview-updates
Jun 16, 2026
Merged

docs: SSO troubleshooting, MI setup, and preview status updates#2891
corinagum merged 5 commits into
mainfrom
cg/sso-docs-and-preview-updates

Conversation

@corinagum

@corinagum corinagum commented Jun 16, 2026

Copy link
Copy Markdown
Collaborator

Summary

Documentation updates driven by customer feedback (Discussion #2881, Issue #2871).
Fixes #2871

SSO Documentation (new content)

  • SSO with User-Assigned Managed Identity: New section in sso-setup.mdx explaining how IDs map when the bot uses MI and a separate auth app registration
  • Cross-Tenant Considerations: New section covering tenant requirements for SSO to work silently
  • authrequestfailed troubleshooting: New section in troubleshooting-sso.mdx for cross-tenant SSO failures
  • OAuth card fallback and magic code: Documents when/why the magic code appears and the signin() + app.event('signin') pattern

Preview Status Updates

  • Targeted messages: "coming soon in May 2026" -> "available in public preview"
  • Slash commands: same update
  • Quoted replies: removed "Coming Soon" callout (now GA)
  • Removed C# experimental note for quoted replies (ExperimentalTeamsQuotedReplies being removed in companion PRs)

Companion PRs

Copilot AI review requested due to automatic review settings June 16, 2026 17:52

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Docs refresh to address customer-reported confusion around SSO (cross-tenant + managed identity) and to update feature availability messaging across the essentials docs.

Changes:

  • Update “Coming soon May 2026” callouts to “public preview” (and remove quoted-replies “coming soon” note).
  • Add SSO guidance for user-assigned managed identity setups + cross-tenant behavior/requirements.
  • Add troubleshooting guidance for authrequestfailed plus OAuth fallback + magic code behavior.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
teams.md/src/pages/templates/essentials/sending-messages/README.mdx Updates targeted-messages status to Preview; removes quoted-replies “coming soon” callout.
teams.md/src/pages/templates/essentials/sending-messages/proactive-messaging.mdx Updates proactive targeted-messages status to Preview.
teams.md/src/pages/templates/essentials/on-activity/README.mdx Updates slash-commands status text to public preview.
teams.md/src/components/include/essentials/sending-messages/csharp.incl.md Removes .NET quoted-replies experimental/opt-in note (now N/A).
teams.md/docs/main/teams/user-authentication/troubleshooting-sso.mdx Adds authrequestfailed + magic code/OAuth fallback guidance; includes TS snippet needing minor corrections.
teams.md/docs/main/teams/user-authentication/sso-setup.mdx Adds managed identity mapping section + cross-tenant considerations; clarifies URI expectations.

Comment thread teams.md/docs/main/teams/user-authentication/troubleshooting-sso.mdx Outdated
Comment thread teams.md/docs/main/teams/user-authentication/troubleshooting-sso.mdx Outdated
Comment thread teams.md/docs/main/teams/user-authentication/sso-setup.mdx
Comment thread teams.md/docs/main/teams/user-authentication/sso-setup.mdx
Comment thread teams.md/docs/main/teams/user-authentication/sso-setup.mdx Outdated
Comment thread teams.md/docs/main/teams/user-authentication/troubleshooting-sso.mdx Outdated
…nippet

- Replace isSignedIn with signin() return pattern per reviewer feedback
- Move cross-tenant section from sso-setup to troubleshooting
- Add cross-tenant magic code caveat (identity mismatch breaks correlation)
- Keep a short cross-reference link in sso-setup

Co-authored-by: Copilot <[email protected]>
@corinagum
corinagum merged commit 2f41244 into main Jun 16, 2026
2 checks passed
@corinagum
corinagum deleted the cg/sso-docs-and-preview-updates branch June 16, 2026 22:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug]: Targeted Messages and other features state they were coming in May 2026

4 participants