用途:该技能用于查询和管理 Zscaler ZIdentity 中的身份相关对象,涵盖用户、组、部门以及身份提供商(IdP)配置,并支持查看 SCIM 同步组、SAML 属性映射和各类管理员信息。
主要能力:提供一系列工具,包括 list_users 列出所有用户、get_user 获取用户详情、list_groups 列出所有组、get_group 获取组详情、list_departments 列出所有部门、get_department 获取部门详情、list_idp_configs 列出身份提供商配置、get_idp_config 获取 IdP 配置详情、list_scim_groups 列出 SCIM 供应的组、list_saml_attributes 列出 SAML 属性映射、list_admin_users 列出管理员用户、get_admin_user 获取管理员用户详情、list_admin_roles 列出管理员角色。典型查询包括列出工程部门的所有用户、显示从 Azure AD 同步的组、查看哪些 IdP 配置处于活动状态、列出具有超级管理员角色的管理员用户以及显示部门层级。
使用方式:需配置环境变量 ZSCALER_CLIENT_ID(OneAPI 客户端 ID)、ZSCALER_CLIENT_SECRET(OneAPI 客户端密钥)、ZSCALER_CUSTOMER_ID(客户/租户 ID)、ZSCALER_VANITY_DOMAIN(虚域名),并确保 ZSCALER_MCP_SERVICES 包含 zidentity。该技能使用 zscaler-mcp 服务器,通过 OneAPI 连接 ZIdentity。
限制与错误处理:工具出错(超时、主机不可达、响应格式错误)时,应直接向用户报告失败及错误信息,不得编造或猜测结果。对于已确认的只读调用,可检查连通性并最多重试一次;对于任何会改变状态或发送消息的调用,超时无法证明操作失败,应在重试前检查当前状态或投递状态,保留必要的审批/变更门控,且不得重复执行结果未知的操作。