Claude Code Plugins

Community-maintained marketplace

Feedback

goldcard-iam-develop

@LLLLimbo/Skills
0
0

金卡身份中心开发者指引

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name goldcard-iam-develop
description 金卡身份中心开发者指引

GoldCard IAM Developer Skill

概览

本文档提供金卡身份中心开发者指引，帮助开发者了解如何开发、构建和运维金卡身份中心。 文档涉及的 Git 仓库、服务器地址、凭据等可能会过期, 如遇到问题, 请向用户请求相关信息。

何时使用

  • 当需要了解、开发、构建和运维金卡身份中心时
  • 当前工作和整体架构中提到的服务、组件存在关联时
  • 当前项目涉及身份认证、鉴权需求时

整体架构

身份中心目前由两个独立服务组成，另外还包括一些相关的 SDK

iam-management-service

该服务主要提供各类数据的CRUD接口, 接口分为以下几类:

  • 前台门户接口: 提供到前台门户的接口, 接口要求认证鉴权
  • 运营管理后台接口: 用于身分中心后台的接口, 接口要求认证和鉴权
  • 内部接口: 用于服务间调用的接口, 没有认证要求
  • 数据迁移/同步接口: 仅在数据迁移和同步过程中使用的接口, 用于和遗留系统 ETBC 之间的数据迁移和同步

详情参考参考:

  • Git 仓库: http://10.200.6.70/common_components/iam-management-service.git
  • 开发分支: CI_dev

iam-auth-center-service

该服务提供认证、鉴权端点, 以及会话管理的能力，单向依赖于 iam-maagement-service

详情参考参考:

  • Git 仓库: http://10.200.6.70/common_components/iam-auth-center-service.git
  • 开发分支: CI_dev

iam-clients

这里面包括了 iam-management-service 、iam-auth-center-service 两个服务的内部接口的 Java SDK, 以及提供给业务应用的用于获取当前用户信息的拦截器 Java SDK

详情参考:

  • Git 仓库: http://10.200.6.70/common_components/iam-clients.git
  • 开发分支: CI_dev

APISIX Plugins

用户的身份认证和鉴权还依赖于 APISIX 的自定义插件

简单来说, 对于部分受保护接口, 用户请求在到达它们的上游服务之前, 会通过网关先转发到 iam-auth-center-service 的认证和鉴权接口

这些插件源码和相关配置存放在 Git 仓库里, 详情参考:

  • Git 仓库: http://10.200.6.70/common_components/iam-deploy.git
  • 开发分支: CI_dev

iam-migration

一个用于从 ETBC 迁移系统菜单/权限/租户/组织和员工等身份信息到 身份中心的小型应用程序, 涉及复杂的数据映射和转换逻辑, 具体逻辑可以参考项目根目录下的 FIELD_MAPPING_CN.md

详情参考:

  • Git 仓库: http://10.200.6.70/common_components/iam-migration.git
  • 分支: master

其他相关组件

auth-common

  • 主要作用：该项目创建于身份中心之前, 提供通用认证/鉴权基础能力（操作鉴权 + 数据鉴权），统一注解与拦截器流程，封装会话/用户信息与数据过滤条件，支持多提供方（Eslink/IoT/Mix）的鉴权与用户信息获取。
  • 技术栈：Java 8，Spring Boot 2.1.7，Spring MVC/拦截器，SpEL，Spring Data Redis/多 Redis 配置，Maven，多模块工程，Lombok，SLF4J，Hutool，Commons Pool2
  • 相关的服务/组件：
    • 上游：接入该库的业务服务/控制器（通过 @OpAuth/@DataAuth/@RequestSessionInfo 等注解触发鉴权与会话注入）。
    • 下游：Eslink/IoT 相关的鉴权与用户信息服务（对应 auth-op-auth-provider-*、auth-user-info-provider-* 中的对外调用实现）。
    • 基础设施：Redis（多 Redis 配置与集成点）、HTTP 对外调用（用户/权限数据获取）

该项目之所以会和身份中心相关, 是因为身份中心计划替代旧的身份系统(ETBC 和 UTOS), 而 ETBC 以及 UTOS 原先通过 auth-common SDK 与其他业务应用产生耦合, 因此 auth-common 需要提供额外的兼容层.

  • Git 仓库地址: http://10.200.1.145/framework/server/auth-common.git
  • 分支说明:
    • pro: 生产分支, 暂时和身份中心无关
    • feature/iam-eslink-compatible: 额外提供了身份中心和 ETBC 的兼容层, 暂未合并到生产
    • feature/datapermission-field: 和身份中心无关

环境指引

仅限公司内网访问

开发环境

  • Kubernetes 1.20
  • Nodes: 10.200.6.200,10.200.6.207
  • Kubeconfig: 参考 kubeconfig-dev.yaml
  • Namespaces: iam
  • Loadbalancer(Caddy): 10.200.6.152

测试环境

  • Kubernetes 1.20
  • Nodes: 10.200.6.200,10.200.6.207
  • Kubeconfig: 参考 kubeconfig-dev.yaml
  • Namespaces: eslink-test
  • Loadbalancer(Caddy): 10.200.6.152