mcpField
A
auth-module-architecture

auth-module-architecture

github.com/tencentbluekingセキュリティ2.5k48 回インストール1 日前に更新
リポジトリ

auth-module-architecture について

Auth 権限プラットフォームを保守する開発者向けのスキルです。RBAC、グループ、IAM 連携、OAuth2 を整理し、課題別の設計資料と調査の指針を示します。

主な機能

  1. 01Auth の主要オブジェクトと構造の説明
  2. 02RBAC、グループ、認可フローの整理
  3. 03IAM 連携と OAuth2 の解説
  4. 04互換性、キャッシュ、履歴データの注意点

活用シーン

  1. 01権限チェックやリソース認可の変更
  2. 02グループ、リソース同期、権限問題の調査
  3. 03IAM 連携、コールバック、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

コメント