Bitwarden 帮助中心中文版
⮐ Bitwarden Help Center个人主页联系我
  • 关于
  • 首页
  • 发布记录
  • 账户
    • 创建 Bitwarden 账户
    • 登录 & 解锁
      • 主密码
      • 忘记主密码
      • 新设备登录保护
      • 使用 SSO 登录
      • 使用设备登录
      • 使用通行密钥登录 (Beta)
      • 账户切换
      • 使用 PIN 码解锁
      • 使用生物识别解锁
      • 密码库超时选项
    • 两步登录
      • 两步登录现场指南
      • 两步登录方式
      • 设置指南
        • 两步登录 - 验证器
        • 两步登录 - 电子邮箱
        • 两步登录 - Duo
        • 两步登录 - YubiKey
        • 两步登录 - 通行密钥
      • 恢复代码
      • 丢失了辅助设备
      • 两步登录 FAQ
    • 更多
      • 紧急访问
      • 本地化
      • *异常流量错误
  • Password Manager
    • Password Manager 概述
    • 入门
      • Password Manager 网页 App
      • Password Manager 浏览器扩展
      • Password Manager 移动 App
      • Password Manager 桌面 App
    • 密码库基础
      • 密码库项目
      • 用户名 & 密码生成器
      • 自定义字段
      • 集成的验证器
      • 文件附件
      • 共享
      • 集合
      • 存储通行密钥
      • *通行密钥 FAQ
    • 密码库管理
      • 文件夹
      • 收藏
      • 同步密码库
      • 检索密码库
      • 密码库健康报告
    • 导入 & 导出
      • 导入数据到密码库
      • 导入指南
        • 从 LastPass 导入
        • 从 1Password 导入
        • 从 Keeper 导入
        • 从 Dashlane 导入
        • 从 Google Chrome 导入
        • 从 macOS & Safari 导入
        • 从 Firefox 导入
        • 从 Password Safe 导入
        • 从 Myki 导入
      • 导出密码库数据
      • 加密导出
      • 调整 Bitwarden .csv 或 .json
      • *Bitwarden 导入器工具
      • 导入 & 导出 FAQ
    • 自动填充
      • 自动填充基础
        • 在浏览器扩展中自动填充登录
        • 在 Android 上自动填充登录
        • 在 iOS 上自动填充登录
        • 自动填充支付卡和身份
        • 自动填充自定义字段
      • 使用 URI
      • 屏蔽自动填充
      • 基本验证提示
      • 键盘快捷键
      • 禁用浏览器的内置密码管理器
      • Android 自动填充故障排除
      • 自动填充 FAQ
    • Bitwarden Send
      • 关于 Send
      • 创建 Send
      • 接收 Send
      • Send 生命周期
      • Send 隐私
      • CLI 上的 Send
      • Send 加密
      • Send FAQ
    • 开发者工具
      • Password Manager API
      • Password Manager CLI
      • CLI 身份验证挑战
      • 用于 CLI 验证的个人 API 密钥
      • SSH 代理
    • 更多
      • Password Manager FAQ
      • 更改 App 主题
      • DuckDuckGo macOS 浏览器集成
      • Apple Watch 上的 Bitwarden
      • 在 Firefox 隐私窗口中使用 Bitwarden
      • 离线使用 Bitwarden
      • 排除域名
      • Safari 网页扩展
      • uMatrix 和 NoScript 访问规则
      • 与 Bitwarden 支持排除移动端故障
  • Bitwarden Authenticator
    • Bitwarden Authenticator
    • 导入 & 导出
    • FAQ
  • Secrets Manager
    • Secrets Manager 概述
    • 入门
      • Secrets Manager 快速入门
      • 开发人员快速入门
      • 登录 Secrets Manager
      • 管理您的组织
    • 您的机密
      • 工程
      • 机密
      • 机器账户
      • 访问令牌
      • 机密解密
    • 导入 & 导出
      • 导入数据
      • 导出数据
    • 开发人员工具
      • Secrets Manager CLI
      • Secrets Manager SDK
    • 集成
      • Ansible
      • GitHub Actions
      • GitLab CI/CD
      • Secrets Manager Kubernetes Operator
    • 更多
      • Secrets Manager FAQ
  • 管理控制台
    • 组织快速入门
    • 组织基础
      • 组织
      • 集合
      • 群组
      • 企业策略
      • 集合管理
    • 用户管理
      • 用户管理
      • 成员角色和权限
      • 声明域名
      • 声明账户
      • 账户恢复
      • SCIM
        • 关于 SCIM
        • JumpCloud SCIM 集成
        • Microsoft Entra ID SCIM 集成
        • Okta SCIM 集成
        • OneLogin SCIM 集成
        • Ping Identity SCIM 集成
      • 目录连接器
        • 关于目录连接器
        • 目录连接器桌面 App
        • 目录连接器 CLI
        • 目录连接器文件存储
        • 同步选项和筛选器
        • 清除同步缓存
        • 调度同步
        • 使用 AD 或 LDAP 同步
        • 使用 Microsoft Entra ID 同步
        • 使用 Google Workspace 同步
        • 使用 Okta 同步
        • 使用 OneLogin 同步
      • 入职和继任概述
    • 导入 & 导出
      • 导入数据到组织
      • 导出密码库数据
      • 调整 Bitwarden .csv 或 .json
    • SSO 登录
      • 关于 SSO 登录
      • SAML 2.0 配置
      • OIDC 配置
      • 成员解密选项
      • 声明域名
      • 实施指南
        • ADFS SAML 实施
        • Auth0 SAML 实施
        • AWS SAML 实施
        • Duo SAML 实施
        • Google SAML 实施
        • JumpCloud SAML 实施
        • Keycloak SAML 实施
        • Microsoft Entra ID SAML 实施
        • Okta SAML 实施
        • OneLogin SAML 实施
        • Ping Identity SAML 实施
        • ADFS OIDC 实施
        • Microsoft Entra ID OIDC 实施
        • Okta OIDC 实施
        • Ping Identity OIDC 实施
        • Cloudflare Zero Trust SSO 实施
      • 受信任设备
        • 关于受信任设备
        • 设置受信任设备 SSO
        • 添加受信任设备
        • 批准受信任设备
      • Key Connector
        • 关于 Key Connector
        • 部署 Key Connector
      • *在您的 IdP 上配置 Bitwarden(SAML 2.0)
      • SSO 登录 FAQ
    • 报告
      • 密码库健康报告
      • 事件日志
      • Elastic SIEM
      • Microsoft Sentinel SIEM
      • Panther SIEM
      • Rapid7 SIEM
      • Splunk SIEM
    • 最终用户入职
      • 关于本章节
      • 欢迎电子邮件模板
      • 管理团队入职电子邮件
      • 最终用户采用电子邮件
      • 客户激活套件
      • 入职流程
    • 部署客户端 App
      • 部署浏览器扩展
        • 使用 GPO、Linux 策略和 .plist 文件部署浏览器扩展
        • 使用 Intune 部署浏览器扩展
      • 部署桌面端 App
        • 使用 Intune 部署桌面端 App
      • 部署移动端 App
        • 使用 Intune 部署移动端 App
      • 为您的服务器配置客户端
      • 使用设备管理停用浏览器密码管理器
    • Bitwarden 公共 API
    • 更多
      • 组织 FAQ
      • 链接到项目
      • 企业版 Bitwarden 功能数据表
      • 团队版和企业版迁移指南
      • LastPass 企业版迁移指南
      • 组织所有者离职时的访问权限管理
      • PoC 项目清单
      • 为生产准备试用组织
      • *团队版 Bitwarden 对比指南
  • 提供商门户
    • 提供商门户概览
    • 提供商门户快速入门
    • 提供商用户
    • 添加客户组织
    • *添加现有组织
    • 持续管理
    • 取消链接客户组织
    • 提供商事件日志
    • 提供商计费
    • 提供商 FAQ
    • 业务单元门户
      • 业务单元门户
      • 业务单元门户快速入门
  • 自托管
    • 安装 & 部署指南
      • Docker
        • Linux 标准部署
        • Linux 手动部署
        • Linux 离线部署
        • Windows 标准部署
        • Windows 离线部署
        • Unified 部署 (Beta)
      • Helm
        • 使用 Helm 自托管
        • Azure AKS 部署
        • OpenShift 部署
        • AWS EKS 部署
        • 添加 rawManifest 文件
    • 自托管组织
    • 迁移步骤
    • 证书选项
    • 配置环境变量
    • 数据库选项
    • 连接到外部 MSSQL 数据库
    • Kerberos 集成
    • 更新实例
    • 备份托管数据
    • 付费功能许可证
    • 系统管理员门户
    • 为服务器配置客户端
    • 连接客户端到实例
    • 自托管 SCIM
    • 自托管家庭赞助
    • 自托管 Send
    • 配置推送中继
    • *作为 MSP 部署 Bitwarden
    • 托管 FAQ
  • 安全
    • Bitwarden 安全白皮书
    • 密码库数据
    • 管理数据
    • 加密方式
    • KDF 算法
    • 账户加密密钥
    • 账户指纹短语
    • 数据存储
    • 合规、审计和认证
    • 服务器地理位置
    • 版本控制
    • 使用网站图标时的隐私
    • Bitwarden 软件发布支持
    • Bitwarden 的分包商
    • 来自 Bitwarden 的电子邮件
    • Bitwarden 地址
    • 安全 FAQ
  • 计划和定价
    • Password Manager
      • Password Manager 计划
      • 从个人升级到组织
      • 兑换家庭赞助
      • 高级会员续费
    • Secrets Manager
      • Secrets Manager 计划
      • 注册 Secrets Manager
    • Bitwarden 经销商
    • 开始企业版试用
    • 组织续费
    • 更新计费信息
    • 税费计算
    • 删除账户或组织
    • 取消订阅
    • 计费 FAQ
    • *更新 Bitwarden 计划 (2019-2020)
    • *更新 Password Manager 计划 & 订阅
    • *哪种计划适合我?
  • 学习中心
    • 关于学习中心
    • 使用 Bitwarden 的第一步
    • 了解 Password Manager
    • Password Manager
      • Bitwarden 入门:个人用户
      • Bitwarden 入门:管理员
      • Bitwarden 入门:成员
      • Bitwarden 入门:经销商或 MSP
    • Bitwarden 高级用户
    • 面向企业管理员的 Bitwarden
    • 了解 Secrets Manager
    • 面向 MSP 的 Bitwarden
    • 了解 Passwordless.dev
  • *杂项
    • 11 月弃用通知
    • Bitwarden 术语表
    • 迁移脚本
    • Bitwarden 101 视频系列-入门
    • Secrets Manager Beta 版注册
    • 未分配的密码库项目已移至管理控制台
    • 原生移动 App
  • 附录
    • 翻译约定
    • 资源
由 GitBook 提供支持
在本页
  • Google Workspace 设置
  • 创建 Cloud 项目
  • 启用 Admin SDK
  • 创建服务帐号
  • 获取服务帐号凭据
  • 允许对 Google Workspace 的读取访问
  • 连接到您的目录
  • 配置同步选项
  • 指定同步筛选器
  • 用户筛选器
  • 群组筛选器
  • 测试同步
  • 启动自动同步
  1. 管理控制台
  2. 用户管理
  3. 目录连接器

使用 Google Workspace 同步

上一页使用 Microsoft Entra ID 同步下一页使用 Okta 同步

最后更新于1个月前

对应的

本文将帮助您使用目录连接器将您的 Google Workplace(以前叫 G Suite)中的用户和群组同步到您的 Bitwarden 组织。

Google Workspace 设置

要设置与 Google Workplace(以前叫 G Suite)的目录同步,您需要访问 Google Workspace Admin Portal 和 Google Cloud Platform Console。目录连接器需要从这些过程中获得的信息才能正常运行。

创建 Cloud 项目

完成以下步骤来创建用于将连目录连接器连接到您的目录的 Google Cloud 项目。如果您已经有可用的 Google Cloud 项目,请跳至:

  1. 在 中,选择创建项目按钮。

  2. 为此项目输入一个 Bitwarden 专有名称(比如 bitwarden-dc-project)并选择创建按钮。

启用 Admin SDK

完成以下步骤以启用 Admin SDK API,目录连接器将向其发出请求:

  1. 在 中,选择已创建或已存在的项目。

  2. 从左侧导航中,选择 API 和服务 → 库。

  3. 在搜索框中输入 Admin SDK 并打开 Admin SDK API 服务。

  4. 选择启用按钮。

创建服务帐号

完成以下步骤以创建一个在 API 调用时使用的服务账号:

  1. 从左侧导航中,选择 API 和服务 → 凭据。

  2. 选择创建凭据按钮,并从下拉列表中选择服务账号。

  3. 填写服务账号详情部分,并选择创建按钮。

  4. 在向此服务帐号授予对项目的访问权限部分,从角色下拉列表中选择 Project → Owner 并选择继续按钮。

  5. 选择完成按钮。

获取服务帐号凭据

完成以下步骤,为已创建的服务帐号获取适当的权限:

  1. 从左侧导航中,选择 IMA 和服务 → 服务账号。

  2. 选择已创建的服务账号。

  3. 在服务账号详情页面,选择添加密钥按钮并从下拉列表中选择创建新密钥按钮。

  4. 选择密钥类型为 JSON 并选择创建按钮,将 JSON 格式的密钥下载到您的本地计算机。

  5. 返回您的服务账号的I详情页面,选择显示全网域授权下拉条。

  6. 选中启用全网域授权框。

  7. 输入一个同意屏幕产品名称。

  8. 选择保存。

允许对 Google Workspace 的读取访问

完成以下步骤以授权客户端读取您的目录:

  1. 从左侧导航中,选择安全 → API 控制。

  2. 选择管理全网域授权按钮。

  3. 选择新增按钮。

  4. 在 OAuth 范围字段中,粘贴以下值以仅授予读取访问权限。

  5. 选择授权按钮。

https://www.googleapis.com/auth/admin.directory.user.readonly,https://www.googleapis.com/auth/admin.directory.group.readonly,https://www.googleapis.com/auth/admin.directory.group.member.readonly

连接到您的目录

完成以下步骤以配置目录连接器使用您的 Google 目录:

  1. 导航到 Setting 标签页。

  2. 从 Type 下拉列表中选择 G Suite(Google)。 此部分中的可用字段将根据您选择的类型而变化。

  3. 输入您的 Google 账号的 Domain。

  4. 输入对您的 Google 目录具有完全访问权限的 Admin User 的电子邮箱地址。

  5. 如果您有,请输入目录的客户 ID。许多用户没有或不需要输入客户 ID。

配置同步选项

完成以下步骤以配置当使用目录连接器同步时要使用的设置:

  1. 导航到 Setting 标签页。

  2. 在 Sync 部分,根据需要配置如下选项:

选项
描述

Interval

自动同步检查的时间间隔(分钟为单位)。

Remove disabled users during sync

选中此框以从 Bitwarden 组织中删除已在您的组织中禁用的用户。

Overwrite existing organization users based on current sync settings

选中此框以始终执行完全同步,如果任何用户不在同步用户集中,则将其从 Bitwarden 组织中移除。

More than 2000 users or groups are expected to sync

如果预计同步 2000 个以上用户或群组,请选中此框。如果不勾选此框,目录连接器会将同步限制在 2000 个用户或群组。

Sync Users

选中此框以将用户同步到您的组织。

选中此框将允许您指定用户筛选器。

User Filter

Sync Groups

选中此框以将群组同步到您的组织。

选中此框将允许您指定群组筛选器。

Group Filter

指定同步筛选器

使用逗号分隔的列表可根据用户电子邮箱、群组名称或群组成员资格在同步中包含或排除。

Admin SDK API 通过一个 query 参数为用户和裙组提供有限的筛选功能。了解更多:

用户筛选器

在 User Filter 字段中使用以下筛选语法:

通过电子邮箱包含/排除用户

要基于电子邮箱地址在同步中包含或排除特定用户:

include:joe@example.com,bill@example.com,tom@example.com
exclude:joe@example.com,bill@example,tom@example.com

使用 query 连接

要使用 query 参数连接用户筛选器,请使用竖线(|):

include:john@example.com,bill@example.com|orgName=Engineering orgTitle:Manager
exclude:john@example.com,bill@example.com|orgName=Engineering orgTitle:Manager

只使用 query

要只使用 query 参数,请在查询前加上竖线(|):

|orgName=Engineering orgTitle:Manager

群组筛选器

在 Group Filter 字段中使用以下筛选语法:

包含/排除群组

要基于群组名称在同步中包含或排除群组:

include:Group A,Group B
exclude:Group A,Group B

使用 query 连接

要使用 query 参数连接群组筛选器,请使用竖线(|):

include:name='Engineering'|email:admin*
exclude:name='Engineering'|email:admin*

只使用 query

要只使用 query 参数,请在查询前加上竖线(|):

|memberKey=user@company.com

测试同步

启动自动同步

  1. 导航到 Dashboard 标签页。

  2. 在 Sync 部分选择 Start Now 按钮。 或者你可以选择 Sync Now 按钮以运行一次性手动同步。

如果您退出或关闭了目录连接器,自动同步将停止。最小化或隐藏此程序到系统托盘,以保持后台运行。

该计划已不再提供购买。此错误不适用于团队计划。

在 中,选择已创建或已存在的项目。

在 中,选择已创建或已存在的项目。

打开 。

粘帖已创建的客户端 ID 到客户端 ID 字段中。 要查看已创建的客户端 ID,请打开 并导航到 API 和服务 → 凭据。

打开目录连接器。

选择选择文件按钮并选择。

完成配置后,请导航至 More 标签页,然后选择 Clear Sync Cache 按钮,以防止与先前的同步操作发生潜在冲突。有关更多信息,请参阅。

打开目录连接器。

参阅。

参阅。

要测试目录连接器是否成功连接到您的目录并返回所需的用户和群组,导航到 Dashboard 标签页并选择 Test Now 按钮。如果成功,则用户和群组将根据指定的和显示在目录连接器窗口中:

配置并测试和后,就可以开始同步了。完成以下步骤以使用目录连接器启动自动同步:

打开目录连接器。

目录连接器将根据配置的和开始轮询目录。

如果您使用的是 计划,则只能同步 10 个成员。如果您尝试同步超过 10 名成员,目录连接器将显示错误并停止同步。

GCP Console
GCP Console
Google Admin Portal
GCP Console
桌面 App
清除同步缓存
桌面 App
搜索用户
搜索群组
桌面 App
官方文档地址
GCP Console
GCP Console
启用Admin SDK
已下载的 JSON 密钥文件
指定同步筛选器
指定同步筛选器
测试同步的结果
同步选项
筛选器
同步选项
筛选器
同步选项
筛选器
团队入门版