Files
beaver_project/authz-service/README.md
steven_li 9d6cde2d23 feat: 将项目从nano重命名为beaver并更新相关配置
- 将所有环境变量前缀从NANO_改为BEAVER_
- 更新README.md文档内容,包括项目介绍、组件说明和快速开始指南
- 修改.gitignore文件,添加auth-portal运行时路径排除规则
- 更新app-instance镜像标签从nano/app-instance改为beaver/app-instance
- 增强技能安全检查器,支持工具前缀白名单功能
- 添加技能草稿重新检查安全性API端点
- 扩展证据选择器,收集工具调用名称用于技能学习
- 改进技能合成器,基于实际调用的工具生成工具提示
- 优化路由超时处理机制,增加重试逻辑
- 更新后端架构文档,添加可视化入口和基础概念说明
- 实现在WebSocket消息中传递工具迭代次数信息
2026-05-20 18:01:06 +08:00

1.4 KiB
Raw Blame History

authz-service

authz-service 现在已经整理成独立 Docker 单元。

组成

  • Dockerfile
    • 生产镜像构建入口
  • docker-entrypoint.sh
    • 初始化数据目录并启动 uvicorn
  • start-authz.sh
    • 本地或服务器快速启动脚本
  • .env.example
    • 推荐的环境变量模板
  • runtime/seed-data/
    • 空白初始化数据
  • src/
    • 原始 FastAPI 应用代码

设计约定

  • 容器监听端口:19090
  • 容器内数据目录:/var/lib/authz-service/data
  • 首次启动时如果数据目录为空,会自动写入空白 JSON
  • signing_key.pem 不会被打进镜像
    • 如果挂载目录里不存在签名 key服务会在首次启动时自动生成

快速启动

cd /home/ivan/xuan/beaver_project/authz-service
cp .env.example .env
set -a
. ./.env
set +a
./start-authz.sh --build

启动后验证:

curl http://127.0.0.1:19090/healthz
curl http://127.0.0.1:19090/.well-known/jwks.json

生产建议

  • 用挂载卷保存 runtime/data
  • 显式设置 AUTHZ_INTERNAL_TOKEN
  • 显式设置外部可访问的 AUTHZ_ISSUER
    • 例如 https://authz.example.com
  • 如果要让 AuthZ 负责编排实例注册,还要设置 DEPLOY_API_BASE_URL
  • 如果 deploy-control 开了鉴权,还要设置 DEPLOY_API_TOKEN
  • 不要提交本地运行产生的 runtime/data/ 内容

API 说明

接口说明仍然看:

  • /home/ivan/xuan/beaver_project/authz-service/src/README.md