@dbx-tools/shared-auth

中文文档
0.9.206发布于 2026/11/11Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 1.4万

无密码浏览器和 Databricks 认证计划和类型

中文使用文档
文档目录5 节
  1. 读取认证状态
  2. 构建配置选择器
  3. 使用浏览器登录帮助
  4. 运行时边界
  5. 软件包出口

@dbx-tools/ shared- auth (英语)

验证无密码的签名、 密码、 Databricks 配置文件以及解析客户端 在浏览器和服务器边界上的数据。 软件包还提供了浏览器帮助 所拥有路线 @dbx-工具/自动门。 。 。 .

读取认证状态

import { authStatusSchema } from "@dbx-tools/shared-auth";

const response = await fetch("/api/email/auth/status", { credentials: "include" });
const status = authStatusSchema.parse(await response.json());

if (status.enabled && !status.authenticated) {
  showSignIn();
}

在自定义 UI 时使用请求、 校验、 登录和状态方案 运输码直接调用认证门.

构建配置选择器

简介摘要从不包含令牌或客户秘密. 验证前面的值 提供或持续选择 :

import {
  databricksProfileListSchema,
  databricksProfileSelectionSchema,
} from "@dbx-tools/shared-auth";

export function selectFirstProfile(input: unknown) {
  const profiles = databricksProfileListSchema.parse(input);
  return databricksProfileSelectionSchema.parse({
    kind: "profile",
    profile: profiles[0]!.name,
  });
}

使用 { kind: "ambient" } 当耗尽的运行时间选择正常时 Databricks 认证来源.

使用浏览器登录帮助

这个 browser 模块请求并验证电子邮件的一次性密码, 开始密码签入或注册,管理注册的密码,读取门 状态,并通过服务器提供的同源重定向日志.

import { requestEmailOtp, verifyEmailOtp } from "@dbx-tools/shared-auth/browser";

export async function requestCode(email: string) {
  return requestEmailOtp(email);
}

export async function submitCode(email: string, code: string, name: string) {
  return verifyEmailOtp(email, code, name);
}

浏览器助手使用同源 /api/email/auth 路径并包含会话 饼干 电子邮件一次性密码和登录需要认证门服务器路由. Passkey操作还需要一个有WebAuthn支持的浏览器. 直接认证 其它地方挂载的运行时间必须使用相同的基路径,这些帮助者才能使用 说吧.

运行时边界

Zod schemas and secret-free profile 类型对于共享代码是安全的. 这个 ./browser 子路径执行浏览器网络和WebAuthn操作. 这个 软件包不解析证书、薄荷数据砖符号或注册服务器 路线。 使用 @dbx-tools/ auth (英语) databricks 证书 决议和 @dbx-工具/自动门 无密码 服务器路由.

软件包出口

  • auth:验证无密码门请求和回复.
  • browser:执行电子邮件检察官办公室、密码、状态和登出业务.
  • config:定义 Databricks 认证和目标值.
  • profile:验证无秘密配置列表和选择.
  • client: 验证已解决,无秘密 Databricks 客户端信息.

版本与发布记录

@dbx-tools/shared-auth 共发布 227 个版本,首次发布于 2026/08/08;过去 12 个月发布了 227 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.9.206latest2026/11/11今天
0.9.2052026/11/111 天前
0.9.2042026/11/101 天前
0.9.2032026/11/074 天前
0.9.2022026/11/065 天前
0.9.2012026/11/056 天前

关于 @dbx-tools/shared-auth 的常见问题

@dbx-tools/shared-auth 是什么?

无密码浏览器和 Databricks 认证计划和类型

如何安装 @dbx-tools/shared-auth?

在项目目录运行 npm install @dbx-tools/shared-auth,或使用 pnpm add / yarn add / bun add。

@dbx-tools/shared-auth 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@dbx-tools/shared-auth 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@dbx-tools/shared-auth 可以商用吗?

@dbx-tools/shared-auth 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@dbx-tools/shared-auth 的下载量有多少?

根据 npm 官方下载统计,@dbx-tools/shared-auth 在 2026/10/12 – 2026/11/10 这 30 天内被下载 13,732 次,日均约 458 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@dbx-tools/shared-auth 还在维护吗?

最新版本 0.9.206 发布于 2026/11/11(今天);至今共发布 227 个版本,其中过去 12 个月发布了 227 个;首次发布于 2026/08/08。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。