# スクリプト経由で認証する
これは **スクリプト経由のログイン** フローです。認証に、エージェントが実行、署名、または読み取りできるファイルが必要な場合に使用してください。たとえば、ログインスクリプト、クライアント証明書、またはログインを導く参照ドキュメントなどです。
**この機能を使用するのは、次の場合です：**
* あなたには **script** ログインを実行し、セッショントークン、Cookie、またはヘッダーを出力するものがあります。
* 認証は次を介して行います **クライアント証明書または署名付きリクエスト** (`.pem`, `.crt`, `.key`, `.p12`, `.pfx`, `.csr`, `.pub`).
* エージェントには **参照資料** が認証するために必要です（`.pdf`, `.md`, `.txt`, `.csv`, `.json`, `.yaml`, `.yml`）- 例：KYC書類、GraphQLの信頼済みドキュメント、またはアカウント一覧。
{% hint style="info" %}
Only `.py` ファイルは **実行されます** （Python 3、サンドボックス環境内）。その他のサポート対象ファイル形式はすべて、エージェントへの参照入力として提供されます。エージェントはそれらを読み取り、あなたの指示に従うために使用します。
{% endhint %}
### セットアップガイド
{% stepper %}
{% step %}
**テストユーザーを追加する**
評価ウィザードで、 **テストユーザーを追加** → **カスタム** → **スクリプト経由のログイン**.
{% endstep %}
{% step %}
**認証手順を記述**
Aikido は次をあらかじめ入力します **認証手順** フィールドに初期テンプレートを入れます：
エージェントがあなたのファイルに対して何をすべきかを正確に記述するよう編集してください。 **成功条件** の行は曖昧にしないでください。ログイン後ページ上の目に見える文字列や特定のステータスコードなどが適しており、エージェントが自分で確認できます。
{% endstep %}
{% step %}
**ファイル、キー、またはスクリプトをアップロード**
ファイルをアップロードボックスにドラッグ＆ドロップしてください。テストユーザーごとに1ファイルのみ。最大 **2 MB**；拡張子は上記のリストに限定されます。
Pythonスクリプトをアップロードする場合、エージェントは必要に応じてそれを調整し、 `python3`.
{% endstep %}
{% step %}
**保存してテスト**
クリックします **保存してテスト**で実行します。事前確認ではエージェントが起動し、あなたの指示に従って（スクリプトを実行するか、アップロードされたファイルを参照して）ログイン後の状態に到達することを確認します。事前確認が通れば、そのセッションは本番のペンテスト用にキャプチャされます。
{% endstep %}
{% endstepper %}
### ヒントとベストプラクティス
* **スクリプトは自己完結型にしてください。** 可能な限りPython 3の標準ライブラリのみを使用してください。 `pip install` の手順は実行時にありません。
* **証明書については、** 指示の中でファイル名とパスの規則を明記してください。例： *「アップロードされた `client.p12` を次のパスフレーズで `` 使って次へのリクエストに署名する `/api`."*
* **パスキー** はまだサポートされていません。この機能が必要でしたら、ご連絡ください。認識しておきます！