mcpField
A
auth-module-architecture

auth-module-architecture

github.com/tencentblueking安全2.5k48 次安装2 天前更新
代码仓库

关于 auth-module-architecture

面向维护 Auth 权限平台的开发者，梳理 RBAC、用户组、IAM 集成和 OAuth2 的模块架构，并提供按问题类型查阅的参考文档。

主要功能

  1. 01说明 Auth 核心对象与模块结构
  2. 02梳理 RBAC、用户组和授权链路
  3. 03覆盖 IAM 集成与 OAuth2
  4. 04提示兼容性、缓存和历史数据风险

适用场景

  1. 01修改权限校验或资源授权逻辑
  2. 02排查用户组、资源同步与权限问题
  3. 03调整 IAM 集成、回调或 OAuth2 认证

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tencentblueking/bk-ci --skill auth-module-architecture

安装后在 Claude Code 中输入/auth-module-architecture确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

reference/
1-auth-foundation.md
2-rbac-group-authorization.md
3-iam-oauth-debug.md

详细介绍

来自项目 README

Auth 模块架构

适用场景

  • 修改 RBAC 权限校验和资源授权逻辑
  • 处理用户组、成员、资源与权限关系
  • 修改 IAM 集成、回调和同步逻辑
  • 处理权限迁移、分级管理员或 OAuth2 认证

不适用场景

  • 只是新增一种权限资源类型或动作模型
  • 只是给用户授权、加成员、查权限
  • 只是修改其他业务模块里的权限调用点
  • 只是处理普通登录页面或前端鉴权展示

快速指导

  1. 这个 skill 关注的是“权限平台本身如何实现和协作”，不是单次资源接入手册。
  2. Auth 既包含 RBAC 资源授权，也包含 IAM 对接、用户组、OAuth2 等平台能力。
  3. 先按问题类型进入对应参考文档：
    • 模块结构与核心对象：reference/1-auth-foundation.md
    • RBAC、用户组与授权链路：reference/2-rbac-group-authorization.md
    • IAM 集成、OAuth2 与排查：reference/3-iam-oauth-debug.md
  4. 如果你在设计新的资源类型、动作列表或初始化流程，切到 permission-model-change-guide。
  5. 如果你在处理业务模块里某个权限调用失败，先判断是 Auth 平台问题还是业务侧传参问题。

高信号规则

  • Auth 的核心是资源、动作、用户组、成员和授权关系
  • IAM 集成和本地 RBAC 数据是一条完整权限链，不应分开孤立看
  • 用户组配置、权限校验和资源同步往往会一起影响结果
  • 权限平台改动要优先考虑兼容性、缓存刷新和历史数据

关键陷阱

  • 把权限模型变更和 Auth 平台实现混为一谈
  • 只改校验逻辑，不看用户组、资源数据和同步链路
  • OAuth2、回调、权限校验共用上下文时，忽略边界差异
  • 权限问题排查只看接口返回，不看组、资源和动作三元关系

延伸阅读

  • 模块结构与核心对象：reference/1-auth-foundation.md
  • RBAC、用户组与授权链路：reference/2-rbac-group-authorization.md
  • IAM 集成、OAuth2 与排查：reference/3-iam-oauth-debug.md
  • 如果你在做权限模型接入：再看 permission-model-change-guide

评论

支持 Markdown