ディレクトリコネクタCLI

ディレクトリコネクタCLIは、デスクトップGUIが利用できない環境や、オペレーティングシステムが提供するツール（cron job、スケジュールタスクなど）を使用してディレクトリの同期操作をプログラム的にスクリプト化したい場合に適しています。ディレクトリコネクタCLIは、Windows、macOS、Linuxディストリビューションでクロスプラットフォームで使用することができます。

Bitwarden Directory Connector CLIを使用するための開始方法：

1. 次のリンクのいずれかからCLIをダウンロードしてください:

   • Windows CLI

   • macOS CLI

   • Linux CLI

2. .zip を解凍し、その内容（ bwdc と keytar.node ）を /usr/local/bin またはあなたの $PATH 内の別のディレクトリに移動してください。メモしてください、 keytar.node は、主要なbwdc実行可能ファイルと同じディレクトリに なければなりません 。

   Linuxのみ：まだインストールされていない場合は、選択したパッケージ管理で libsecret をインストールしてください：

   Bashコピー
   apt-get install libsecret-1-0
   brew install libsecret

   Windowsのみ： Windowsユーザーは、現在のユーザーのPATHにbwdc.exeを追加できます。

3. 以下のコマンドを実行して、ターミナルで bwdc コマンドが動作することを確認してください。

   Bashコピー
   bwdc --help

4. ディレクトリコネクタをあなたのディレクトリに bwdc config コマンドを使用して接続します（ここを参照）。

5. あなたの data.json ファイルを編集して同期オプションを設定します（詳細については、ディレクトリコネクターファイルストレージを参照してください）。あなたの データ.json ファイルの絶対パスを取得するために、 bwdc データ-ファイル コマンドを使用してください。

   利用中のディレクトリタイプによって利用可能な同期オプションが異なるため、以下の記事のいずれかを参照して、ご利用いただけるオプションのリストをご覧ください:

   • Active DirectoryまたはLDAPと同期

   • Azure Active Directoryと同期

   • G Suite（Google）と同期

   • Oktaと同期

   • OneLoginと同期

6. bwdc テスト コマンドを実行して、設定が期待される結果を同期するかどうかを確認します。

7. あなたのディレクトリと同期オプションが適切に設定され、 bwdc test が期待通りの結果をもたらしたら、 bwdc 同期 コマンドを実行してライブ同期操作を開始します。

ログイン コマンドを使用して、あなたの組甽APIキーでDirectory Connectorにログインします。APIキーがない場合は、組織の所有者に連絡してください。 ログイン コマンドを使用する方法はいくつかあります：

• それ自体で：

  Bashコピー
  bwdc login

  bwdc ログイン を単独で渡すと、その後で client_id と client_secret を入力するように求められます。

• パラメーターで：

  Bashコピー
  bwdc login organization.b5351047-89b6-820f-ad21016b6222 yUMB4trbqV1bavhEHGqbuGpz4AlHm9

• 保存された環境変数を使用して：

  Bashコピー
  BW_CLIENTID="organization.b5351047-89b6-820f-ad21016b6222"
  BW_CLIENTSECRET="yUMB4trbqV1bavhEHGqbuGpz4AlHm9"
  
  bwdc login

  環境変数 BW_CLIENTID と BW_CLIENTSECRET を保存することで、 bwdc ログイン だけを使用してDirectory Connectorにログインできます。これは、それらの変数をチェックし、存在する場合はそれらを使用します。

  これらの環境変数が存在しない場合、あなたの client_id と client_secret を入力するように求められます。

ディレクトリコネクタCLIからログアウトするには、 logout コマンドを使用してください。

Bashコピー
bwdc logout

Bitwarden Directory Connector CLIは、すべてのコマンドに対する --help コンテンツと例で自己文書化されています。すべての利用可能なコマンドをグローバル --help オプションを使用してリストします:

Bashコピー
bwdc --help

特定のコマンドについて詳しく知りたい場合は、そのコマンドに --help オプションを使用してください。

Bashコピー
bwdc test --help
bwdc config --help

「 テスト 」コマンドは、あなたのディレクトリを問い合わせ、実際の同期操作を実行するたびにBitwarden組織に同期されるグループとユーザーのJSON形式の配列を出力します。

Bashコピー
bwdc test

最後の成功した同期以降の変更のみをテストするには、 --last オプションを使用してください。

Bashコピー
bwdc test --last

同期 コマンドはライブ同期操作を実行し、データをあなたのBitwarden組織にプッシュします。

Bashコピー
bwdc sync

同期されたユーザーとグループは、あなたのBitwarden組織で直ちに利用可能になります。新たに追加されたユーザーは、あなたの組織へのメールアドレスで招待を受け取ります。

last-sync コマンドは、ユーザーまたはISO 8601タイムスタンプを返します。これは、最後に実行されたユーザーまたはグループの同期操作のためのものです。コマンドを実行するための として、 ユーザー またはグループ のいずれかを指定する必要があります。

Bashコピー
bwdc last-sync <object>

指定されたオブジェクトに対して同期が実行されていない場合、空の応答を返します。

「 config 」コマンドを使用すると、ディレクトリの設定を指定できます。

Bashコピー
bwdc config <setting> <value>

利用可能なオプションは次のとおりです：

ディレクトリタイプの 値

データファイル コマンドは、Directory Connector CLIが使用する データ.json 設定ファイルへの絶対パスを返します。

Bashコピー
bwdc data-file

ディレクトリコネクタCLIの一部の設定は、お気に入りのテキストエディタで直接 data.json 設定ファイルを編集することで変更できますが、 ldap.password 、 azure.key 、 gsuite.key 、 okta.token 、および onelogin.secret は、CLIを使用してのみconfigから、またはデスクトップアプリから変更できます。

clear-cache コマンドは、アプリケーションが同期操作を実行する際に保存するキャッシュデータをクリアすることができます。詳細については、同期キャッシュのクリアをご覧ください。

Bashコピー
bwdc clear-cache

更新 コマンドを使用すると、Directory Connector CLIが最新のものであるかどうかを確認できます:

Bashコピー
bwdc update

新しいバージョンが見つかった場合、コマンドは新しいバージョンをダウンロードするためのURLを返します。ディレクトリコネクタCLIは自動的に更新されません。このURLを使用して新しいバージョンを手動でダウンロードする必要があります。

libsecret共有オブジェクトに関するエラーメッセージ エラー: libsecret-1.so.0: 共有オブジェクトファイルを開くことができません: そのようなファイルやディレクトリはありません を受け取った場合、ホストで安全に物を保存するために必要なlibsecretをインストールする必要があるかもしれません。

bwdc config を使用している際にdbusに関するエラーメッセージを受け取った場合、例えば 子プロセス "dbus-launch" の実行に失敗しました（そのようなファイルやディレクトリはありません） または X11なしでD-Busを自動起動することはできません 、次の環境変数を割り当てて data.json 内に秘密情報をプレーンテキストで保存できるようにします：

Bashコピー
export BITWARDENCLI_CONNECTOR_PLAINTEXT_SECRETS=true

ローカル発行者証明書を取得できません というエラーメッセージが表示された場合、 NODE_EXTRA_CA_CERTS 変数をあなたの root.pem に設定します。例えば：

Bashコピー
export NODE_EXTRA_CA_CERTS="absolute/path/to/your/certificates.pem"

デスクトップアプリを使用している場合、次のエラーとして表示されることもあります： 警告：NODE_TLS_REJECT_UNAUTHORIZED環境変数を'0'に設定すると、証明書の検証を無効にすることでTLS接続とHTTPSリクエストが安全でなくなります。

あなたがプライベートキーを設定しているときにエラー パス"/org/freedesktop/secrets/collection/login"にオブジェクトが存在しません を受け取っている場合、問題を修正するための次の手順を参照してください。

BitwardenディレクトリコネクタはLinuxのキーリングを使用します、次の依存関係がインストールされていることを確認してください:

Bashコピー
sudo apt install dbus-x11 gnome-keyring

次に、以下のコマンドを実行してデーモンを開始します:

Bashコピー
export $(dbus-launch)
dbus-launch
gnome-keyring-daemon --start --daemonize --components=secrets
echo '<RANDOM-PASSPHRASE>' | gnome-keyring-daemon -r -d --unlock

これらのコマンドに従って、たとえば、再度キーを実行してみてください。

Bashコピー
bwdc config gsuite.key /path/to/key/