For the complete documentation index, see llms.txt. This page is also available as Markdown.

同步验证码

将 Authenticator 与 Password Manager 连接以同步您的验证码。激活后,Bitwarden App 将与您添加或编辑的任何代码(本地代码除外)保持同步。这可以帮助您从任一 App 快速查找和使用 TOTP:

在 Bitwarden Authenticator(左)和 Password Manager(右)之间同步

如果您有多个 Password Manager 账户,您可以选择要与 Authenticator 同步的账户。同样,存储在 Authenticator 中的本地代码可以保持独立,也可以将它们移动到 Password Manager 以便从两个 App 进行访问。

如果您希望仅将验证码保存在一个 Bitwarden App 中,请不要同步您的账户。这有两种选择:

  • 仅从 Bitwarden 密码库访问代码:使用 Password Manager 集成的身份验证器保存 TOTP,并且不要启用 Bitwarden 账户的允许验证器同步 App 设置。这意味着该特定 Bitwarden 账户中保存的任何代码都不会在 Authenticator 中显示。

  • 仅从 Authenticator App 访问代码:首次将代码添加到 Authenticator 时,选择保存到此处以将其添加为本地代码。这些代码未连接到您的 Bitwarden 账户,因此无法在您的 Bitwarden 密码库中的任何位置找到它们。

设置同步

已保存在 Bitwarden 密码库登录项目中的代码可以与 Authenticator 同步。如果您有本地代码(即仅保存在您的设备上并通过 Authenticator 访问的 TOTP),请首先将代码复制到您的密码库。代码位于您的密码库中后,它们就会像其他 TOTP 一样同步。

同步保存在 Bitwarden 密码库中的代码

要使用此功能,您必须拥有 iOS 或 Android 12+。要在两个 Bitwarden App 之间同步 TOTP:

  1. 确保您的设备上安装了 Bitwarden Authenticator 和 Bitwarden Password Manager。

  2. 在 Password Manager 中,登录要与 Authenticator 同步的账户。

  3. 点击 设置图标。

  4. 点击账户安全。

  5. 启用允许验证器同步。

  6. (可选)要同步其他 Password Manager 账户,请为每个账户重复步骤 2-5。您需要为每个账户单独切换设置,这样您才能准确选择与 Authenticator 同步的账户。

  7. Authenticator 将代码分为两组:本地代码和从 Password Manager 同步的代码。请确认您的 Password Manager TOTP 代码是否显示在 Authenticator 中您的账户电子邮箱标题下。

将本地代码移动并同步到 Bitwarden 密码库

您可以手动将本地代码复制到您的 Bitwarden 密码库,以便从两个 App 进行访问。要将本地代码复制并移动到 Password Manager:

  1. 在 Bitwarden Authenticator 中,长按该代码。

  2. 点击复制到 Bitwarden 密码库。

  3. 这将打开 Password Manager 并搜索匹配的登录项目。

    • 如果找到匹配的登录项目,点击该登录项目。编辑或输入任何其他详细信息,然后在完成后点击 检查图标。

    • 如果未找到匹配的登录项目,点击 新增项目。编辑或输入任何其他详细信息,然后在完成后点击 检查图标。

同步工作原理

尽管各个平台的核心密钥交换工作流程是相同的,但用于实现 Password Manager 和 Authenticator 之间同步的安全存储和通信方法则因 Android 或 iOS 而异:

当 Password Manager 中的允许验证器同步被激活时:

  1. Password Manager 客户端生成一个全局对称密钥,然后通过 Android 接口定义语言 (AIDL) 与 Authenticator 共享。

  2. 您现有的账户加密密钥将本地持久化存储,这将允许在 TOTP 同步需要时使用它来解密 Password Manager 项目数据。

当您打开 Authenticator 并且允许验证器同步被激活时:

  1. 通过 AIDL 向 Password Manager 发起请求。

  2. Password Manager 在响应请求时,使用持久化的账户加密密钥临时解密您的项目数据,然后使用全局对称密钥重新加密这些数据。

  3. Password Manager 将重新加密的身份验证器密钥、显示名称和用户名,通过 AIDL 发送到 Authenticator。任何敏感数据都不会未经加密通过 AIDL 传输。

  4. Authenticator 接收您重新加密的身份验证器密钥、显示名称和用户名,然后使用共享的全局对称密钥解密这些数据。

[译者注]:AIDL(Android Interface Definition Language,Android 接口定义语言)是 Android 系统用于实现进程间通信 (IPC) 的一种机制。它允许在不同 App 之间进行数据交换和方法调用,使得不同进程能够安全有效地共享数据和功能。

当 Password Manager 中的允许验证器同步被激活时:

  1. Password Manager 客户端生成一个全局对称密钥,然后写入由 Password Manager 和 Authenticator 共享的钥匙串。

  2. 使用全局对称密钥加密保存在您的密码库项目中的身份验证器密钥、显示名称和用户名,然后存储到 App Group(App 组)的共享容器中。

当您打开 Authenticator 并且允许验证器同步被激活时:

  1. Authenticator 从共享的钥匙串中获取全局对称密钥。

  2. Authenticator 从 App Group 中获取加密的身份验证器密钥、显示名称和用户名。

  3. Authenticator 使用全局对称密钥在本地解密身份验证器密钥、显示名称和用户名。

当您停用允许验证器同步或完全注销 Bitwarden Password Manager 时,存储在 App Group 中的加密数据(验证器密钥、显示名称和用户名)将被删除。如果所有关联的 Bitwarden 账户停用允许验证器同步或注销,则全局对称密钥也会被删除。

[译者注]:App Group 是 Apple 提供的允许同一开发者账号下的多个 App 或 Extension 共享数据(如登录状态)的机制。它通过提供一个共享的容器 (Shared Container),使得不同的 App 或 Extension 可以访问同一份数据,从而突破 iOS 沙盒 (Sandbox) 的限制,实现跨 App 数据共享。

最后更新于