ssrfguard

package
v0.7.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 9, 2026 License: AGPL-3.0 Imports: 6 Imported by: 0

Documentation

Overview

Package ssrfguard is an opt-in SSRF egress guard for flate's outbound source fetches. When flate renders UNTRUSTED input (e.g. konflate rendering a fork PR), a fork can place attacker-chosen URLs in the tree — kustomize remote resources/bases and GitRepository/OCIRepository/HelmRepository/Bucket spec.url — which flate would otherwise fetch server-side from inside the cluster, reaching cloud metadata (169.254.169.254), in-cluster services, and RFC1918/loopback hosts.

The guard installs a net.Dialer.Control hook on every fetch transport (via WrapTransport, wired into source.NewHTTPTransport, the helm getter, and the kustomize remote-fetch client). Control runs at dial time, AFTER DNS resolution, for every connection INCLUDING redirect targets, so one hook closes both DNS-rebinding and redirect SSRF without a CheckRedirect.

It is OFF by default and gated by a single process-global toggle (Restrict): flate normally renders TRUSTED repos that legitimately fetch from private/LAN hosts (self-hosted Gitea, in-cluster registries), so an always-on private block would break the common case. A consumer rendering untrusted input (konflate fork mode, or the `flate --restrict-egress` flag) turns it on. The policy is process-global: every transport reads the same toggle at dial time. go-git's installed HTTPS client retains the guard when it clones its concrete transport for per-operation TLS and proxy settings. Set the policy once at process init; last writer wins.

Boundaries (deliberately NOT covered):

  • A configured HTTP proxy is a trust boundary the operator owns: with Transport.Proxy set, the dial (and thus Control) sees the proxy IP, not the CONNECT target.
  • SSH git (ssh:// and scp-style) uses go-git's SSH transport, outside this HTTP dial guard.
  • This blocks reaching INTERNAL addresses; full egress-deny (incl. public hosts) is the consumer's NetworkPolicy job.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Restrict

func Restrict(on bool)

Restrict enables or disables the egress guard process-wide. The orchestrator sets it from Config.RestrictEgress; tests reset it. Safe for concurrent use, but it is a single process-level setting (last writer wins) — see the package doc on why per-render is not possible.

func WrapTransport

func WrapTransport(tr *http.Transport, dialer *net.Dialer)

WrapTransport attaches the egress control hook to the supplied source-owned dialer.

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL