SuperAPI AI 工具集

konnect-app-auth

部署与运维

查看项目

更新于 10-15 23:47

技能介绍

用途:帮助运维人员配置或排查开发者如何通过 Konnect Dev Portal 与 Konnect Application Auth 注册应用、获取凭证并使用 API。仅负责应用认证分支:策略选择、应用注册、审批、凭证以及从发布到执行的链路;Portal 登录、SSO 或通用 API 发布诊断不属于本技能。

主要能力:优先使用共享的 kong-konnect MCP 服务器实时检查门户、发布、应用认证策略、应用、注册及相关审批。需要变更认证资源时,保留仓库既定的声明式工具链:HCL 管理的资源用 terraform-konnect,仓库已使用 kongctl 时用 kongctl-declarative;仅当实际变更是下游网关实体配置时用 deck-gateway。若实时 Konnect 状态重要但 MCP 未连接,应尽早说明并改用用户提供的产物或仓库上下文。

使用方式:先分类故障面(开发者登录/SSO、应用创建或注册审批、API 特定注册、凭证发放、链接网关服务上的运行时授权),不要对所有情况用同一路径。再验证发布到执行链路:认证策略是否存在、API 是否链接到网关服务、API 是否发布到目标门户、该发布是否选择了认证策略。按客户端所有权模型选择策略,而非 UI 中易命名者。若策略正确仍失败,检查开发者审批、应用审批、注册状态(待处理/已批准/已撤销/已拒绝)以及团队或 RBAC 是否阻塞消费。最后证明链接服务的执行边界,并返回最窄故障点与下一步负责人。

适用场景:已发布 API 因应用认证策略、注册、审批或应用凭证流程被阻塞时。

限制与注意事项:用户认证与应用认证是不同层;发布时选择认证策略会作用于链接的网关服务路径,而非仅门户展示;必须链接网关服务才能按预期执行认证策略;一个应用一次只能使用一个认证策略;已发布 API 仍可能因审批、注册或链接服务执行不完整而不可用。若主要问题是开发者登录、SSO 或广泛组织/团队访问,应尽早分类并停止,不在本技能调试应用凭证。API 未发布或发布到错误受众时转用 konnect-api-publish;API 或实现模型未就绪时转用 konnect-api-catalog;问题主要是门户或认证资源的查看/管理权限或组织/团队/角色范围时转用 konnect-access-scope。