Segurança e limites dos destinos
Como a Dcision protege as requisições de saída — só https, proteção contra SSRF, sem redirecionamentos, segredos — o que cada tipo envia e guarda, quem configura o quê, e todos os limites.
Requisições de saída
Webhooks, requisições de API, workflows e agentes chamam URLs que você configura, então a Dcision protege toda conexão:
- Só https. Uma URL começa com
https://, ou com um segredo que contém a URL inteira. URLshttp://são recusadas ao salvar. - Só endereços públicos. O nome do host é resolvido quando a Dcision conecta, e todo endereço é verificado nesse momento, dentro da própria conexão — um nome não consegue resolver para um endereço público na verificação e para um privado na requisição. Endereços IP literais também são verificados.
- Sem credenciais nas URLs.
https://user:password@…é recusado: coloque as credenciais num header, com um segredo. - Sem redirecionamentos. Uma resposta
3xxé uma entrega com falha; a Dcision nunca a segue. - Curtas e limitadas. 10 segundos por tentativa de entrega (até 25 segundos para chamadas de LLM e de agentes
sync), respostas lidas até 64 KB.
Endereços bloqueados:
| Faixa | O que é |
|---|---|
0.0.0.0/8 | Rede "esta" |
10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16 | Redes privadas |
100.64.0.0/10 | NAT de operadora (CGNAT) |
127.0.0.0/8 | Loopback |
169.254.0.0/16 | Link-local, incluindo serviços de metadados de nuvem |
192.0.0.0/24, 192.0.2.0/24, 192.88.99.0/24, 198.18.0.0/15, 198.51.100.0/24, 203.0.113.0/24 | Faixas reservadas, de teste e de benchmarking |
224.0.0.0/4, 240.0.0.0/4 | Multicast, reservadas e broadcast |
::, ::1, fc00::/7, fe80::/10, fec0::/10, ff00::/8, 2001:db8::/32, 100::/64 | IPv6 não especificado, loopback, unique local, link-local, site-local, multicast, documentação e descarte |
Endereços IPv4-mapped, IPv4-compatible, NAT64 (64:ff9b::/96) e 6to4 (2002::/16) | Bloqueados quando o endereço IPv4 contido neles é bloqueado |
Nomes de host que terminam em .local, .internal ou .localdomain — e nomes que resolvem para qualquer endereço bloqueado, como nomes de serviços internos — também são recusados.
Segredos
- Os segredos do workspace são criptografados com AES-256-GCM e nunca aparecem no decision schema, nas respostas, nos logs de execução nem no Playground — as prévias os mascaram como
••••. - Os valores dos seus headers nunca são gravados nos logs da Dcision; mesmo assim, guarde tokens em segredos, porque o app mostra uma prévia mascarada da requisição de cada entrega, headers incluídos.
- O segredo de assinatura também é criptografado, e só Admins e o Proprietário podem revelá-lo ou trocá-lo.
O que sai da Dcision
| Tipo | O que o receptor recebe |
|---|---|
reply | Nada sai: o texto é devolvido a quem chamou. |
function | Nada sai: o nome da função e os params são devolvidos a quem chamou. |
llm | O provedor do modelo — sob a sua chave e conta — recebe o prompt da rota e a entrada: o estado inteiro, a menos que você defina input. |
agent | O seu agente recebe o estado inteiro como input, as instruções, ferramentas, params e as respostas da decisão. |
webhook | As respostas, a confiança, os níveis ponderados, os composites, a ação, o motivo e os params — nunca o estado. |
workflow | Os params e as respostas da decisão — nunca o estado. |
http | Exatamente o que a sua URL, os headers e o template do body contêm. |
Mapeie só o que um receptor precisa: os params são a ferramenta de minimização de dados dos destinos.
O que a Dcision guarda
- A execução guarda as entradas
destinationsda execução — incluindo params de funções, respostas fixas, textos de LLM e respostas de agentes — independentemente das configuraçõesstoreInputestoreOutputda decisão. Elas seguem a retenção de logs da execução e aparecem emGET /v1/executions. Se os params trazem dados pessoais, as entradas também trazem. - As entregas guardam o status, as tentativas, o código de status da resposta, a latência e os primeiros 1.024 caracteres, uma prévia mascarada da requisição — método, URL, headers e o tamanho do body, nunca o body — e, criptografada, a requisição completa enquanto ela pode ser reenviada. Elas são excluídas 30 dias depois de criadas.
Veja Segurança e dados para o restante do que a Dcision guarda.
Quem configura o quê
| Ação | Leitor | Membro | Admin | Proprietário |
|---|---|---|---|---|
| Ver destinos, entregas e o status delas | ✓ | ✓ | ✓ | ✓ |
| Adicionar, editar e publicar destinos | — | ✓ | ✓ | ✓ |
| Executar destinos de verdade no Playground | — | ✓ | ✓ | ✓ |
| Reenviar uma entrega com falha | — | ✓ | ✓ | ✓ |
| Ver os nomes dos segredos | — | ✓ | ✓ | ✓ |
| Gerenciar segredos e o segredo de assinatura | — | — | ✓ | ✓ |
| Salvar chaves de provedores de LLM (Configurações → Engine) | — | — | ✓ | ✓ |
Limites
| Limite | Valor |
|---|---|
| Destinos por decisão | 20 |
| Destinos que disparam por execução | 10 |
Respostas de LLM e agentes sync por execução | 3 |
| Condições por destino | 5 |
| Params por destino | 30 |
| Valor fixo de param | até 500 caracteres |
| Headers por destino | 20 |
| Valor de header | até 2.048 caracteres |
| URL | até 2.048 caracteres |
Template do body http | até 10.000 caracteres |
| Descrição do destino | até 2.000 caracteres |
| Texto da resposta fixa | até 4.000 caracteres |
| Botões da resposta fixa | até 10, até 80 caracteres cada |
Prompt e entrada do LLM, instructions e input da saída estruturada | até 8.000 caracteres cada |
| Instruções do agente | até 32.000 caracteres |
| Ferramentas do agente | até 50 |
Timeout do LLM e de agentes sync | 1.000 a 25.000 ms, padrão 20.000 |
maxTokens do LLM | 16 a 2.048, padrão 512 |
temperature do LLM | 0 a 2, padrão 0.3 |
Resposta do agente devolvida em response | até 16.000 caracteres |
| Tentativas de entrega | 6, ao longo de cerca de 7 horas |
| Timeout por tentativa de entrega | 10 segundos |
| Entregas por workspace | 600 por minuto |
| Retenção das entregas | 30 dias |
| Segredos do workspace | 50, valores de até 4.096 caracteres |
Testando destinos
Veja prévias dos destinos no Playground com os segredos mascarados, execute-os de verdade com livemode false, use API keys de teste e acompanhe entregas, tentativas e respostas dos receptores.
Visão geral da API
URL base, versionamento, convenções de requisição e resposta, headers e IDs da API pública da Dcision.