Skip to content

Update legacy Exchange token documentation #12447

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 20 commits into from
Mar 3, 2025

Conversation

samantharamon
Copy link
Contributor

@samantharamon samantharamon commented Jan 10, 2025

  • Updates the description of the AllowLegacyExchangeTokens parameter of the Get-AuthenticationPolicy cmdlet.
  • Documents the date when legacy Exchange tokens were turned off by default.

Copy link

Learn Build status updates of commit 2ec9e2c:

✅ Validation status: passed

File Status Preview URL Details
exchange/exchange-ps/exchange/Get-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)

For more details, please refer to the build report.

For any questions, please:

Copy link

Learn Build status updates of commit 611648e:

✅ Validation status: passed

File Status Preview URL Details
exchange/exchange-ps/exchange/Get-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)

For more details, please refer to the build report.

For any questions, please:

Copy link

Learn Build status updates of commit 2426bfa:

✅ Validation status: passed

File Status Preview URL Details
exchange/exchange-ps/exchange/Get-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)

For more details, please refer to the build report.

For any questions, please:

Copy link

Learn Build status updates of commit bfa6f49:

✅ Validation status: passed

File Status Preview URL Details
exchange/exchange-ps/exchange/Get-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)

For more details, please refer to the build report.

For any questions, please:

Copy link

Learn Build status updates of commit ce9c622:

✅ Validation status: passed

File Status Preview URL Details
exchange/exchange-ps/exchange/Get-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)

For more details, please refer to the build report.

For any questions, please:

Copy link

Learn Build status updates of commit c85b2b5:

✅ Validation status: passed

File Status Preview URL Details
exchange/exchange-ps/exchange/Get-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)

For more details, please refer to the build report.

For any questions, please:

Copy link

Learn Build status updates of commit d9a4f09:

✅ Validation status: passed

File Status Preview URL Details
exchange/exchange-ps/exchange/Get-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)

For more details, please refer to the build report.

For any questions, please:

@@ -81,10 +81,13 @@ The AllowLegacyExchangeTokens switch specifies whether legacy Exchange tokens ar

Legacy Exchange tokens include Exchange user identity and callback tokens.

This switch also specifies the most recent date and time that an add-in was allowed or blocked from acquiring a token.
Copy link

Choose a reason for hiding this comment

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

most recent date and time

this is not exactly accurate and going to be confusing... the date updates once a week or so. In other words, it has a precision of about a week.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Updated.

**Important**:

- Currently, the AllowLegacyExchangeTokens switch only specifies whether legacy Exchange tokens are allowed in your organization. For now, disregard the empty Allowed and Blocked arrays returned by the switch.
- Legacy Exchange tokens will eventually be blocked by default in all cloud-based organizations. For more information, see [Nested app authentication and Outlook legacy tokens deprecation FAQ](https://learn.microsoft.com/office/dev/add-ins/outlook/faq-nested-app-auth-outlook-legacy-tokens#what-is-the-timeline-for-shutting-down-legacy-exchange-online-tokens).
- As of February 10, 2025, the AllowLegacyExchangeTokens switch specifies any add-in that requested an Exchange token.
Copy link

Choose a reason for hiding this comment

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

any add-in

I wonder if we should clarify that we're talking about 3rd party add-ins... E.g. Viva may still get those tokens (and people may see that in fiddler) but it's not gonna be listed. That may cause them to think telemetry is inaccurate, but the fact is Viva is simply excluded from the whole thing for now as they work on migration. Please check with Paul on whether we want to say anything here about this or not.

Copy link

Learn Build status updates of commit f20edd7:

✅ Validation status: passed

File Status Preview URL Details
exchange/exchange-ps/exchange/Get-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)

For more details, please refer to the build report.

For any questions, please:

Copy link

Learn Build status updates of commit 479baec:

✅ Validation status: passed

File Status Preview URL Details
exchange/exchange-ps/exchange/Get-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)

For more details, please refer to the build report.

For any questions, please:

Copy link

Learn Build status updates of commit 0d32ca1:

✅ Validation status: passed

File Status Preview URL Details
exchange/exchange-ps/exchange/Get-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)

For more details, please refer to the build report.

For any questions, please:

Copy link

Learn Build status updates of commit 1279fd8:

✅ Validation status: passed

File Status Preview URL Details
exchange/exchange-ps/exchange/Get-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)
exchange/exchange-ps/exchange/Remove-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)
exchange/exchange-ps/exchange/Set-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)

For more details, please refer to the build report.

For any questions, please:

@samantharamon samantharamon changed the title Update description of AllowLegacyExchangeTokens parameter Update legacy Exchange token documentation Feb 21, 2025
Copy link

Learn Build status updates of commit 644e2a6:

✅ Validation status: passed

File Status Preview URL Details
exchange/exchange-ps/exchange/Get-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)
exchange/exchange-ps/exchange/Remove-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)
exchange/exchange-ps/exchange/Set-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)

For more details, please refer to the build report.

For any questions, please:

Copy link
Contributor

@davidchesnut davidchesnut left a comment

Choose a reason for hiding this comment

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

One comment. but looks good!

Co-authored-by: David Chesnut <davech@microsoft.com>
Copy link

Learn Build status updates of commit bf2b82a:

✅ Validation status: passed

File Status Preview URL Details
exchange/exchange-ps/exchange/Get-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)
exchange/exchange-ps/exchange/Remove-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)
exchange/exchange-ps/exchange/Set-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)

For more details, please refer to the build report.

For any questions, please:

Copy link

Learn Build status updates of commit ff7bf23:

✅ Validation status: passed

File Status Preview URL Details
exchange/exchange-ps/exchange/Get-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)
exchange/exchange-ps/exchange/Remove-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)
exchange/exchange-ps/exchange/Set-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)

For more details, please refer to the build report.

For any questions, please:

Copy link

Learn Build status updates of commit c2566b4:

✅ Validation status: passed

File Status Preview URL Details
exchange/exchange-ps/exchange/Get-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)
exchange/exchange-ps/exchange/Remove-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)
exchange/exchange-ps/exchange/Set-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)

For more details, please refer to the build report.

For any questions, please:

Copy link

Learn Build status updates of commit bb11ebd:

✅ Validation status: passed

File Status Preview URL Details
exchange/exchange-ps/exchange/Get-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)
exchange/exchange-ps/exchange/Remove-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)
exchange/exchange-ps/exchange/Set-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)

For more details, please refer to the build report.

For any questions, please:

Copy link

Learn Build status updates of commit 82d866a:

✅ Validation status: passed

File Status Preview URL Details
exchange/exchange-ps/exchange/Get-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)
exchange/exchange-ps/exchange/Remove-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)
exchange/exchange-ps/exchange/Set-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)

For more details, please refer to the build report.

For any questions, please:

@samantharamon samantharamon marked this pull request as ready for review February 28, 2025 19:08
@samantharamon
Copy link
Contributor Author

@chrisda This PR is ready to be merged whenever you get a chance. Thanks!

Copy link

Learn Build status updates of commit b90b3d1:

✅ Validation status: passed

File Status Preview URL Details
exchange/exchange-ps/exchange/Get-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)
exchange/exchange-ps/exchange/Remove-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)
exchange/exchange-ps/exchange/Set-AuthenticationPolicy.md ✅Succeeded View (exchange-ps)

For more details, please refer to the build report.

For any questions, please:

@chrisda chrisda merged commit 2e63b94 into MicrosoftDocs:main Mar 3, 2025
6 checks passed
@samantharamon samantharamon deleted the samramon-update-description branch March 3, 2025 21:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants