Google Workspaceと同期

この記事は、Directory Connectorを使用して、Google Workspace（旧「G Suite」）のディレクトリからユーザーとグループをBitwarden組織に同期する方法を開始するのに役立ちます。

Google Workspace（旧「G Suite」）とのディレクトリ同期を設定するには、Google Workspace管理者ポータルとGoogle Cloud Platformコンソールへのアクセスが必要です。ディレクトリコネクタは、これらのプロセスから取得した情報を適切に機能するために必要とします。

次の手順を完了して、ディレクトリコネクタをディレクトリに接続するために使用するGoogle Cloudプロジェクトを作成します。すでにGoogle Cloudプロジェクトをお持ちの場合は、Admin SDKを有効にするにスキップしてください。

1. GCPコンソールで、プロジェクトを作成ボタンを選択します。

2. プロジェクトにBitwarden特有の名前を入力してください（例：bitwarden-dc-project）そして、作成ボタンを選択してください。

次の手順を完了して、Directory Connectorがリクエストを行うAdmin SDK APIを有効にします:

1. GCPコンソールで、作成済みまたは既存のプロジェクトを選択します。

2. 左側のナビゲーションから、APIとサービス → ライブラリを選択してください。

3. 検索ボックスにAdmin SDKを入力し、Admin SDK APIサービスを開きます。

4. 有効にするボタンを選択してください。

次の手順を完了して、API呼び出しを行う際に使用するサービスアカウントを作成します:

1. GCPコンソールで、作成済みまたは既存のプロジェクトを選択します。

2. 左側のナビゲーションから、APIとサービス → 認証情報を選択してください。

3. 認証情報を作成ボタンを選択し、ドロップダウンからサービスアカウントを選択します。

4. サービスアカウントの詳細セクションを記入し、作成ボタンを選択してください。

5. このサービスアカウントにプロジェクトへのアクセスを許可するセクションで、役割のドロップダウンからプロジェクト → 所有者を選択し、続行ボタンを選択します。

6. 完了ボタンを選択してください。

作成されたサービスアカウントに適切な権限を取得するための次の手順を完了してください:

1. GCPコンソールで、作成済みまたは既存のプロジェクトを選択します。

2. 左側のナビゲーションから、IAM & 管理者 → サービスアカウントを選択してください。

3. 作成されたサービスアカウントを選択してください。

4. サービスアカウント詳細ページで、キーを追加ボタンを選択し、ドロップダウンから新しいキーを作成を選択します。

5. キータイプJSONを選択し、作成ボタンを選択して、ローカルマシンにJSON形式のキーをダウンロードします。

6. あなたのサービスアカウントの詳細ページに戻り、ドメイン全体の委任を表示ドロップダウンを選択してください。

7. これらの手順を実行して、ドメイン全体の権限を委任することを有効にします。

8. 同意画面のための製品名を入力してください。

9. 保存を選択してください。

以下の手順を完了して、クライアントがあなたのディレクトリを読むことを許可します:

1. Google 管理者ポータルを開きます。

2. 左側のナビゲーションから、セキュリティ → APIコントロールを選択します。

3. ドメイン全体の委任を管理ボタンを選択してください。

4. 新規追加ボタンを選択してください。

5. クライアントIDフィールドに、作成したクライアントIDを貼り付けてください。

   作成したクライアントIDを取得するには、GCPコンソールを開き、API & サービス → 認証情報に移動します。

6. OAuthスコープフィールドに、読み取り専用アクセスのみを許可する以下の値を貼り付けてください：

   Bash
   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

7. 承認ボタンを選択してください。

次の手順を完了して、Directory ConnectorをあなたのGoogleディレクトリを使用するように設定します：

1. ディレクトリコネクタデスクトップアプリを開きます。

2. 設定タブに移動してください。

3. タイプのドロップダウンから、G Suite (Google)を選択してください。

   このセクションで利用可能なフィールドは、選択したタイプによって変わります。

4. あなたのGoogleアカウントのドメインを入力してください。

5. あなたのGoogleディレクトリへの完全なアクセス権を持つ管理者ユーザーのメールアドレスを入力してください。

6. もしあれば、ディレクトリの顧客IDを入力してください。多くのユーザーは、カスタマーIDを持っていないか、または入力する必要がないでしょう。

7. 「ファイルを選択」ボタンを選択し、ダウンロードしたJSONキーを選択してください。

次の手順を完了して、Directory Connectorを使用して同期する際に使用する設定を構成します:

1. ディレクトリコネクタデスクトップアプリを開きます。

2. 設定タブに移動してください。

3. 同期セクションで、必要に応じて以下のオプションを設定します:

ユーザーのメールアドレスまたはグループに基づいて同期から含めるか除外するために、カンマ区切りのリストを使用してください。

Admin SDK APIは、クエリパラメータを使用したユーザーとグループの限定的なフィルタリング機能を提供します。詳しく学ぶために：

• ユーザーを検索する

• グループを検索します

ユーザーフィルター

次のフィルタリング構文は、ユーザーフィルタフィールドで使用する必要があります:

メールアドレスによるユーザーの含める/除外する

メールアドレスに基づいて特定のユーザーを同期に含めるか除外するには：

Bash
include:joe@example.com,bill@example.com,tom@example.com

Bash
exclude:joe@example.com,bill@example,tom@example.com

クエリと連結する

ユーザーフィルタをクエリパラメータと連結するには、パイプ(|)を使用します。

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

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

クエリだけを使用してください。

クエリパラメータのみを使用するには、クエリの前にパイプ(|)を付けてください。

Bash
|orgName=Engineering orgTitle:Manager

グループフィルター

次のフィルタリング構文は、グループフィルターフィールドで使用する必要があります：

グループを含む/除外する

グループ名に基づいてグループを同期に含めるか除外するには：

Bash
include:Group A,Group B

Bash
exclude:Group A,Group B

ワイルドカードを含むグループを含めてください。

Bash
|name:*marketing*

ワイルドカード* は、検索パラメータの両側でサポートされています。さらに、検索は大文字と小文字を区別しません。

クエリと連結する

グループフィルタをクエリパラメータと連結するには、パイプ（|）を使用します。

Bash
include:name='Engineering'|email:admin*

Bash
exclude:name='Engineering'|email:admin*

のみクエリを使用してください

クエリパラメータのみを使用するには、クエリの前にパイプ(|)を付けてください。

Bash
|memberKey=user@company.com

Directory Connectorがあなたのディレクトリに成功裏に接続し、希望のユーザーとグループを返すかどうかをテストするには、ダッシュボードタブに移動し、今すぐテストボタンを選択します。成功した場合、ユーザーとグループは、指定された同期オプションとフィルターに従って、ディレクトリコネクタウィンドウに表示されます。

一度同期オプションとフィルターが設定され、テストされたら、同期を開始できます。次の手順を完了して、ディレクトリコネクターとの自動同期を開始します:

1. ディレクトリコネクタデスクトップアプリを開いてください。

2. ダッシュボードタブに移動してください。

3. 同期セクションで、同期を開始ボタンを選択します。

   代わりに、一度だけの手動同期を実行するために今すぐ同期ボタンを選択することもできます。

Directory Connectorは、設定された同期オプションとフィルタに基づいて、あなたのディレクトリのポーリングを開始します。

アプリケーションを終了または閉じると、自動同期は停止します。Directory Connectorをバックグラウンドで実行し続けるには、アプリケーションを最小化するか、システムトレイに隠してください。