管理者コンソールユーザー管理

Oktaと同期

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

Okta APIトークンを作成します

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

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

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

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

    warning

    Your token value will not be shown again. Paste it somewhere safe to prevent it from being lost.

あなたのディレクトリに接続してください

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

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

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

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

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

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

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

同期オプションを設定する

tip

When you're finished configuring, navigate to the More tab and select the Clear Sync Cache button to prevent potential conflicts with prior sync operations. For more information, see Clear Sync Cache.

次の手順を完了して、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"

グループフィルター

note

Syncing nested groups is not supported by Okta.

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

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

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"

接続をテストする

tip

同期をテストまたは実行する前に、Directory Connector が正しいクラウドサーバー(例:US または EU)、あるいは自己ホスト型サーバーに接続されていることを確認します。デスクトップアプリまたは CLI を使用して、方法を確認します。

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

Test sync results
Test sync results

自動同期を開始します

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

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

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

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

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

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

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

note

Teams Starter プランの場合、メンバーは10人に制限されます。10人以上のメンバーを同期しようとすると、Directory Connector はエラーを表示して同期を停止します。

このページの変更を提案する

どうすればこのページを改善できますか?
技術、請求、製品に関するご質問は、サポートまでお問い合わせください。