Skip to content

Commit 7f986cf

Browse files
[Outlook] (legacy tokens) information on how the report works (#5194)
* Info on how the report works * Update docs/outlook/turn-exchange-tokens-on-off.md --------- Co-authored-by: Linda Cannon <[email protected]>
1 parent a9759a4 commit 7f986cf

File tree

1 file changed

+20
-3
lines changed

1 file changed

+20
-3
lines changed

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

Lines changed: 20 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/19/2025
7+
ms.date: 05/22/2025
88
---
99

1010
# Turn legacy Exchange Online tokens on or off
@@ -64,9 +64,26 @@ Blocked: []
6464
PS C:\>
6565
```
6666

67-
The **Allowed** and **Blocked** sections list the IDs of any add-ins that made recent requests. If an add-in ID is listed in the **Allowed** list, it was granted an Exchange token. If an add-in ID is listed in the **Blocked** list, it was denied an access token because access tokens are turned off.
67+
The **Allowed** and **Blocked** sections list the IDs of any add-ins that made recent requests. If an add-in ID is listed in the **Allowed** list, it was granted an Exchange token. If an add-in ID is listed in the **Blocked** list, it was denied an access token because access tokens are turned off. The following example shows the Script Lab ID being granted a token on May 16, and also blocked from a token on February 25th. Tokens were turned off for the tenant in February, and turned on in May, so Script Lab appears in both sections.
6868

69-
If you have IDs listed in **Allowed** or **Blocked** do additional research to identify the publisher and reach out to them to ensure they are migrating their add-in away from legacy Exchange Online tokens. For more information on identifying publishers, see [Commands to identify the publisher in the FAQ](faq-nested-app-auth-outlook-legacy-tokens.md#what-commands-can-i-use-to-identify-the-publisher).
69+
```console
70+
PS C:\> Get-AuthenticationPolicy -AllowLegacyExchangeTokens
71+
AllowLegacyExchangeTokens: True
72+
Allowed:
73+
[
74+
{ "49d3b812-abda-45b9-b478-9bc464ce5b9c" : "2025-05-16" }
75+
]
76+
Blocked:
77+
[
78+
{ "49d3b812-abda-45b9-b478-9bc464ce5b9c" : "2025-02-25" }
79+
]
80+
```
81+
82+
The report only shows a single entry per add-in. If multiple calls from many users are made from a single add-in for Exchange tokens, those calls appear in the report as one request. The date updates every seven days. In the previous example, the report shows Script lab being granted tokens on May 16. The date won't change unless Script Lab continues to make token requests on May 23rd at which point the report will update the date.
83+
84+
To confirm an add-in is no longer requesting Exchange tokens, run the command after seven days and check that the date doesn't change.
85+
86+
If you have IDs listed in **Allowed** or **Blocked** that are requesting legacy tokens, identify the publisher and reach out to them to ensure they are migrating their add-in away from legacy tokens. For more information on identifying publishers, see [Commands to identify the publisher in the FAQ](faq-nested-app-auth-outlook-legacy-tokens.md#what-commands-can-i-use-to-identify-the-publisher).
7087

7188
> [!NOTE]
7289
> The `Get-AuthenticationPolicy -AllowLegacyExchangeTokens` command is the only way to view legacy token status. Other commands, such as `Get-AuthenticationPolicy | Format-Table -Auto Name`, don't return the legacy token status.

0 commit comments

Comments
 (0)