Skip to content

Commit 4b4bba3

Browse files
authored
Updates for new August timeline (#5275)
1 parent 6c9dfab commit 4b4bba3

File tree

2 files changed

+17
-16
lines changed

2 files changed

+17
-16
lines changed

docs/outlook/faq-nested-app-auth-outlook-legacy-tokens.md

Lines changed: 14 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -4,12 +4,12 @@ description: Nested app authentication and Outlook legacy tokens deprecation FAQ
44
ms.service: microsoft-365
55
ms.subservice: add-ins
66
ms.topic: faq
7-
ms.date: 06/18/2025
7+
ms.date: 07/11/2025
88
---
99

1010
# Nested app authentication and Outlook legacy tokens deprecation FAQ
1111

12-
Exchange [user identity tokens](authentication.md#exchange-user-identity-token) and [callback tokens](authentication.md#callback-tokens) are deprecated and will be completely turned off by June 2025. We recommend moving Outlook add-ins that use legacy Exchange tokens to nested app authentication.
12+
Exchange [user identity tokens](authentication.md#exchange-user-identity-token) and [callback tokens](authentication.md#callback-tokens) are deprecated and will be completely turned off by August 2025. We recommend moving Outlook add-ins that use legacy Exchange tokens to nested app authentication.
1313

1414
## General FAQ
1515

@@ -24,26 +24,27 @@ Legacy Exchange online tokens have already been turned off for most tenants. We'
2424
| Date | Legacy tokens status |
2525
| -------- | ------------------------------------------------------ |
2626
| Now | Legacy tokens turned off for most tenants. Admins can reenable legacy tokens via PowerShell. |
27-
| June 16 2025 - July 2025 | Legacy tokens are turned off for all tenants. This process will take several weeks to complete. Admins can no longer reenable legacy tokens via PowerShell. Admins can request an exception through Microsoft Support at [https://aka.ms/LegacyTokensByOctober](https://aka.ms/LegacyTokensByOctober) (this link requires you to sign in to your tenant). |
28-
| Oct 2025 | Legacy tokens turned off for all tenants. Exceptions are no longer allowed. |
27+
| August 1 2025 - September 2025 | Legacy tokens are turned off for all tenants. This process will take several weeks to complete. Admins can no longer reenable legacy tokens via PowerShell. Admins can request an exception through Microsoft Support at [https://aka.ms/LegacyTokensByOctober](https://aka.ms/LegacyTokensByOctober) (this link requires you to sign in to your tenant). |
28+
| October 2025 | Legacy tokens turned off for all tenants. Exceptions are no longer allowed. |
2929

3030
### When is NAA generally available for my channel?
3131

3232
The general availability (GA) date for NAA depends on which channel you are using.
3333

3434
| Date | NAA General Availability (GA) |
3535
| -------- | ------------------------------------------------------ |
36-
| Oct 2024 | NAA is GA in Current Channel. |
37-
| Nov 2024 | NAA is GA in Monthly Enterprise Channel. |
38-
| Jan 2025 | NAA is GA in Semi-Annual Channel build 16.0.17928.20392. |
39-
| Jun 2025 | NAA will GA in Semi-Annual Extended Channel. |
36+
| October 2024 | NAA is GA in Current Channel. |
37+
| November 2024 | NAA is GA in Monthly Enterprise Channel. |
38+
| January 2025 | NAA is GA in Semi-Annual Channel Version 2408 (Build 17928.20392). |
39+
| June 2025 | NAA is GA in Semi-Annual Extended Channel Version 2408 (Build 17928.20604). |
4040

4141
### How do I handle legacy tokens turned off in Semi-Annual Extended Channel, which doesn't support NAA yet?
4242

43-
Semi-Annual Extended Channel won't support NAA until June 2025. This means even if add-ins are updated to support NAA, and no longer use legacy Exchange Online tokens, they won't function on this channel. If you are using Semi-Annual Extended Channel as an administrator, we recommend the following.
43+
Semi-Annual Extended Channel version 2402 doesn't support NAA. To avoid any service interruption to Outlook add-ins on your tenant, we recommend you upgrade to Semi-Annual Extended Channel version 2408. This version is available as of July 8, 2025.
4444

45-
- Check if your tenant is using any add-ins that require legacy Exchange Online tokens. For more information, see [Find Outlook add-ins that use legacy Exchange Online tokens](https://github.com/OfficeDev/office-js/tree/release/add-in-ids).
46-
- If you have deployed add-ins that require legacy Exchange Online tokens, and the add-ins are necessary for your organization, we recommend you turn on tokens now so that they continue to function. To turn tokens on, see [Turn legacy Exchange Online tokens on or off](turn-exchange-tokens-on-off.md).
45+
From **now through August 1 2025** we recommend administrators on Semi-Annual Extended Channel **upgrade to version 2408**. Administrators can [request an exception](https://aka.ms/LegacyTokensByOctober) through Microsoft Support if they need more time.
46+
47+
We also recommend to check if your tenant is using any add-ins that require legacy Exchange Online tokens. For more information, see [Find Outlook add-ins that use legacy Exchange Online tokens](https://github.com/OfficeDev/office-js/tree/release/add-in-ids).
4748

4849
### Are COM Add-ins affected by the deprecation of legacy Exchange Online tokens?
4950

@@ -107,7 +108,7 @@ If you rely on an ISV for your add-in, we recommend you contact them as soon as
107108

108109
### What do I do for add-ins I can't identify?
109110

110-
It's possible after running `Get-AuthenticationPolicy` there could be some custom add-ins that you can't identify the owner. For those add-ins you may need to perform a scream test. We recommend that administrators perform a scream test before June 2025 to determine if there are any remaining add-ins that will break when legacy tokens are turned off in June. This will give you time to reach out to publishers of any affected add-ins to address breaking issues before the June deadline.
111+
It's possible after running `Get-AuthenticationPolicy` there could be some custom add-ins that you can't identify the owner. For those add-ins you may need to perform a scream test. We recommend that administrators perform a scream test before August 2025 to determine if there are any remaining add-ins that will break when legacy tokens are turned off in August. This will give you time to reach out to publishers of any affected add-ins to address breaking issues before the August deadline.
111112

112113
> [!NOTE]
113114
> You only need to perform the scream test if you turned legacy Exchange Online tokens on by using the `Set-AuthenticationPolicy` command. If you haven't run this command, then Exchange Online tokens should already be off by default.
@@ -138,7 +139,7 @@ Use the following steps to perform the test.
138139

139140
Yes, there are PowerShell commands you can use to turn legacy tokens on or off in any tenant. For more information on how to turn legacy tokens on or off, see [Turn legacy Exchange Online tokens on or off](turn-exchange-tokens-on-off.md).
140141

141-
In June 2025, legacy tokens will be turned off and you won't be able to turn them back on. Admins can request an exception through Microsoft Support at [https://aka.ms/LegacyTokensByOctober](https://aka.ms/LegacyTokensByOctober) (this link requires you to sign in to your tenant). In October 2025, it won't be possible to turn on legacy tokens and they'll be disabled for all tenants.
142+
In August 2025, legacy tokens will be turned off and you won't be able to turn them back on. Admins can request an exception through Microsoft Support at [https://aka.ms/LegacyTokensByOctober](https://aka.ms/LegacyTokensByOctober) (this link requires you to sign in to your tenant). In October 2025, it won't be possible to turn on legacy tokens and they'll be disabled for all tenants.
142143

143144
### How does the admin consent flow work?
144145

docs/outlook/turn-exchange-tokens-on-off.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Turn legacy Exchange Online tokens on or off
44
ms.service: microsoft-365
55
ms.subservice: add-ins
66
ms.topic: how-to
7-
ms.date: 05/22/2025
7+
ms.date: 07/11/2025
88
---
99

1010
# Turn legacy Exchange Online tokens on or off
@@ -45,7 +45,7 @@ Important notes about this command.
4545

4646
- Legacy Exchange tokens issued to Outlook add-ins before token blocking was implemented in your organization will remain valid until they expire.
4747
- If you turn on legacy Exchange Online tokens, then they won't be turned off in February 2025 when Microsoft turns them off for all tenants. For more information, see [Nested app authentication and Outlook legacy tokens deprecation FAQ](faq-nested-app-auth-outlook-legacy-tokens.md).
48-
- You’ll only be able to turn tokens back on until June 2025 when all legacy tokens in all tenants will be forced off. For more information, see the [Nested app authentication and Outlook legacy tokens deprecation FAQ](https://aka.ms/NAAFAQ).
48+
- You’ll only be able to turn tokens back on until August 2025 when all legacy tokens in all tenants will be forced off. For more information, see the [Nested app authentication and Outlook legacy tokens deprecation FAQ](https://aka.ms/NAAFAQ).
4949
- Although the `-Identity` parameter is required, it doesn't affect any specific authentication policy. The command always applies to the entire organization regardless of what value you use. We show the value as `LegacyExchangeTokens` in the examples to keep the intent clear.
5050

5151
## Get the status of legacy Exchange Online tokens and add-ins that use them
@@ -90,7 +90,7 @@ If you have IDs listed in **Allowed** or **Blocked** that are requesting legacy
9090
9191
The `Get-AuthenticationPolicy` command only shows the legacy token status as set by the administrator. If the administrator has never changed the settings, the command returns `(Not Set)`. If the token status is `(Not Set)` when the February deployment by Microsoft to turn off legacy tokens is implemented, the token status will still be `(Not Set)` even though legacy tokens are off. The following table shows the behavior of legacy Exchange Online tokens based on the token status when the change is applied.
9292

93-
| Legacy token admin setting | Legacy token behavior before February change | Legacy token behavior after February change | Legacy token behavior after June change |
93+
| Legacy token admin setting | Legacy token behavior before February change | Legacy token behavior after February change | Legacy token behavior after August change |
9494
|----------|------------|-------------|------------|
9595
|(Not Set) | Tokens on | Tokens off | Tokens off |
9696
|False | Tokens off | Tokens off | Tokens off |

0 commit comments

Comments
 (0)