> 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/handling-email-verification-and-magic-links.md).
# メール認証とマジックリンクの処理
Aikido はホスト型のメール受信箱を提供し、AI Pentest エージェントがメール操作を必要とする認証フローを進められるようにします。
**アプリケーションに次が必要な場合は、この機能を使用してください:**
* **マジックリンク:** メールリンクによるパスワードレスログイン。
* **メール MFA:** コードが受信箱に送信される二要素認証。
* **アカウント確認:** 新規ユーザーは、ログイン前にメールアドレスを確認する必要があります。
{% hint style="info" %}
アプリが認証アプリを使用している場合は、 [TOTP の設定](/docs/docs-ja/pentesuto/configure-a-pentest/setting-up-authenticated-testing/handling-two-factor-authentication-totp.md).
アプリがSMSコードを使用する場合は、 [SMS認証](/docs/docs-ja/pentesuto/configure-a-pentest/setting-up-authenticated-testing/handling-sms-verification.md).
{% endhint %}
### 仕組み
一意の `@auto-pentest.com` メールアドレスを Aikido 内で生成します。このアドレスは橋渡しとして機能します:
1. **あなたは** これを使って、アプリケーション内で有効なユーザーアカウントを作成し、確認します。
2. **エージェントは** スキャン中にこの受信箱を監視し、ログインコードを取得したり、マジックリンクをリアルタイムでクリックしたりします。
### セットアップガイド
{% stepper %}
{% step %}
**Aikido にメールアドレスの作成を任せる**
で **認証セット** モーダル：
1. 次の項目までスクロールしてください **メール受信箱** セクションから選択します。
2. クリック `+ メールアドレスを生成`.
3. アドレスをコピーする（例: `random-name@auto-pentest.com`).
{% endstep %}
{% step %}
**アプリケーションでテストユーザーを作成する**
アプリケーションに移動し、今作成したアドレスを使って新しいユーザーを登録してください。
{% endstep %}
{% step %}
**アカウントを確認する（必要な場合）**
アプリがサインアップ時に「メールアドレスを確認してください」リンクを送信する場合:
1. Aikido のモーダルに戻ります。
2. クリックしてください **受信箱を開く** アイコン（またはメールアドレス自体をクリック）を使います。
3. アプリからの確認メールが表示されます。
4. それを開き、確認リンク/ボタンをクリックしてユーザーを有効化します。
{% endstep %}
{% step %}
**Aikido でログインロジックを更新する**
エージェントに、この受信箱をチェックするよう明示的に指示する必要があります。 **ログインロジック** テキスト領域で。
**マジックリンクの指示例:**
```
1. https://app.example.com/login にアクセスする
2. メールを入力: [ここに作成したメールアドレスを挿入]
3. 「マジックリンクを送信」をクリック
4. 受信箱でログインメールを確認し、その中のリンクをクリックします。
```
**メール MFA の指示例:**
```
1. https://app.example.com/login にアクセスする
2. ユーザー名とパスワードを入力。
3. コードの入力を求められたら、受信箱を確認します。
4. 最新のメールから 6 桁のコードを抽出します。
5. コードを確認欄に入力して送信します。
```
{% endstep %}
{% step %}
**設定をテストする**
最後に、エージェントがあなたの指示を解釈できることを確認します:
1. クリック **保存してテスト**.
2. エージェントはブラウザセッションを起動し、認証情報と受信箱の指示を使ってログインを試みます。
3. 成功すると、エージェントが認証され、ログイン後の状態に到達したことを示す確認が表示されます。
{% endstep %}
{% endstepper %}
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.aikido.dev/docs/docs-ja/pentesuto/configure-a-pentest/setting-up-authenticated-testing/handling-email-verification-and-magic-links.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.