Text of github.github.com › gh-aw › reference › network as Styx crawled it on Nov 19, 2026. The page may have changed since. Only its words are kept, without pictures or layout, and only the first part of a long page.

Open the live page

Network Permissions | GitHub Agentic Workflows

Skip to main content Network Permissions Control which domains and services AI engines can reach during workflow execution with the top-level network field. All built-in engines support it through the AWF firewall; see the AI Engines reference for the complete engine list. If no network: permission is specified, it defaults to network: defaults , which allows only certificate validation, JSON schema, and stock Ubuntu archive/keyserver hosts.

The complete baseline lists every allowed host. For custom CA trust when AWF’s API proxy verifies upstream TLS, see Custom CA certificate for the API proxy . Configuration Section titled “Configuration” Network permissions follow least privilege: Default ( network: defaults ) allows basic infrastructure only. Selective ( network: { allowed: [...] } ) allows only listed domains or ecosystems. No access ( network: {} ) blocks all network access.

Listed domains automatically match subdomains. Wildcards such as *.example.com are also supported; see Wildcard Domain Patterns . network : allowed : - defaults # Basic infrastructure - python # Python/PyPI ecosystem - node # Node.js/NPM ecosystem - " api.example.com " # Custom domain Blocking Domains Section titled “Blocking Domains” Use blocked to exclude specific domains or ecosystems from the allowed set. Blocked entries take precedence and include subdomains, which is useful for privacy, security, or compliance: network : allowed : - defaults - github - node blocked : - python # Block Python ecosystem - " cdn.example.com " # Block specific CDN Hosted web tools Section titled “Hosted web tools” Claude and Codex provider-hosted web search and fetch tools run on provider infrastructure, so network.allowed does not constrain their destinations.

Configure a separate hosted-web policy when they are needed: engine: claude network: allowed: - defaults hosted-web: allowed: - docs.github.com max-uses: 5 allowed and blocked are mutually exclusive, contain lowercase DNS hostnames only, and are never derived from network.allowed . The presence of hosted-web enables it and requires one non-empty list. Use hosted-web: false to reject hosted web tool calls. When network is configured for Claude or Codex without hosted-web , gh-aw emits enabled: false for that engine.

Protocol-Specific Domain Filtering Section titled “Protocol-Specific Domain Filtering” Restrict a domain to HTTP-only or HTTPS-only access, for legacy systems, strict HTTPS enforcement, or gradual migration. Supported by Copilot and Claude when the AWF firewall is enabled. Domains without a protocol prefix allow both. engine : copilot network : allowed : - " https://secure.api.example.com " # HTTPS-only access - " http://legacy.example.com " # HTTP-only access - " example.org " # Both protocols (default) - " https://*.api.example.com " # HTTPS wildcard Content Sanitization Section titled “Content Sanitization” network: also controls sanitized content: URLs from domains outside the allowlist are replaced with (redacted) to reduce exfiltration risk through untrusted links.

GitHub domains ( github.com , githubusercontent.com , etc.) are always allowed. Ecosystem Identifiers Section titled “Ecosystem Identifiers” Mix ecosystem identifiers with specific domains for fine-grained control: Identifier Includes defaults Certificate validation, JSON schema, and stock Ubuntu archive/keyserver hosts ( complete list ) github GitHub domains ( github.com , docs.github.com , github.blog , *.githubusercontent.com , and related) local Loopback addresses ( localhost , 127.0.0.1 , ::1 ) dev-tools Popular CI/CD and developer tool services (Codecov, Shields.io, Snyk, Renovate, CircleCI, etc.) default-safe-outputs Compound: defaults + dev-tools + github + local — recommended baseline for safe-outputs.allowed-domains containers Docker Hub, GitHub Container Registry, Quay, GCR, MCR linux-distros Linux distribution and third-party package sources, including Launchpad PPAs, packagecloud, Snap, Google, and Microsoft repositories — explicit opt-in playwright Playwright browser testing (see Playwright Reference ) chrome Headless Chrome/Puppeteer ( *.google.com , *.googleapis.com , *.gvt1.com ) fonts Google Fonts ( fonts.googleapis.com , fonts.gstatic.com ) terraform HashiCorp registry, apt/yum releases bazel Bazel build system ( releases.bazel.build , bcr.bazel.build ) clojure Clojure packages ( clojars.org ) copilot , claude , codex , gemini , pi , pi-base , threat-detection Engine gateway/GitHub transport sets, not added automatically ( details ) copilot-vendor , codex-vendor , gemini-vendor Direct provider API sets, explicit opt-in ( details ) dart Dart/Flutter packages ( pub.dev , storage.googleapis.com ) deno Deno runtime ( deno.land , jsr.io , googleapis.deno.dev ) dotnet NuGet packages and .NET SDK elixir Elixir packages ( hex.pm ) go Go modules and toolchain downloads ( proxy.golang.org , sum.golang.org , go.dev ) haskell Haskell packages ( hackage.haskell.org , GHCup) java Maven Central, Gradle, Adoptium julia Julia packages ( pkg.julialang.org , storage.julialang.net ) kotlin Kotlin/JetBrains packages ( download.jetbrains.com ) latex CTAN, TUG, MiKTeX packages — note : TeX Live’s tlmgr uses redirected CTAN mirrors not reachable through the firewall; prefer apt-get install texlive-full (covered by defaults ) or MiKTeX ( packages.miktex.org ) lean Lean packages ( lean-lang.org , reservoir.lean-lang.org ) lua Lua packages ( luarocks.org ) node npm, yarn, pnpm, Node.js, Bun node-cdns Node.js CDN assets (jsDelivr, jQuery CDN) ocaml OCaml packages ( opam.ocaml.org ) perl Perl/CPAN packages ( cpan.org , metacpan.org ) php PHP Composer packages ( packagist.org , getcomposer.org ) powershell PowerShell Gallery ( powershellgallery.com ) python PyPI, conda, pythonhosted.org python-native PyPI + crates.io — for Python packages with native extensions (pyo3/maturin) r R/CRAN packages ( cran.r-project.org ) ruby RubyGems, Bundler rust Rust crates ( crates.io , static.rust-lang.org , sh.rustup.rs ) scala Scala packages ( repo.scala-sbt.org , jitpack.io ) swift Swift packages ( swift.org , cocoapods.org ) zig Zig packages ( ziglang.org ) Defaults baseline Section titled “Defaults baseline” defaults contains exactly these entries.

Each also allows its subdomains: Purpose Hosts Certificate validation crl3.digicert.com , crl4.digicert.com , ocsp.digicert.com , ts-crl.ws.symantec.com , ts-ocsp.ws.symantec.com , crl.geotrust.com , ocsp.geotrust.com , crl.thawte.com , ocsp.thawte.com , crl.verisign.com , ocsp.verisign.com , crl.globalsign.com , ocsp.globalsign.com , crls.ssl.com , ocsp.ssl.com , crl.identrust.com , ocsp.identrust.com , crl.sectigo.com , ocsp.sectigo.com , crl.usertrust.com , ocsp.usertrust.com , s.symcb.com , s.symcd.com JSON schema json-schema.org , json.schemastore.org Stock Ubuntu archives and keyserver archive.ubuntu.com , security.ubuntu.com , keyserver.ubuntu.com , azure.archive.ubuntu.com Third-party package sources ( ppa.launchpad.net , packagecloud.io , api.snapcraft.io , packages.cloud.google.com , packages.microsoft.com ) require the explicit linux-distros opt-in ( allowed: [defaults, linux-distros] ) or individual entries. www.googleapis.com is not in defaults ; allow it explicitly or opt into an ecosystem that includes it, such as chrome .

Engine Domain Sets Section titled “Engine Domain Sets” Engine domain sets are named bundles for gateway/GitHub transport. They are not added automatically. Agent inference normally runs through the AWF API proxy, so direct provider API hosts are granted separately. Workflows that relied on an engine set for direct API egress must add the matching vendor set or literal domain to network.allowed . Engine set Included domains copilot api.github.com , github.com , host.docker.internal , raw.githubusercontent.com copilot-vendor Direct Copilot API hosts and optional telemetry, including api.githubcopilot.com claude api.github.com , github.com , host.docker.inte

The rest of this page is on the live site.