Auth

Mastra 让你选择如何处理认证，从而使用适合你技术栈的身份系统来保护对 API 和 Studio 的访问。

你可以从基础的共享密钥 JWT 认证开始，在需要更高级的身份功能时切换到已知的提供器。

Auth 保护什么
Auth 保护什么的直接链接

配置认证会同时锁定两件事：

Studio UI：Studio 会显示登录页面（SSO、电子邮件/密码或两者）。当你还配置了 RBAC 提供器时，Studio 会强制执行基于角色的访问控制，以确定每个团队成员可以看到和做什么。
API 路由：内置路由（/api/agents/*、/api/workflows/* 等）和自定义路由都需要认证，无论请求来自 Studio 还是直接 API 调用。少数内置路由保持公开，例如 GET /api/auth/capabilities，Studio 用它来检测登录状态。

认证是可选的。如果未配置 auth，所有路由和 Studio 都是公开可访问的。可以使用 requiresAuth: false 在单个自定义路由上启用公开访问。

关于在自定义端点上控制认证，请参阅自定义 API 路由。关于保护 Studio 部署的更多信息，请访问 Studio Auth 文档。

注意

默认 auth 配置保护 /api/*，并将 /api、/api/auth/* 视为公开。当你设置自定义 server.apiPrefix 时，这些默认值将不再匹配，内置路由会落在受保护模式之外。请更新 server.auth.protected 和 server.auth.public 以引用新的前缀。

备注

Studio 的认证目前由以下提供器支持：Simple Auth、JWT、WorkOS、Better Auth 和 Google。