Cette page a été traduite automatiquement. Lire l’original en anglais.

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

OfficielSigné par une identité de signature que ce catalogue reconnaît comme éditeur officiel.
Empreinte du contenu
sha256:aea991ce87ad647db2f03ef6900566d99bd591c18a903d8c9f5a4bc515a42399
Publié
2026-11-10T10:07:51Z
Identité de signature
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signature

  • Officielapplication/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

Référence à cette version

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

Paramètres du développeur

Valeurs que le développeur définit dans l’Aggregate.

NomTypeValeur par défautObligatoireDescription
allowed_private_networksarray—nonPrivate-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—nonDomains 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 MBnonLargest request body the proxy will buffer, as a Squid size quantity.

Dimensionnement de l’opérateur

Dimensionnement de l’infrastructure que l’opérateur ajuste pour chaque environnement.

NomTypeValeur par défautObligatoireDescription
portinteger (min 1024, max 65535)3128nonForward-proxy listen port callers send through.
engine_versionstring6.6-24.04_edgenonSquid container image tag.
computeobject—non—
overridesobject (open)—nonProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Contrat de sortie

Valeurs que ce composant publie vers les consommateurs via la topologie uses.

NomTypeValeur par défautObligatoireDescription
hoststring—ouiIn-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—ouiTCP 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—nonURL scheme to reach `host` and `port` over, which a caller composes its proxy address on.

Sockets uses

Les sockets de dépendance par lesquels ce composant se connecte. La cible de chaque connexion câblée via un socket doit satisfaire son sélecteur d’étiquettes, et chaque connexion peut porter une attache dans les emplacements que le socket déclare. Un emplacement obligatoire doit être rempli par chaque connexion que l’Aggregate ou la Release câble via le socket.

Aucun socket uses déclaré.

Emplacements d’attache

Points de liaison nommés auxquels une Feature s’attache à ce composant. Le sélecteur d’un emplacement restreint la Feature qui peut le remplir, et sa liste inject indique comment le matériel de la Feature peut être livré. Un emplacement obligatoire doit être lié sur chaque instance, par une attache sur l’instance ou à une portée supérieure, et un emplacement sensible est déclaré pour traiter du matériel secret. Une Feature peut aussi s’attacher sous un nom qu’aucun emplacement ne déclare.

Aucun emplacement d’attache déclaré.

Liste d’autorisation d’auto-injection

Aucun canal d’auto-injection déclaré.

Relations

Arêtes typées vers et depuis d’autres entités publiées. Une référence sans cible publiée s’affiche comme une arête rompue plutôt que comme un lien.

Utilise

Cette entité n’utilise rien du catalogue.

Utilisé par

Référence du concept Component →

Le catalogue Aggrega — un index ouvert de composants, de fonctionnalités, de recettes et des plugins qui en assurent le rendu.

Conçu avec le système de design partagé d’Aggrega.

Confidentialité