Component

core/ai-agent/dify-ssrf-proxy

The egress proxy a Dify installation routes user-directed outbound requests through. A Dify workflow fetches whatever address its author or its end user supplies — a web page to crawl, a file to load, an HTTP request node's target — and a service that made those calls itself would be reachable proof of every address the cluster can see. This component is the chokepoint that removes that: it is a Squid forward proxy configured to refuse any destination in private, loopback, link-local or multicast address space, so a supplied address can reach the public internet and cannot reach the cluster's own services or the node's metadata endpoint. Its allowlist of private destinations is empty by default and is widened only by naming addresses explicitly. Holds no state — its cache is in memory and discarded with the process — so it renders as a stateless server. Exports its host, port and protocol to consumers via the uses topology, which is how each caller learns the proxy address to send through.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:aea991ce87ad647db2f03ef6900566d99bd591c18a903d8c9f5a4bc515a42399
Published
2026-11-10T10:07:51Z
Signing identity
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signature

  • Officialapplication/vnd.dev.sigstore.bundle.v0.3+json

    https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

    sha256:41ce27fc1bd98aa86e3894ac9dd8ff6ac9ff537d6a9e66b00ef694b92a7cf24e

Reference at this version

oci://hub.aggrega.ai/component/core/ai-agent/dify-ssrf-proxy:1.0.0

Developer parameters

Values the developer sets in the Aggregate.

NameTypeDefaultRequiredDescription
allowed_private_networksarray—noPrivate-address ranges the proxy permits as destinations, each in CIDR notation, permitted ahead of the private-network refusal. Left unset, no private destination is reachable through the proxy. Naming a range here is how an installation lets a workflow reach a service inside its own cluster, and each entry widens what a supplied address can reach, so the list stays as short as the installation needs.
allowed_domainsarray—noDomains the proxy permits as destinations regardless of the address they resolve to, each written as the domain or a leading-dot suffix match. Left unset, only the plugin marketplace the platform installs from is named.
max_request_body_sizestring100 MBnoLargest request body the proxy will buffer, as a Squid size quantity.

Operator sizing

Infrastructure sizing the operator tunes per environment.

NameTypeDefaultRequiredDescription
portinteger (min 1024, max 65535)3128noForward-proxy listen port callers send through.
engine_versionstring6.6-24.04_edgenoSquid container image tag.
computeobject—no—
overridesobject (open)—noProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Output contract

Values this component publishes to consumers over the uses topology.

NameTypeDefaultRequiredDescription
hoststring—yesIn-cluster DNS name of the Service fronting the egress proxy. A caller sets it as its proxy address rather than as a request target, so its outbound calls leave through the proxy.
portinteger—yesTCP port the proxy accepts forwarded requests on. It follows the port an operator set in the Release, so a caller reads it rather than assuming a default.
protocolstring—noURL scheme to reach `host` and `port` over, which a caller composes its proxy address on.

Uses sockets

The dependency sockets this component connects through. The target of every connection wired through a socket must satisfy its label selector, and each connection may carry an attachment in the slots the socket declares. A required slot is owed by each connection the Aggregate or the Release wires through the socket.

No uses sockets declared.

Attachment slots

Named binding points at which a Feature attaches to this component. A slot's selector constrains which Feature may fill it and its inject list names how the Feature's material may be delivered. A required slot must be bound on every instance, by an attachment on the instance or at a scope above it, and a sensitive slot is declared to handle secret material. A Feature may also attach under a name no slot declares.

No attachment slots declared.

Self-inject allowlist

No self-inject pipes declared.

Relationships

Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.

Uses

This entity uses nothing in the catalog.

Used by

Component concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy