基础身份验证允许用户通过电子邮件和密码登录 LangSmith 自托管版,无需配置外部身份提供者。组织管理员可直接在 LangSmith 中管理用户,因此身份验证完全独立运行,不依赖于 OAuth 或 SSO。
有关 LangSmith 自托管版支持的身份验证方法的说明,请参阅身份验证方法页面。

注意事项

  • 您可以通过更改配置参数,将基础身份验证安装升级为使用客户端密钥的 OAuth,但不能从任何 OAuth 模式切换回基础身份验证。
  • 您无法在基础身份验证与 OAuth with PKCE(已弃用)之间进行双向切换。
  • 新的基础身份验证安装需要一个全新的安装过程,包括独立的 PostgreSQL 数据库/架构,除非是从现有的无身份验证安装迁移(请参阅从无身份验证迁移)。
  • 用户被邀请时会收到一个自动生成的初始密码,该密码必须通过带外方式共享给他们。任何组织管理员之后都可以更改此密码。
  • 您不能同时启用基础身份验证和使用客户端密钥的 OAuth。
  • 所有基础身份验证用户共享一个在安装时预置的单一 Default 组织。不支持创建其他组织。

要求与功能

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

从无身份验证迁移

仅在0.7 及更高版本中受支持。
从无身份验证模式迁移到基础身份验证会保留您现有的追踪、数据集和其他资源。LangSmith 会用您在配置文件中设置的基础身份验证凭据创建的用户替换单一的”默认”用户。预先存在的工作区保留其 ID(00000000-0000-0000-0000-000000000000),因此现有资源仍与其绑定。除了用户替换之外,迁移后的安装行为与全新基础身份验证安装相同。 要迁移,请应用配置中显示的基础身份验证配置,然后运行 helm upgrade。

配置

更改 JWT 密钥将导致您的用户登出。
通过将以下代码块添加到您的 LangSmith Helm 配置值中来启用基础身份验证。在首次安装时,LangSmith 使用这些值为 Default 组织创建初始组织管理员用户:
Helm
配置完成后,LangSmith 会显示一个包含电子邮件和密码的登录界面。使用 initialOrgAdminEmail 和 initialOrgAdminPassword 的值登录,您的用户将自动被配置为 Organization Admin 角色。更多详情,请参阅组织角色。