Skip to content

Commit 777a06a

Browse files
authored
[All hosts] (NAA) document NestedAppAuth req set (#2095)
* add nestedappauth req set * update table * add builds * edits * edits * fix typo * edits * add nestedappauth req set info to articles * add nestedappauth client info * fix description * replace text with link to same
1 parent d4d3a37 commit 777a06a

File tree

4 files changed

+63
-7
lines changed

4 files changed

+63
-7
lines changed
Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
---
2+
title: Nested app auth requirement sets
3+
description: Nested app auth requirement set information for Office Add-ins.
4+
ms.date: 10/15/2024
5+
ms.topic: overview
6+
ms.localizationpriority: medium
7+
---
8+
9+
# Nested app auth requirement set
10+
11+
Requirement sets are named groups of API members. Office Add-ins use requirement sets specified in the manifest or use a runtime check to determine whether an Office application supports APIs that an add-in needs. For more information, see [Office versions and requirement sets](/office/dev/add-ins/develop/office-versions-and-requirement-sets).
12+
13+
Office Add-ins run across multiple versions of Office. The following table lists the nested app auth requirement set, the supported Office client applications, and the **minimum** builds or versions for those applications where applicable.
14+
15+
| Requirement set | Office on the web | Office on Windows<ul><li>Microsoft 365 subscription</li><li>retail perpetual</li></ul> | Office on Windows<ul><li>volume-licensed perpetual</li></ul> | Office on Mac | Office on iPad and Outlook on Android |
16+
|:-----|:-----|:-----|:-----|:-----|:-----|
17+
| NestedAppAuth 1.1 | Supported | Version 2409 (Build 18025.20000) | not available | Version 16.89 (Build 24090815) | Build v4.2433.0 |
18+
19+
> [!IMPORTANT]
20+
>
21+
> - Currently, the NestedAppAuth 1.1 requirement set is supported in Office on the web only for documents that are opened from Microsoft SharePoint Online and OneDrive.
22+
> - In Outlook, the NestedAppAuth 1.1 requirement set isn't supported if the add-in is loaded in an Outlook.com or Gmail mailbox.
23+
24+
## Outlook and NestedAppAuth requirement set
25+
26+
To require the NestedAppAuth requirement set 1.1 in your Outlook add-in code, check if it's supported by calling `isSetSupported('NestedAppAuth', '1.1')`.
27+
Declaring it in the Outlook add-in's manifest isn't supported. You can also determine if the API is supported by checking that it's not `undefined`.
28+
For further details, see [Using APIs from later requirement sets](/javascript/api/requirement-sets/outlook/outlook-api-requirement-sets#using-apis-from-later-requirement-sets).
29+
30+
## Office versions and build numbers
31+
32+
To find out more about versions and build numbers, see:
33+
34+
[!INCLUDE [Links to get Office versions and how to find Office client version](../../includes/links-get-office-versions-builds.md)]
35+
36+
## Office Common API requirement sets
37+
38+
For information about Common API requirement sets, see [Office Common API requirement sets](office-add-in-requirement-sets.md).
39+
40+
## See also
41+
42+
- [Office versions and requirement sets](/office/dev/add-ins/develop/office-versions-and-requirement-sets)
43+
- [Specify Office applications and API requirements](/office/dev/add-ins/develop/specify-office-hosts-and-api-requirements)
44+
- [Office Add-ins XML manifest](/office/dev/add-ins/develop/add-in-manifests)
45+
- [Enable SSO in an Office Add-in using nested app authentication](/office/dev/add-ins/develop/enable-nested-app-authentication-in-your-add-in)

docs/requirement-sets/common/office-add-in-requirement-sets.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -160,6 +160,14 @@ See [Add-in command requirement sets](add-in-commands-requirement-sets.md).
160160

161161
---
162162

163+
### NestedAppAuth
164+
165+
| Minimum Office application support | Methods in set |
166+
|:-----|:-----|
167+
| See [Nested app auth requirement sets](nested-app-auth-requirement-sets.md) | Supports nested app auth and the `Office.auth.getAuthContext` method. |
168+
169+
---
170+
163171
### OoxmlCoercion
164172

165173
| Minimum Office application support | Methods in set |

0 commit comments

Comments
 (0)