生物识别解锁

对应的官方页面地址

当前，移动端、桌面端和浏览器扩展支持生物识别解锁。Bitwarden 的生物识别解锁功能与本机消息传递 API 集成以发挥其功能。

哪些设备支持生物识别解锁？

有关最新的信息，请参阅帮助文章。截止撰写本文时，以下是概要：

支持：

• 基于 Chromium 的浏览器

• Firefox 87 及更高版本

• Safari 14 及更高版本

• 从 download 获取的侧面加载的 Windows 桌面应用程序

• 从 Mac Apple Store 下载 Mac 应用程序

• 使用 Windows Hello 的 Windows 桌面应用程序

不支持：

• Firefox 86 及更早版本

• 侧面加载的 macOS 桌面应用程序

• Linux OS

一般设置步骤

如果您之前已经为 Safari 安装了本地构建的浏览器扩展，请按照此处所述重置扩展引用路径。

本机消息传递的工作方式是让浏览器启动一个轻量级的代理，并将其植入我们的桌面应用程序。

开箱即用，桌面应用程序只能与生产型浏览器扩展通信。当您在桌面应用程序中启用浏览器集成时，应用程序会生成包含浏览器扩展的生产 ID 的清单。要启用桌面应用程序与开发版浏览器扩展之间的通信，我们需要将您的浏览器扩展开发 ID 添加到此清单中。

构建并运行浏览器扩展

• 在本地浏览器项目中，运行 npm ci。

• 要在 Safari 上使用本地浏览器扩展，请使用以下命令：npm run dist:safari:dmg。构建完成后，您应该会在 Safari 的「偏好设置」中的「扩展」菜单下看到 Bitwarden 扩展。如果没有，打开并构建相关的 Xcode 项目（通常位于 $HOME/browser/dist/Safari/dmg/desktop.xcodeproj）。然后它会出现在「设置」菜单中，您就可以启用它了。

• 对于其他浏览器，使用 npm run build:watch 然后使用此处描述的方法加载本地构建的扩展。

为本机消息添加扩展 ID

运行扩展后，确认扩展 ID 已添加到您选择的浏览器的 NativeMessagingHost JSON 文件中。

• 在 chrome://extensions 或 about:debugging 中找到扩展 ID。

• 使用您的 IDE 将 ID 添加到 NativeMessageHost JSON 文件中。此文件嵌套在应用程序支持目录下。例如，对于 Chrome 浏览器，该文件位于：

Windows

%APPDATA%\Bitwarden\browsers\chrome.json

macOS

~/Library/Application Support/Google/Chrome/NativeMessagingHosts/com.8bit.bitwarden.jso

Linux

~/.config/google-chrome/NativeMessagingHosts/com.8bit.bitwarden.json

构建并运行桌面应用程序

按照桌面端设置文档进行操作。

在 macOS 上，您需要构建一个 Mac App Store Development Build，或者关闭 Gatekeeper。

我的项目已经在运行了，然后呢？

• 在桌面应用程序的首选项菜单中，开启 Enable browser integration。

• 在浏览器扩展中，访问设置菜单，然后启用 Unlock with biometrics 选项。

  • 浏览器会询问您要求您允许该操作，但随后会锁定扩展。当您解锁密码库并再次启用生物识别解锁时，系统会要求您在桌面应用程序中确认此选择，并开启本地生物识别解锁功能。