Skip to content

Commit f790575

Browse files
authored
Adding information about IRM for network calls (#591)
1 parent 4835f76 commit f790575

File tree

1 file changed

+6
-2
lines changed

1 file changed

+6
-2
lines changed

docs/develop/external-calls.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: External API call support in Office Scripts
33
description: Support and guidance for making external API calls in an Office Script.
4-
ms.date: 06/10/2022
4+
ms.date: 03/15/2023
55
ms.localizationpriority: medium
66
---
77

@@ -10,7 +10,7 @@ ms.localizationpriority: medium
1010
Scripts support calls to external services. Use these services to supply data and other information to your workbook.
1111

1212
> [!CAUTION]
13-
> External calls may result in sensitive data being exposed to undesirable endpoints. Your admin can establish firewall protection against such calls.
13+
> External calls may result in sensitive data being exposed to undesirable endpoints. Your admin can establish Information Rights Management (IRM) or firewall protection against such calls.
1414
1515
> [!IMPORTANT]
1616
> Calls to external APIs can only be made through the Excel application, not through Power Automate [under normal circumstances](#external-calls-from-power-automate). External calls are also not supported for scripts stored on a SharePoint site.
@@ -73,6 +73,10 @@ interface JSONData {
7373
* The [Use external fetch calls in Office Scripts](../resources/samples/external-fetch-calls.md) sample shows how to get basic information about a user's GitHub repositories.
7474
* The [Office Scripts sample scenario: Graph water-level data from NOAA](../resources/scenarios/noaa-data-fetch.md) demonstrates the fetch command being used to retrieve records from the National Oceanic and Atmospheric Administration's Tides and Currents database.
7575

76+
## Restrict external calls with Information Rights Management (IRM)
77+
78+
You can [apply IRM settings](/microsoft-365/compliance/apply-irm-to-a-list-or-library) to a workbook to prevent external calls being made by scripts. Disable the [**Copy**/**EXTRACT** policy](/azure/information-protection/configure-usage-rights#usage-rights-and-descriptions) to prevent this behavior.
79+
7680
## External calls from Power Automate
7781
7882
Any external API call fails when a script is run with Power Automate. This is a behavioral difference between running a script through the Excel application and through Power Automate. Be sure to check your scripts for such references before building them into a flow.

0 commit comments

Comments
 (0)