日本語

aikidoctl CLI

aikidoctl は、Aikido Device Protection に同梱されているコマンドラインのヘルプツールです。問題が発生した際に、エージェントの確認、制御、トラブルシューティングを行うためのユーティリティを提供します。

使用方法

aikidoctl [global options] command [command options]

aikidoctl help（または aikidoctl <command> --help）を実行すると、いつでも利用可能なコマンドとオプションの一覧を表示できます。Windows では aikidoctl.exe を使用してください。

コマンド

すべてのコマンドがすべてのプラットフォームで利用できるわけではありません。利用できないプラットフォーム列には、そのコマンドが提供されていないプラットフォームが記載されています。空欄の場合は、すべてのプラットフォームで動作します。

コマンド利用できないプラットフォーム説明
certsWindows, LinuxCA 証明書を管理します。
certconfigツールごとの証明書信頼設定（node、git、java など）を管理します。
pause指定した期間、Aikido Device Protection を一時停止します。一時停止中は、デバイス上のすべての保護が完全に無効になります。
unpause一時停止中の Aikido Device Protection を再開します。
sbomLinuxソフトウェア部品表（SBOM）の収集状況を確認します。
secretscanningWindows, Linuxデバイス上のシークレットスキャンを確認します。
device-identitymacOS, Linuxデバイスが登録に使用する ID を表示またはリセットします。VM のクローンまたはスナップショットから作成したマシンでは device-identity reset を実行してください。クローンした VM とイメージを参照してください。
diagnostics

診断情報を収集して Aikido に送信します。

diagnostics コマンドは、アプリ内の Report A Problem フローに相当するコマンドラインの機能です。診断情報を Aikido に送信するタイミングと方法については、問題の報告 / Device Protection サポートを参照してください。

request管理者の承認待ちでブロックされているパッケージを一覧表示し、aikidoctl request でそのリクエストを送信します。コマンドラインからブロックされたインストールをリクエストするを参照してください。
restart-daemonLinuxAikido Device Protection デーモンを再起動します。
versionインストールされている Device Protection のバージョン、ビルドの詳細、サービスの状態を表示します。
help, hコマンドの一覧、または特定のコマンドのヘルプを表示します。

Aikido が構築する証明書バンドルに組織独自の CA を追加する方法については、カスタム CA 証明書の追加を参照してください。

クローンした VM とイメージ

デバイスの ID は、エージェントが初めて登録されたときに作成されます。VM に Device Protection をインストールした後にその VM をクローンまたはスナップショット化すると、そこから作成されたすべてのマシンが同じ ID を持つことになります。その結果、それらはすべてデバイス一覧で 1 つのエントリにまとめられ、1 台を除くすべてのマシンが見えなくなります。

Windows では、クローンまたはスナップショットをデプロイした後に次の手順を実行します。

  1. マシンに固有のホスト名を付けます。
  2. デバイス ID をリセットします。
aikidoctl.exe device-identity reset

これにより、マシンは次回のチェックイン時に独立したデバイスとして登録されます。デバイス一覧に古い共有エントリがすでに存在する場合は、それを削除してください。

Linux では、デバイス ID は代わりに /etc/machine-id に基づきます。イメージビルドの最後の手順としてこのファイルを空にしておくと、各マシンが初回起動時に独自の ID を生成します。

グローバルオプション

オプション説明
--simpleスクリプト用に、インストールされている Device Protection のバージョンのみを出力します。
--help, -hヘルプを表示します。
--version, -vバージョンを出力します。