スクリプトによる認証
これはLogin via Scriptフローです。認証にエージェントが実行・署名・読み取りできるファイル(ログインスクリプト、クライアント証明書、ログインの流れを規定する参照ドキュメントなど)が必要な場合に使用します。
この機能を使用するケース:
- ログインを実行し、セッショントークン、Cookie、ヘッダーを発行するスクリプトを持っている場合。
- クライアント証明書または署名付きリクエスト(
.pem、.crt、.key、.p12、.pfx、.csr、.pub)で認証する場合。 - エージェントが認証のために参照資料(
.pdf、.md、.txt、.csv、.json、.yaml、.yml)を必要とする場合 - 例えばKYC文書、GraphQLのtrusted document、アカウント一覧など。
セットアップガイド
Section titled “セットアップガイド”1. Test Userを追加する
Section titled “1. Test Userを追加する”アセスメントウィザードで、Add Test User → Custom → Login via Scriptをクリックします。

2. 認証手順を記述する
Section titled “2. 認証手順を記述する”AikidoはAuthentication Instructionsフィールドに初期テンプレートをあらかじめ入力します。
エージェントがファイルを使って何をすべきかを正確に記述するように編集してください。**Success criteria(成功基準)**の行は曖昧にしないでください - ログイン後ページに表示される文字列や特定のステータスコードを指定すると、エージェントが自己検証しやすくなります。
3. ファイル、鍵、スクリプトをアップロードする
Section titled “3. ファイル、鍵、スクリプトをアップロードする”アップロードボックスにファイルをドロップします。テストユーザーごとに1ファイルのみ、最大2MB、拡張子は上記のリストに限定されます。
Pythonスクリプトをアップロードする場合、エージェントは必要に応じてそれを調整し、python3で実行します。

4. 保存してテストする
Section titled “4. 保存してテストする”Save & Testをクリックします。プリフライトがエージェントを起動し、指示に従って(スクリプトを実行する、またはアップロードされたファイルを参照する)、ログイン後の状態に到達したことを確認します。プリフライトが成功すると、セッションはメインのペンテスト用にキャプチャされます。

ヒントとベストプラクティス
Section titled “ヒントとベストプラクティス”- スクリプトは自己完結型にしてください。 可能な限りPython3の標準ライブラリのみを使用してください - 実行時に
pip installのステップはありません。 - **証明書の場合、**ファイル名とパスの規則を指示に明記してください - 例:「
/apiへのリクエストに署名するために、パスフレーズ<password>でアップロード済みのclient.p12を使用してください。」 - パスキーはまだサポートされていません。この機能が必要な場合は、認識できるようにお問い合わせください。