Oktaと同期

この記事は、OktaディレクトリからBitwarden組織へのユーザーとグループの同期を開始するためのDirectory Connectorの使用方法を説明します。

ディレクトリコネクタは、ディレクトリに接続するためにOktaが生成したトークンの知識が必要です。次の手順を完了して、Directory Connectorで使用するためのOkta APIトークンを作成および取得します:

1. あなたのOkta Developer Console（https://yourdomain-admin.okta.com）からセキュリティ → API → トークンに移動してください。

2. トークンを作成ボタンを選択し、トークンにBitwarden専用の名前を付けてください（例えば、bitwarden-dc）。

3. 生成されたトークン値をクリップボードにコピーしてください。

   注意

   あなたのトークンの値は再度表示されません。それが失われるのを防ぐために、安全な場所に貼り付けてください。

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

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

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

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

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

4. あなたのOkta組織のURLを組織URLフィールドに入力してください（例：https://yourdomain.okta.com）。

5. APIトークンの値をトークンフィールドに貼り付けてください。

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

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

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

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

ユーザーのメールアドレスまたはグループ名に基づいて含めるか除外するために、カンマ区切りのリストを使用してください。さらに、Okta APIは、ディレクトリコネクタのフィルタフィールドで使用される可能性があるユーザーとグループのための限定的なフィルタリング機能を提供します。

フィルターパラメータの使用に関する詳細情報は、Oktaのドキュメンテーションを参照してください。ユーザーとグループについてです。

ユーザーフィルター

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

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

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

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

フィルターと連結する

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

Bash
include:john@example.com,bill@example.com|profile.firstName eq "John"

Bash
exclude:john@example.com,bill@example.com|profile.firstName eq "John"

のみフィルターを使用してください

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

Bash
|profile.lastName eq "Smith"

グループフィルター

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

名前でグループを含めるか除外する：

Bash
include:Group A,Group B

Bash
exclude:Group A,Group B

フィルターと連結する

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

Bash
include:Group A|type eq "APP_GROUP"

Bash
exclude:Group A|type eq "APP_GROUP"

のみフィルターを使用してください

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

Bash
|type eq "BUILT_IN"

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

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

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

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

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

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

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

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