SuperAPI AI 工具集

Identity-AIops

Identity-AIops 是面向自托管身份提供商 Keycloak 与 authentik 的「受治理 AI 运维」工具,让 AI 智能体和监督人员能够安全、可审计地操作身份平面:包括谁能登录、登录为何失败、哪些 OAuth 客户端配置错误、哪些用户尚未启用第二因素等。它提供 29 个 MCP 工具,含 21 个读取(含 4 项分析)、6 个受治理写入和 2 个撤销工具(undo_list、undo_apply),同一套工具通过 per-target 的 platform 字段适配两个平台。每次工具调用都会写入 ~/.identity-aiops/audit.db 审计日志,写入操作带风险等级标签、dry-run 预览和撤销令牌。工具本身不决定写入是否被允许,权限由所连接账号的角色决定。

访问官网

工具介绍

Identity-AIops 是为自托管身份提供商(Keycloak + authentik)提供的受治理 AI 运维工具,目标用户是运行自有 Keycloak 或 authentik、希望以智能体驱动身份运维并保留完整凭证的中小型基础设施团队。

主要能力方面,它提供 29 个 MCP 工具:21 个读取工具(含 4 项分析)、6 个受治理写入工具,以及 2 个撤销工具(undo_list、undo_apply)。同一套工具同时支持 Keycloak 和 authentik,通过每个目标的 platform 字段选择 API 形态(认证流程与资源路径)。其中 require_password_reset、rotate_client_secret、client_sessions、client_session_stats、user_lockout_status 为 Keycloak 专有形态,在 authentik 上会返回教学性错误;authentik 则提供陈旧访问审计中孤立会话检查所用的全局会话列表。

在安全与治理机制上,每次调用(包括错误)都会写入 ~/.identity-aiops/audit.db,记录参数、状态、风险等级,以及可选的审批人/理由注释;每次会话设有调用与时间预算及失控熔断(IDENTITY_MAX_TOOL_CALLS、IDENTITY_MAX_TOOL_SECONDS、IDENTITY_RUNAWAY_MAX)。风险分级为:读取为 low;遏制/卫生类写入(disable_user、revoke_user_sessions、require_password_reset)为 medium;授权或边界替换类写入(enable_user、update_client_redirect_uris、rotate_client_secret)为 high,该等级是描述性标签而非闸门。可逆写入会抓取并记录真实的前置状态,并在 ~/.identity-aiops/undo.db 记录可重放的逆操作;不可逆写入仅记录 priorState,密钥以掩码存储。所有 IdP 返回字符串经注入安全归一化处理后才呈现给智能体。凭据使用 Fernet 加密(scrypt 派生密钥)存于 ~/.identity-aiops/secrets.enc,TLS 校验默认开启。

使用方式上,可作为 Claude Code 插件、OpenClaw 插件、CLI 或独立 MCP 服务器运行。Keycloak 需创建启用 Service accounts roles 的机密客户端并授予所需 realm-management 角色(建议从 view-users、view-events、view-clients 起步);authentik 需创建最小权限管理员的 API 令牌。CLI 覆盖 users、clients、events、overview、doctor、secret、init、mcp 等命令,写入命令支持 --dry-run 且始终双重确认,执行会委派给受治理的 MCP 孪生工具,因此 CLI 写入同样进入审计日志。配置环境变量需注意 MCP 客户端以最小环境启动,不继承 shell profile 变量,IDENTITY_AIOPS_MASTER_PASSWORD 等须写在 env 块中。

限制方面,其验证状态为:基于公开的 Keycloak 管理 REST API 与 authentik API v3 建模,并在模拟响应上演练,尚无针对真实实例的端到端运行记录。工具不决定写入是否被允许,没有只读开关、策略文件或审批闸门可供配置;权限由所连接账号的角色在服务器端决定。平台暂未覆盖 Authelia、Zitadel、Ory 等。