You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/outlook/faq-nested-app-auth-outlook-legacy-tokens.md
+14-13Lines changed: 14 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,12 +4,12 @@ description: Nested app authentication and Outlook legacy tokens deprecation FAQ
4
4
ms.service: microsoft-365
5
5
ms.subservice: add-ins
6
6
ms.topic: faq
7
-
ms.date: 06/18/2025
7
+
ms.date: 07/11/2025
8
8
---
9
9
10
10
# Nested app authentication and Outlook legacy tokens deprecation FAQ
11
11
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.
13
13
14
14
## General FAQ
15
15
@@ -24,26 +24,27 @@ Legacy Exchange online tokens have already been turned off for most tenants. We'
| 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. |
29
29
30
30
### When is NAA generally available for my channel?
31
31
32
32
The general availability (GA) date for NAA depends on which channel you are using.
|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). |
40
40
41
41
### How do I handle legacy tokens turned off in Semi-Annual Extended Channel, which doesn't support NAA yet?
42
42
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.
44
44
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).
47
48
48
49
### Are COM Add-ins affected by the deprecation of legacy Exchange Online tokens?
49
50
@@ -107,7 +108,7 @@ If you rely on an ISV for your add-in, we recommend you contact them as soon as
107
108
108
109
### What do I do for add-ins I can't identify?
109
110
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.
111
112
112
113
> [!NOTE]
113
114
> 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.
138
139
139
140
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).
140
141
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.
Copy file name to clipboardExpand all lines: docs/outlook/turn-exchange-tokens-on-off.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ description: Turn legacy Exchange Online tokens on or off
4
4
ms.service: microsoft-365
5
5
ms.subservice: add-ins
6
6
ms.topic: how-to
7
-
ms.date: 05/22/2025
7
+
ms.date: 07/11/2025
8
8
---
9
9
10
10
# Turn legacy Exchange Online tokens on or off
@@ -45,7 +45,7 @@ Important notes about this command.
45
45
46
46
- Legacy Exchange tokens issued to Outlook add-ins before token blocking was implemented in your organization will remain valid until they expire.
47
47
- 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).
49
49
- 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.
50
50
51
51
## 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
90
90
91
91
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.
92
92
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 |
0 commit comments