使用电子邮件和密码进行基本认证

基本认证允许用户使用电子邮件和密码登录 LangSmith Self-hosted，而无需配置外部身份提供商。Organization Admins 可以直接在 LangSmith 中管理用户，因此认证过程是自包含的，不依赖 OAuth 或 SSO。

TIP

有关 LangSmith Self-hosted 支持的认证方法的说明，请参阅认证方法页面。

注意事项

• 你可以通过替换配置参数，将基本认证安装升级为 OAuth with client secret，但无法从任何 OAuth 模式切换回基本认证。
• 你无法在基本认证和 OAuth with PKCE（已弃用）之间进行任一方向的切换。
• 新的基本认证安装需要全新安装，包括单独的 PostgreSQL 数据库/schema，除非是从现有的 None 认证安装迁移（请参阅从 none 认证迁移）。
• 用户被邀请时会收到自动生成的初始密码，必须通过带外方式告知他们。任何 Organization Admin 之后都可以更改此密码。
• 你不能同时启用基本认证和 OAuth with client secret。
• 所有基本认证用户共享一个在安装时预置的 Default organization。不支持创建额外的 organization。

要求与功能

• 你的初始密码必须至少 12 个字符，并至少包含一个小写字母、大写字母和符号（请参阅配置）。
• 用于签名 JWT 的 secret 没有严格要求，但应是安全生成的、至少 32 个字符的字符串。例如，openssl rand -base64 32。

从 none 认证迁移

NOTE

仅在 0.7 及更高版本中受支持。

从 None 认证模式迁移到基本认证会保留你现有的 trace、数据集和其他资源。LangSmith 会将单个“default”用户替换为根据你在配置文件中设置的基本认证凭据创建的用户。已有的 workspace 会保留其 ID（00000000-0000-0000-0000-000000000000），因此现有资源仍会绑定到它。除了用户替换之外，迁移后的安装行为与全新的基本认证安装相同。

要迁移，请应用配置中所示的基本认证配置，然后运行 helm upgrade。

配置

NOTE

更改 JWT secret 会导致用户退出登录。

通过将以下代码块添加到 LangSmith Helm values 来启用基本认证。首次安装时，LangSmith 会使用这些值为 Default organization 创建初始 Organization Admin 用户：

config:
  authType: mixed
  basicAuth:
    enabled: true
    initialOrgAdminEmail: <YOUR EMAIL ADDRESS>
    initialOrgAdminPassword: <PASSWORD> # Must be at least 12 characters long and contain at least one lowercase, uppercase, and symbol
    jwtSecret: <SECRET>

配置完成后，LangSmith 会显示电子邮件和密码登录界面。使用 initialOrgAdminEmail 和 initialOrgAdminPassword 值登录，你的用户将自动获得 Organization Admin 角色。更多详情请参阅 Organization roles。

---