mcpField
C
catalyst-authentication

catalyst-authentication

github.com/catalystbyzoho安全701.0k 次安装今天更新
代码仓库

关于 catalyst-authentication

面向 Catalyst 应用身份验证开发与排错的技能，涵盖登录流程、环境相关的 ZAID 配置、函数访问规则，以及 OAuth 和第三方身份提供方设置。

主要功能

  1. 01托管式与嵌入式登录指导
  2. 02用户注册与会话检查
  3. 03开发和生产环境 ZAID 检查
  4. 04函数身份验证规则指引
  5. 05OAuth 与第三方登录参考

适用场景

  1. 01实现注册或登录
  2. 02排查生产环境社交登录失败
  3. 03管理外部 API 的 OAuth 令牌

MCP 相关

该技能在可用时可通过 MCP 查找 Catalyst Cache Segment ID；其本身未说明 MCP 服务接口。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/catalystbyzoho/agent-skills --skill catalyst-authentication

安装后在 Claude Code 中输入/catalyst-authentication确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
auth-basics.md
auth-thirdparty.md
connections.md

详细介绍

本地身份验证必须使用纯 catalyst serve

只有通过 catalyst serve 提供服务时，本地身份验证才能正常工作。身份验证开发绝对不要使用原生开发服务器（npm run dev、vite、next dev、ng serve 等）——Catalyst 身份验证中间件、Cookie 注入和 /__catalyst/sdk/init.js 仅通过 catalyst serve 提供。

工作原理

  1. 确定流程类型 — 托管登录（重定向到 Catalyst 登录页面）、嵌入式登录（自定义 UI）或后端 getCurrentUser 检查。
  2. 加载 references/auth-basics.md — 用于注册／登录流程、ZAID 注意事项、托管与嵌入式登录，以及常见身份验证错误。
  3. ZAID 警告 — Development 和 Production 中的 ZAID 不同。这是生产环境中最常见的身份验证问题。务必确认环境。
  4. 安全规则 — 如果查询涉及控制谁可以调用函数，请转到 catalyst-functions 技能及其 references/functions-basics.md 中的 Security Rules 部分。Security Rules 有两个参数：（a）methods — 函数启用哪些 HTTP 方法（GET/POST/PUT/DELETE/PATCH）（移除某个方法会彻底阻止该 HTTP 动词）；（b）authentication — 单个二元标志（optional = 公开，required = 仅限已验证用户），适用于整个函数，而非单个方法。如需按角色控制数据访问，请转到 DataStore Scopes and Permissions（Console → Table → Scopes and Permissions）。
  5. OAuth／Connections — 有关外部 API OAuth 令牌管理（Zoho 或第三方），请加载 references/connections.md。
  6. 第三方身份验证／社交登录 — 如果查询涉及 Okta、Auth0、Duo、自定义 IdP、Google／Facebook／LinkedIn／Microsoft 登录、generateCustomToken 或 signinWithJwt，请加载 references/auth-thirdparty.md。

安全检查清单

  • ZAID 与环境相关。 Development ZAID 与 Production ZAID 不同。上线前，必须使用 Production ZAID 和生产应用域名重新配置在 Development 中设置的社交登录（Google、Facebook、LinkedIn、Microsoft）——使用错误的 ZAID 会导致所有社交登录在生产环境中静默失败。
  • DataStore 权限与函数级身份验证相互独立。 在 Security Rules 中要求身份验证，只能控制谁可以调用函数。App User 表权限（Console → Table → Scopes and Permissions）则单独控制已验证用户可以执行哪些 DataStore 操作。

触发条件

在以下场景使用此技能："authentication"、"user management"、"login"、"signup"、getCurrentUser、"ZAID"、registerUser、isUserAuthenticated、signOut、"cross-domain logout"、"hosted login"、"embedded login"、"Connections"、"OAuth token"、getConnector、getAccessToken、"Security Rules"、"App User"、"credentials include"、"auth redirect"、"third-party auth"、"third-party authentication"、"social login"、"Google login"、"Facebook login"、"LinkedIn login"、"Microsoft login"、signinWithJwt、generateCustomToken、"Okta"、"Auth0"、"Duo"、"custom IdP"。

参考资料

参考资料在查询涉及以下内容时加载……
references/auth-basics.md用户注册／登录、getCurrentUser、Web SDK 身份验证流程、ZAID 注意事项、托管与嵌入式登录、常见身份验证错误
references/auth-thirdparty.md第三方身份验证服务（Okta、Auth0、Duo）、社交登录（Google/Facebook/LinkedIn/Microsoft）、generateCustomToken、signinWithJwt、令牌流程、控制台设置
catalyst-functions 技能Security Rules — 函数调用控制（methods、authentication: optional/required）
references/connections.md外部 API 的 OAuth 令牌管理 — getConnector、getAccessToken、Zoho 和第三方服务连接

评论

支持 Markdown