Esta página foi traduzida automaticamente. Ler o original em inglês.

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.

Proveniência

OficialAssinado por uma identidade de assinatura que este catálogo reconhece como editor oficial.
Digest do conteúdo
sha256:aea991ce87ad647db2f03ef6900566d99bd591c18a903d8c9f5a4bc515a42399
Publicado
2026-11-10T10:07:51Z
Identidade de assinatura
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Assinatura

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

Referência nesta versão

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

Parâmetros do programador

Valores que o programador define no Aggregate.

NomeTipoPredefiniçãoObrigatórioDescrição
allowed_private_networksarray—nãoPrivate-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—nãoDomains 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 MBnãoLargest request body the proxy will buffer, as a Squid size quantity.

Dimensionamento do operador

Dimensionamento da infraestrutura que o operador ajusta por ambiente.

NomeTipoPredefiniçãoObrigatórioDescrição
portinteger (min 1024, max 65535)3128nãoForward-proxy listen port callers send through.
engine_versionstring6.6-24.04_edgenãoSquid container image tag.
computeobject—não—
overridesobject (open)—nãoProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Contrato de saída

Valores que este componente publica para os consumidores através da topologia uses.

NomeTipoPredefiniçãoObrigatórioDescrição
hoststring—simIn-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—simTCP 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—nãoURL scheme to reach `host` and `port` over, which a caller composes its proxy address on.

Sockets uses

Os sockets de dependência através dos quais este componente se liga. O destino de cada ligação estabelecida através de um socket tem de satisfazer o respetivo seletor de etiquetas, e cada ligação pode transportar um acoplamento nos slots que o socket declara. Cada ligação que o Aggregate ou a Release estabelece através do socket tem de preencher os slots obrigatórios.

Nenhum socket uses declarado.

Slots de acoplamento

Pontos de vinculação com nome nos quais uma Feature se acopla a este componente. O seletor de um slot restringe qual a Feature que o pode preencher, e a respetiva lista inject indica como o material da Feature pode ser entregue. Um slot obrigatório tem de estar vinculado em cada instância, por um acoplamento na instância ou num âmbito acima dela, e um slot sensível é declarado para tratar material secreto. Uma Feature também se pode acoplar com um nome que nenhum slot declara.

Nenhum slot de acoplamento declarado.

Lista de autorizações de autoinjeção

Nenhum canal de autoinjeção declarado.

Relações

Arestas tipadas de e para outras entidades publicadas. Uma referência sem destino publicado é apresentada como uma aresta quebrada em vez de uma ligação.

Usa

Esta entidade não usa nada do catálogo.

Usado por

Referência do conceito Component →

O catálogo Aggrega — um índice aberto de componentes, funcionalidades, receitas e dos plugins que os renderizam.

Criado com o sistema de design partilhado do Aggrega.

Privacidade