docs: add security surface and residual risk register (#499) - #510
Merged
Conversation
11 tasks
3 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
关联 Issue
Closes #499
背景
#499 系统安全审计的五个拆解子项(#500/#501/#502/#503/#504)已分别由 PR #505/#507/#509/#506/#508 修复并合并。本次为审计收口,按维护决策区分「一次性记录」与「可持久化文档」:
变更内容
新增
docs/security-architecture.md(持久化活文档,非某次审计的报告),集中承载安全面与残余风险,作为单一权威源;README / architecture / maintainer-architecture / guide / SECURITY 均交叉引用:a2a_call网络策略、CLI、上游 OpenCode 客户端)文档刻意不包含审计基线、修复 PR 对照表等过程性 issue 信息,避免退化为特定 issue 的报告。
残余风险(同步登记于
docs/security-architecture.md)a2a_callDNS-rebinding 校验为 resolve-then-connect,存在 TOCTOU;白名单 + 私网拒绝已降低暴露,pinned-IP 连接未实现A2A_ALLOWED_HOSTS时仅启动告警,依赖部署方 Host 校验A2A_LOG_PAYLOADS后日志可能含敏感数据:memory:/file:URI 与非 POSIX 平台验收对照
docs/security-architecture.mddocs/security-architecture.md验证
bash ./scripts/doctor.sh全绿:pre-commit、mypy、793 passed、覆盖率 93.31%、构建与 wheel smoke 通过(文档改动为主,回归全量验证)