Skip to content

Commit 51a689b

Browse files
nhu-dotimrogershubwriter
authored
CCA updated firewall UI updates (#56555)
Co-authored-by: Tim Rogers <[email protected]> Co-authored-by: hubwriter <[email protected]>
1 parent ba76300 commit 51a689b

File tree

1 file changed

+20
-9
lines changed

1 file changed

+20
-9
lines changed

content/copilot/how-tos/agents/copilot-coding-agent/customizing-or-disabling-the-firewall-for-copilot-coding-agent.md

Lines changed: 20 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,8 @@ redirect_from:
1515
> {% data reusables.copilot.coding-agent.preview-note-text %}
1616
>
1717
> For an introduction to {% data variables.copilot.copilot_coding_agent %}, see [AUTOTITLE](/copilot/concepts/about-copilot-coding-agent).
18+
>
19+
> Firewall configuration has moved to the {% data variables.copilot.copilot_coding_agent %} settings page. Previous configurations saved as Actions variables will be maintained on that page.
1820
1921
## Overview
2022

@@ -30,30 +32,39 @@ If {% data variables.product.prodname_copilot_short %} tries to make a request w
3032

3133
## Allowlisting additional hosts in the agent's firewall
3234

33-
You can allowlist additional addresses in the agent's firewall by setting the `COPILOT_AGENT_FIREWALL_ALLOW_LIST_ADDITIONS` {% data variables.product.prodname_actions %} variable to a comma-separated list. In that list, you can include:
35+
You can allowlist additional addresses in the agent's firewall.
36+
37+
{% data reusables.repositories.navigate-to-repo %}
38+
{% data reusables.repositories.sidebar-settings %}
39+
1. In the "Code & automation" section of the sidebar, click **{% data variables.product.prodname_copilot_short %}** then **{% data variables.copilot.copilot_coding_agent_short %}**.
40+
1. Click **Custom allowlist**
41+
1. Add the addresses you want to include in the allow list. You can include:
42+
43+
* **Domains** (for example, `packages.contoso.corp`). Traffic will be allowed to the specified domain and any subdomains.
3444

35-
* **Domains** (for example, `packages.contoso.corp`), in which case traffic will be allowed to that domain and any subdomains.
45+
**Example**: `packages.contoso.corp` will allow traffic to `packages.contoso.corp` and `prod.packages.contoso.corp`, but not `artifacts.contoso.corp`.
3646

37-
**Example**: `packages.contoso.corp` would allow traffic to `packages.contoso.corp` and `prod.packages.contoso.corp`, but not `artifacts.contoso.corp`.
47+
* **URLs** (for example, `https://packages.contoso.corp/project-1/`). Traffic will only be allowed on the specified scheme (`https`) and host (`packages.contoso.corp`), and limited to the specified path and descendant paths.
3848

39-
* **URLs** (for example, `https://packages.contoso.corp/project-1/`), in which case traffic will only be allowed on the specified scheme (`https`) and host (`packages.contoso.corp`), and limited to the specified path and descendant paths.
49+
**Example**: `https://packages.contoso.corp/project-1/` will allow traffic to `https://packages.contoso.corp/project-1/` and `https://packages.contoso.corp/project-1/tags/latest`, but not `https://packages.consoto.corp/project-2`, `ftp://packages.contoso.corp` or `https://artifacts.contoso.corp`.
4050

41-
**Example**: `https://packages.contoso.corp/project-1/` would allow traffic to `https://packages.contoso.corp/project-1/` and `https://packages.contoso.corp/project-1/tags/latest`, but not `https://packages.consoto.corp/project-2`, `ftp://packages.contoso.corp` or `https://artifacts.contoso.corp`.
51+
1. Click **Add Rule**.
52+
1. After validating your list, click **Save changes**.
4253

43-
## Overwriting the firewall allowlist
54+
## Overwriting the recommended firewall allowlist
4455

4556
By default, the firewall allows access to a number of hosts that are commonly used to download dependencies or that {% data variables.product.prodname_copilot_short %} uses to interact with {% data variables.product.github %}.
4657

47-
To completely clear this default allowlist and start again from scratch, set the `COPILOT_AGENT_FIREWALL_ALLOW_LIST` {% data variables.product.prodname_actions %} variable to a comma-separated list of hosts.
58+
To disable this, toggle the **Recommended allowlist** setting **off**.
4859

49-
For example, to _only_ allow access to `packages.contoso.corp` and `artifacts.contoso.corp`, set the `COPILOT_AGENT_FIREWALL_ALLOW_LIST` variable to `packages.contoso.corp,artifacts.contoso.corp`.
60+
To use the recommended allowlist in addition to your own allowlist, keep the **Recommended allowlist** setting **on**, and add your additional addresses in the **Custom allowlist** page.
5061

5162
### Disabling the firewall
5263

5364
> [!WARNING]
5465
> Disabling the firewall will allow {% data variables.product.prodname_copilot_short %} to connect to any host, increasing risks of exfiltration of code or other sensitive information.
5566
56-
The firewall is enabled by default. To disable the firewall, set the `COPILOT_AGENT_FIREWALL_ENABLED` {% data variables.product.prodname_actions %} variable to `false`.
67+
The firewall is enabled by default. To disable the firewall, toggle the **Enable firewall** setting to **off**.
5768

5869
## Further reading
5970

0 commit comments

Comments
 (0)