> For the complete documentation index, see [llms.txt](https://help.aikido.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aikido.dev/docs/docs-ja/pentesuto/configure-a-pentest/setting-up-authenticated-testing/agent-creates-new-account.md). # エージェントが新しいアカウントを作成する AikidoのPentestエージェントは、あなたが自然言語で提供する指示に基づいて、評価用に使い捨てのテストユーザーを自分で作成できます。事前にアカウントを作成して資格情報を共有する代わりに、新しいユーザーをどのように生成すべきかを記述すれば、スキャン開始前にエージェントが残りを処理します。 **この機能を使用するのは、次の場合です：** * 以下を実現したい場合： **複数ロールのカバレッジ** （例： `admin`, `編集者`, `閲覧者`）を、ロールごとに1アカウントずつ手動で作成せずに実現したい。 * あなたのアプリケーションには **サインアップフォーム** または **管理者/ユーザー作成API** をエージェントが呼び出せる。 * 以下を好む場合： **評価ごとに使い捨てアカウント** そのため、テストデータがステージング環境に蓄積しない。 {% hint style="info" %} この方法は、既知の **サインアップフローまたは管理者API**がある環境で最も効果的です。 [認証方法](/docs/docs-ja/pentesuto/configure-a-pentest/setting-up-authenticated-testing.md) のいずれかを使用し、アカウントは手動で作成してください。 {% endhint %} ### 仕組み 1. 〜の間に **事前チェック**、エージェントはあなたの **ユーザー作成指示** を読み取り、1つ以上のアカウントを作成します。サインアップフォーム、 `curl`形式のAPI呼び出し、または短いスクリプトの実行を使用できます。 2. Aikidoは、生成されたアカウントを、このジェネレーターに関連付けられた実際のテストユーザーとして保存します。元の「Test user generator」エントリはアーカイブされるため、スキャン自体には使用されません。 3. ある **2回目のプレフライト** を実行し、プロビジョニングされた各ユーザーで、あなたの **認証指示** （これらは `` と `` プレースホルダーを参照しています）。 4. プレフライトに失敗した場合、プロビジョニングされたユーザーは自動的にロールバックされ、ジェネレーターが復元されるので、指示を編集して再試行できます。 ### セットアップガイド {% stepper %} {% step %} **テストユーザーを追加する** 評価ウィザードで、 **テストユーザーを追加** → **カスタム** → **エージェントが新しいアカウントを作成する**. デフォルトでは、資格情報セットの名前は `Test user generator`です。必要であれば名前を変更してください。このラベルは参照用です。
Add Test User menu showing Custom > Agent Creates New Account
{% endstep %} {% step %} **ユーザーの作成方法を説明する** 次の **ユーザー作成指示** 欄で、エージェントがアカウントをどのように生成すべきかを自然言語で説明してください。以下を明確にしてください： * **場所** ユーザーを作成するためのもの（サインアップURL、または管理者エンドポイント）。 * **どのロールまたはバリアントを** 希望するか（例：閲覧者1人、編集者1人、管理者1人）。 * **必要なフィールド** （メールアドレス、パスワード、組織、テナントなど）。 * **トークンや管理者資格情報が必要な場合は** 、エージェントにそれを使用させてください。 **管理者APIを使用する例：** ``` 以下のロールについて、API経由で新しいユーザーを作成します： - 閲覧者 - 編集者 - 管理者 次のcurlリクエストを使用してください： curl -X POST https://staging.example.com/api/admin/users \\ -H "x-api-key: test-admin-key" \\ -H "Content-Type: application/json" \\ -d '{"email":"jane@example.com","password":"password","role":"editor"}' 必ず一意のメールアドレスと安全なパスワードを作成してください。 ``` **サインアップフォームを使用する例：** ``` https://staging.example.com/signup のサインアップフォームから、新しいアカウントを3つ作成します。 各アカウントについて： 1. 「Sign up」をクリックします。 2. 一意のメールアドレスと強力なパスワードを入力します。 3. フォームを送信し、必要なオンボーディング画面を完了します。 サインアップ時に該当するプランを選択して、ロールごと（閲覧者、編集者、管理者）に1アカウントずつ作成します。 ```
Authentication Set modal with User creation and Authentication instructions
{% endstep %} {% step %} **ログイン方法を説明する** 次の **認証手順** 欄で、 **ログインフロー** エージェントが作成したユーザーのためのものを説明してください。以下のプレースホルダーを使用してください： `` と `` （Aikidoは、プロビジョニングされた各ユーザーをテストする際に、これらを実際の資格情報に置き換えます）。 **例:** ``` 1. https://staging.example.com/login に移動します 2. ユーザー名を入力: 3. パスワードを入力: 4. 「Log In」をクリックします 成功条件：ログインが成功し、ダッシュボードが表示されること。 ``` 以下を明確に保ってください： **成功条件** を曖昧にしないでください。ログイン後ページに表示される文字列が適しています。 {% endstep %} {% step %} **保存してテスト** クリックします **保存してテスト**。プレフライトは2段階で実行されます： 1. エージェントがアカウントをプロビジョニングします。 2. エージェントが各新規アカウントでサインインし、セッションを取得します。 両方が成功した場合、評価設定内のジェネレーターは実際のテストユーザーに置き換えられます。これでスキャンを開始できます。 {% endstep %} {% endstepper %} ### ヒントとベストプラクティス * **専用の管理者トークンを使用してください** 作成ステップでは、実在ユーザーに紐づくトークンを再利用しないでください。 * **すべてのロールをカバーする** ことで、Aikidoが権限レベル間のBroken Access Controlをテストできます。 * **メールアドレスの一意性を明確にしてください：** 多くのアプリは重複サインアップを黙って拒否します。各アカウントごとに一意のメールアドレスを生成するようエージェントに依頼してください。 * **明確な成功条件を設定してください** 。ログイン手順における「ページが読み込まれる」のような曖昧な条件は、ユーザーが実際にはオンボーディング画面で止まっている場合でも通ってしまうことがあります。 * **自由に繰り返し調整してください。** プレフライトに失敗した場合は、指示を編集して **保存してテスト** 再度クリックできます。以前にプロビジョニングされたユーザーは自動的にアーカイブされます。 ### トラブルシューティング * **ユーザー作成に失敗しました：** APIまたはサインアップURLが次の場所から到達可能であることを確認してください： [AikidoのIPレンジ](/docs/docs-ja/pentesuto/prepare-a-pentest/ip-addresses-for-pentest.md)、また指示内の管理者トークンがまだ有効であることも確認してください。 `curl` リクエストまたはサインアップフォームを手動で確認し、手順が正しいことを確かめてください。 * **2回目のプレフライトでログインに失敗します：** 認証手順の成功条件をより厳密にするか、新規作成アカウントに表示される追加手順（メール認証、オンボーディングモーダル、MFA）を含めてください。新しいユーザーがメール確認を行う必要がある場合は、この方法を次のものと組み合わせてください： [メール確認フロー](/docs/docs-ja/pentesuto/configure-a-pentest/setting-up-authenticated-testing/handling-email-verification-and-magic-links.md). * **誤ったロールが割り当てられています：** 各ユーザーにどのロールを割り当てるべきかを、作成指示で明確にしてください。APIがデフォルトのロールを選ぶ場合は、リクエスト本文で上書きしてください。 ### ヘルプが必要ですか？ を開き、 **Intercomチャット** Aikidoダッシュボードの右下隅にあります。私たちのチームが、あなたのスタックで動作する作成およびログイン指示の作成をお手伝いできます。 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://help.aikido.dev/docs/docs-ja/pentesuto/configure-a-pentest/setting-up-authenticated-testing/agent-creates-new-account.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.