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.
Herkunft
- Inhalts-Digest
- sha256:aea991ce87ad647db2f03ef6900566d99bd591c18a903d8c9f5a4bc515a42399
- Veröffentlicht
- 2026-11-10T10:07:51Z
- Signaturidentität
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Signatur
- Offiziellapplication/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
Referenz zu dieser Version
oci://hub.aggrega.ai/component/core/ai-agent/dify-ssrf-proxy:1.0.0Entwicklerparameter
Werte, die der Entwickler im Aggregate festlegt.
| Name | Typ | Standardwert | Erforderlich | Beschreibung |
|---|---|---|---|---|
| allowed_private_networks | array | — | nein | Private-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_domains | array | — | nein | Domains 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_size | string | 100 MB | nein | Largest request body the proxy will buffer, as a Squid size quantity. |
Dimensionierung durch den Operator
Infrastrukturdimensionierung, die der Operator pro Umgebung anpasst.
| Name | Typ | Standardwert | Erforderlich | Beschreibung |
|---|---|---|---|---|
| port | integer (min 1024, max 65535) | 3128 | nein | Forward-proxy listen port callers send through. |
| engine_version | string | 6.6-24.04_edge | nein | Squid container image tag. |
| compute | object | — | nein | — |
| overrides | object (open) | — | nein | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
Ausgabevertrag
Werte, die diese Komponente über die uses-Topologie an Konsumenten veröffentlicht.
| Name | Typ | Standardwert | Erforderlich | Beschreibung |
|---|---|---|---|---|
| host | string | — | ja | In-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. |
| port | integer | — | ja | TCP 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. |
| protocol | string | — | nein | URL scheme to reach `host` and `port` over, which a caller composes its proxy address on. |
uses-Sockets
Die Abhängigkeits-Sockets, über die sich diese Komponente verbindet. Das Ziel jeder über einen Socket verdrahteten Verbindung muss dessen Label-Selektor erfüllen, und jede Verbindung kann in den Slots, die der Socket deklariert, eine Anbindung tragen. Einen erforderlichen Slot muss jede Verbindung füllen, die das Aggregate oder das Release über den Socket verdrahtet.
Keine uses-Sockets deklariert.
Anbindungs-Slots
Benannte Bindungspunkte, an denen ein Feature an diese Komponente angebunden wird. Der Selektor eines Slots schränkt ein, welches Feature ihn füllen darf, und seine inject-Liste benennt, wie das Feature sein Material liefern darf. Ein erforderlicher Slot muss auf jeder Instanz gebunden sein, durch eine Anbindung an der Instanz oder in einem darüberliegenden Geltungsbereich, und ein sensibler Slot ist für den Umgang mit geheimem Material deklariert. Ein Feature kann auch unter einem Namen angebunden werden, den kein Slot deklariert.
Keine Anbindungs-Slots deklariert.
Zulassungsliste für Selbstinjektion
Keine Selbstinjektions-Pipes deklariert.
Beziehungen
Typisierte Kanten zu und von anderen veröffentlichten Entitäten. Eine Referenz ohne veröffentlichtes Ziel wird als unterbrochene Kante statt als Link dargestellt.
Verwendet
Diese Entität verwendet nichts aus dem Katalog.
Verwendet von
verwendet Socket «runner»
verwendet Socket «api»
verwendet Socket «runner»
verwendet Socket «api»
verwendet Socket «services»
verwendet Socket «api»
verwendet Socket «services»
verwendet Socket «services»
verwendet Socket «sandbox»
verwendet Socket «plugin_daemon»
verwendet Socket «ssrf_proxy»
verwendet Socket «sandbox»
verwendet Socket «plugin_daemon»
verwendet Socket «ssrf_proxy»
verwendet Socket «api»
verwendet Socket «ssrf_proxy»
verwendet Socket «api»
verwendet Socket «api»
verwendet Socket «sandbox»
verwendet Socket «plugin_daemon»
verwendet Socket «ssrf_proxy»
verwendet Socket «sandbox»
verwendet Socket «plugin_daemon»
verwendet Socket «ssrf_proxy»
verwendet Socket «target_agent»
verwendet Socket «upstream»
verwendet Socket «forward_target»
verwendet Socket «scrape_target»
verwendet Socket «store»
gilt für
gilt für
gilt für
gilt für
gilt für
gilt für
gilt für
implementiert
implementiert