Skip to content

Commit 58a91de

Browse files
Copilotpelikhan
andcommitted
docs: consolidate engine subsections into a single minimal section
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
1 parent 4898779 commit 58a91de

1 file changed

Lines changed: 12 additions & 61 deletions

File tree

docs/src/content/docs/reference/network.md

Lines changed: 12 additions & 61 deletions
Original file line numberDiff line numberDiff line change
@@ -209,83 +209,34 @@ When enabled, AWF:
209209
- Logs all network activity for audit purposes
210210
- Blocks access to domains not explicitly allowed
211211

212-
### Claude Engine
212+
### Claude, Codex, and Gemini Engines
213213

214-
The Claude engine supports network permissions through AWF (Agent Workflow Firewall).
215-
216-
Enable network permissions in your workflow:
214+
The Claude, Codex, and Gemini engines use the same AWF firewall as the Copilot engine. Configure network permissions using the same `network.allowed` / `network.blocked` fields:
217215

218216
```yaml wrap
217+
# Claude
219218
engine: claude
220-
221219
network:
222220
allowed:
223-
- defaults # Basic infrastructure
224-
- python # Python ecosystem
225-
- "api.example.com" # Custom domain
226-
```
227-
228-
**Default domain list** – the following domains are always allowed for Claude CLI authentication and operation:
229-
230-
- `*.githubusercontent.com`
231-
- `anthropic.com`, `api.anthropic.com`, `statsig.anthropic.com`
232-
- `api.github.com`, `github.com`, `codeload.github.com`, `lfs.github.com`
233-
- `raw.githubusercontent.com`, `objects.githubusercontent.com`, `github-cloud.githubusercontent.com`, `github-cloud.s3.amazonaws.com`
234-
- `ghcr.io`
235-
- `cdn.playwright.dev`, `playwright.download.prss.microsoft.com`
236-
- `files.pythonhosted.org`, `pypi.org`
237-
- `registry.npmjs.org`
238-
- `packages.microsoft.com`, `packages.cloud.google.com`
239-
- `archive.ubuntu.com`, `azure.archive.ubuntu.com`, `security.ubuntu.com`, `keyserver.ubuntu.com`
240-
- `ppa.launchpad.net`, `api.snapcraft.io`, `packagecloud.io`
241-
- `json-schema.org`, `json.schemastore.org`
242-
- `sentry.io`
243-
- Various certificate authority domains (CRL/OCSP endpoints)
244-
245-
### Codex Engine
246-
247-
The Codex engine supports network permissions through AWF (Agent Workflow Firewall).
248-
249-
Enable network permissions in your workflow:
221+
- defaults
222+
- "api.example.com"
250223
251-
```yaml wrap
224+
# Codex
252225
engine: codex
253-
254226
network:
255227
allowed:
256-
- defaults # Basic infrastructure
257-
- node # Node.js ecosystem
258-
- "api.example.com" # Custom domain
259-
```
260-
261-
**Default domain list** – the following domains are always allowed for Codex CLI operation:
262-
263-
- `api.openai.com`, `openai.com` – OpenAI API endpoints
264-
- `host.docker.internal` – Docker host networking
265-
- `172.30.0.1` – AWF gateway IP (Codex resolves `host.docker.internal` to this IP for Rust DNS compatibility)
266-
267-
### Gemini Engine
268-
269-
The Gemini engine supports network permissions through AWF (Agent Workflow Firewall).
270-
271-
Enable network permissions in your workflow:
228+
- defaults
229+
- node
272230
273-
```yaml wrap
231+
# Gemini
274232
engine: gemini
275-
276233
network:
277234
allowed:
278-
- defaults # Basic infrastructure
279-
- node # Node.js ecosystem
280-
- "api.example.com" # Custom domain
235+
- defaults
236+
- node
281237
```
282238

283-
**Default domain list** – the following domains are always allowed for Gemini CLI authentication and operation:
284-
285-
- `*.googleapis.com`, `generativelanguage.googleapis.com` – Google API endpoints
286-
- `github.com`, `raw.githubusercontent.com` – GitHub access
287-
- `host.docker.internal` – Docker host networking
288-
- `registry.npmjs.org` – npm registry
239+
Each engine also has a built-in default domain list for its CLI authentication and operation. See [`domains.go`](https://github.com/github/gh-aw/blob/main/pkg/workflow/domains.go) for the full lists.
289240

290241
### Firewall Log Level
291242

0 commit comments

Comments
 (0)