Skip to content

Commit a8efca1

Browse files
sunbryeCopilotcrwaters16saritaigregose
authored
Fix: Networking does not work on local sandbox (#61838)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: Claire W <78226508+crwaters16@users.noreply.github.com> Co-authored-by: Sarita Iyer <66540150+saritai@users.noreply.github.com> Co-authored-by: Greg Ose <gregose@github.com>
1 parent 7606f04 commit a8efca1

4 files changed

Lines changed: 29 additions & 15 deletions

File tree

content/copilot/concepts/about-cloud-and-local-sandboxes.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ Once enabled, commands that {% data variables.product.prodname_copilot_short %}
4242

4343
### Cross-platform support
4444

45-
Local sandboxing is available across macOS, Linux, and Windows, delivering a consistent isolation experience regardless of your operating system.
45+
Local sandboxing is available on macOS and Linux. Sandboxing support and isolation behavior vary by platform because each operating system uses a different sandboxing backend. Windows is supported on Windows Insiders builds. For details on current limitations, see [AUTOTITLE](/copilot/how-tos/cloud-and-local-sandboxes/configuring-local-sandbox-settings).
4646

4747
### Enterprise policy enforcement
4848

@@ -111,5 +111,5 @@ For more information about how cloud sandbox usage is measured and billed, see [
111111
## Further reading
112112

113113
* [AUTOTITLE](/copilot/concepts/agents/copilot-cli/about-copilot-cli)
114-
* [AUTOTITLE](/copilot/how-tos/cloud-and-local-sandboxes/enabling-or-disabling-cloud-and-local-sandboxes-for-your-organization)
114+
* [AUTOTITLE](/copilot/how-tos/cloud-and-local-sandboxes/enabling-or-disabling-cloud-sandboxes-for-your-organization)
115115
* [AUTOTITLE](/copilot/how-tos/set-up/install-copilot-cli)

content/copilot/how-tos/cloud-and-local-sandboxes/configuring-local-sandbox-settings.md

Lines changed: 16 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,11 @@ docsTeamMetrics:
1212
- copilot-cli
1313
---
1414

15-
{% data reusables.cli.public-preview-sandbox %}
15+
{% data reusables.cli.public-preview-sandbox %}
16+
17+
> [!IMPORTANT]
18+
> Local sandboxing on Windows requires a Windows Insiders build.
19+
1620

1721
## About local sandbox configuration
1822

@@ -40,7 +44,7 @@ The **General** tab controls the top-level sandbox behavior.
4044

4145
## Configuring filesystem settings
4246

43-
The **Filesystem** tab controls which directories and files the sandboxed process can access. By default, the sandbox restricts filesystem access to prevent unintended reads or writes outside your project.
47+
The **Filesystem** tab controls which directories and files the sandboxed process can access. By default, the sandbox restricts writes outside your working directory.
4448

4549
| Setting | Description |
4650
| --- | --- |
@@ -68,7 +72,15 @@ The **Network** tab controls whether sandboxed processes can make network connec
6872

6973
### Adding network host rules
7074

71-
You can add specific host rules to allow or block access to individual hosts when outbound connections are otherwise restricted.
75+
> [!WARNING]
76+
> Per-host network filtering with `allowedHosts` and `blockedHosts` is currently not reliable across platforms. Do not rely on host rules to enforce network isolation.
77+
78+
The `/sandbox` UI allows you to add host rules, but these rules have known platform limitations:
79+
80+
* **macOS**: `allowedHosts` rules silently degrade to unrestricted outbound access, and `blockedHosts` rules are not supported.
81+
* **Linux**: Host rules are not a reliable way to allow selected hosts when outbound connections are disabled.
82+
83+
If the UI presents host rule options, you can add them using the steps below, but they are not suitable for security enforcement.
7284

7385
1. In the **Network** tab, press <kbd>A</kbd> to add a new host rule.
7486
1. Enter the hostname.
@@ -88,5 +100,5 @@ These commands change the **Sandboxing enabled** setting on the **General** tab.
88100
## Further reading
89101

90102
* [AUTOTITLE](/copilot/concepts/about-cloud-and-local-sandboxes)
91-
* [AUTOTITLE](/copilot/how-tos/cloud-and-local-sandboxes/enabling-or-disabling-cloud-and-local-sandboxes-for-your-organization)
103+
* [AUTOTITLE](/copilot/how-tos/cloud-and-local-sandboxes/enabling-or-disabling-cloud-sandboxes-for-your-organization)
92104
* [AUTOTITLE](/copilot/how-tos/copilot-cli/set-up-copilot-cli/configure-copilot-cli)

content/copilot/how-tos/cloud-and-local-sandboxes/enabling-or-disabling-cloud-and-local-sandboxes-for-your-organization.md renamed to content/copilot/how-tos/cloud-and-local-sandboxes/enabling-or-disabling-cloud-sandboxes-for-your-organization.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,11 @@
11
---
2-
title: Enabling or disabling {% data variables.copilot.sandbox %} for your organization
3-
shortTitle: Enable or disable sandboxes
2+
title: Enabling or disabling cloud sandboxes for your organization
3+
shortTitle: Enable or disable cloud sandboxes
44
allowTitleToDifferFromFilename: true
5-
intro: 'You can control whether members of your organization can use {% data variables.copilot.sandbox %} by managing the sandbox access policy in your organization settings.'
5+
intro: 'You can control whether members of your organization can use cloud sandboxes by managing the sandbox access policy in your organization settings.'
66
permissions: Organization owners
7+
redirect_from:
8+
- /copilot/how-tos/cloud-and-local-sandboxes/enabling-or-disabling-cloud-and-local-sandboxes-for-your-organization
79
versions:
810
feature: copilot
911
contentType: how-tos
@@ -13,15 +15,15 @@ category:
1315

1416
{% data reusables.cli.public-preview-sandbox %}
1517

16-
## About enabling and disabling {% data variables.copilot.sandbox %}
18+
## About enabling and disabling cloud sandboxes
1719

18-
Organization owners can control whether members of their organization have access to {% data variables.copilot.sandbox %} by configuring the sandbox access policy. By default, sandbox access is disabled for organization members.
20+
Organization owners can control whether members of their organization have access to cloud sandboxes by configuring the sandbox access policy. By default, sandbox access is disabled for organization members.
1921

20-
When sandbox access is **Disabled**, sandboxes are not available for any organization members. When sandbox access is **Enabled for all members**, all organization members can use {% data variables.copilot.sandbox_short %}.
22+
When cloud sandbox access is **Disabled**, cloud sandboxes are not available for any organization members. When cloud sandbox access is **Enabled for all members**, all organization members can use cloud sandboxes.
2123

22-
For more information about {% data variables.copilot.sandbox %}, see [AUTOTITLE](/copilot/concepts/about-cloud-and-local-sandboxes).
24+
For more information about cloud sandboxes, see [AUTOTITLE](/copilot/concepts/about-cloud-and-local-sandboxes).
2325

24-
## Enabling or disabling {% data variables.copilot.sandbox %}
26+
## Enabling or disabling cloud sandboxes
2527

2628
{% data reusables.profile.access_org %}
2729
{% data reusables.profile.org_settings %}

content/copilot/how-tos/cloud-and-local-sandboxes/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ intro: 'Manage {% data variables.copilot.sandbox %} for your organization.'
55
versions:
66
feature: copilot
77
children:
8-
- /enabling-or-disabling-cloud-and-local-sandboxes-for-your-organization
8+
- /enabling-or-disabling-cloud-sandboxes-for-your-organization
99
- /configuring-local-sandbox-settings
1010
contentType: how-tos
1111
---

0 commit comments

Comments
 (0)