xhyumiracle/sudpProtocolo de Delegação de Uso de Segredos — uso de segredos em nível de protocolo para sistemas agênticos
Uso de segredos ao nível do protocolo para sistemas agênticos.
)
Implementação de referência de arXiv:2604.24920 — consulte Cite this paper.
O sudp permite que um Requester (R) autónomo proponha uma operação suportada por um segredo, que um Authorizer (A) autorize exatamente essa operação e que um Custodian (T) a execute. A unidade de delegação é um uso, não o segredo.
┌─────────────────────────┐
│ Authorizer A │
│ (passkey on a device) │
└────────────┬────────────┘
│ signs β over (DS ‖ r ‖ H(o))
▼
┌──────────────┐ ┌───────────────┐ ┌──────────────┐
│ Requester R │ ─o─▶ │ Custodian T │ ─s─▶ │ Environment │
│ (agent) │ │ │ │ E │
│ │◀ρ────│ holds sealed Σ│ │ │
└──────────────┘ └───────────────┘ └──────────────┘
R nunca vê s e não obtém nenhuma autoridade reutilizável sobre ele — mesmo que R esteja
totalmente comprometido (injeção de prompt, shim de runtime, etc.).
@misc{yu2026sudp,
title = {SUDP: Secret-Use Delegation Protocol for Agentic Systems},
author = {Xiaohang Yu and Hejia Geng and Xinmeng Zeng and William Knottenbelt},
year = {2026},
eprint = {2604.24920},
archivePrefix = {arXiv},
primaryClass = {cs.CR},
url = {https://arxiv.org/abs/2604.24920}
}
Xiaohang Yu, Hejia Geng, Xinmeng Zeng e William Knottenbelt. "SUDP: Secret-Use Delegation Protocol for Agentic Systems." arXiv preprint arXiv:2604.24920 (2026).
| Função | Origem | Publicado como |
|---|---|---|
| Custodian (T) | custodian/rust | sudp no crates.io |
| Authorizer (A) | authorizer/ts | @sudp-protocol/authorizer no npm |
| Requester (R) | requester/ts | @sudp-protocol/requester no npm |
Pré-requisitos: Rust 1.85+ (via rustup) e Node.js 20+.
git clone https://github.com/xhyumiracle/sudp
cd sudp/examples/protocol-demo
./run.sh
Cria os três pacotes, inicia o Custodian, executa R + A num script
Node, imprime cada interação de rede com cores por função e termina
com uma verificação adversarial (R adultera o depois de A assinar → T rejeita).
Para uso ao nível da API: custodian/rust ·
authorizer/ts · requester/ts.
Os autores de agentes normalmente precisam apenas de
@sudp-protocol/requester — construtores tipados de Operation
e validadores de forma, sem transporte, sem adaptadores de framework. O Requester
é a camada mais substituível; cada framework de agente liga a sua própria cola.
Os vetores de conformidade fixam os bytes do Authorizer contra o Custodian ao nível do byte — as formas compostas mantêm-se alinhadas por construção.
| Superfície | Âncora Rust | Âncora TS |
|---|---|---|
canonical(o) | testes unitários de Operation::canonical_bytes | conformance.test.ts: canonical: nested ordering |
β + DS_BIND | beta_matches_ts_authorizer_conformance_vector | conformance.test.ts: β: matches Rust... |
batch β (H(canonical(ops))) | batch_beta_matches_ts_authorizer_conformance_vector | conformance.test.ts: batch β: matches Rust... |
derive_wrapping_key | derive_wrapping_key_matches_ts_authorizer_conformance_vector | conformance.test.ts: deriveWrappingKey: matches Rust... |
| cifra AEAD (nonce fixo) | aead_matches_ts_authorizer_conformance_vector | conformance.test.ts: aeadEncrypt: matches Rust... |
layout de wrap_ad | testes de WrapBinding::to_canonical_ad | conformance.test.ts: wrap_ad: DS_WRAP ‖ cid ‖ ver_be |
layout de seal_ad | phases::setup::seal_ad (testes de setup) | conformance.test.ts: seal_ad: DS_SEAL ‖ ver_be |
selagem por registo (record_aad / K_aead / enquadramento selado) | state::record::tests::conformance_* | conformance.test.ts: per-record conformance vectors |
WRAP_VERSION ↔ CURRENT_VERSION | state::CURRENT_VERSION = 1 | conformance.test.ts: WRAP_VERSION matches Rust... |
O CI executa ambas as metades em cada push:
cd custodian/rust && cargo test
cd authorizer/ts && npm test
cd requester/ts && npm test
O formato de transmissão e as formas dos traits ainda podem mudar antes da 1.0. Fixe as versões menores em produção:
# Cargo.toml
sudp = "~0.1"
// package.json
"@sudp-protocol/authorizer": "~0.1.0",
"@sudp-protocol/requester": "~0.1.0"
Consulte SECURITY.md.
Apache-2.0. Consulte LICENSE.