# メール認証とマジックリンクの処理

Aikido はホスト型のメール受信箱を提供しており、AI Pentest エージェントがメールでのやり取りを必要とする認証フローを通過できるようにします。

**アプリケーションで以下が必要な場合は、この機能を使用してください：**

* **マジックリンク：** メールのリンクによるパスワードレスログイン。
* **メール MFA：** コードが受信箱に送信される二要素認証。
* **アカウント認証：** 新規ユーザーはログイン前にメールアドレスを認証する必要があります。

{% hint style="info" %}
アプリで認証アプリを使用している場合は、[TOTP 設定](https://help.aikidogov.us/docs/docs-ja/pentests/configure-a-pentest/setting-up-authenticated-testing/handling-two-factor-authentication-totp)を使用してください。

アプリで SMS コードを使用している場合は、[SMS 認証](https://help.aikidogov.us/docs/docs-ja/pentests/configure-a-pentest/setting-up-authenticated-testing/handling-sms-verification)を使用してください。
{% endhint %}

### 仕組み

Aikido 内で固有の `@auto-pentest.com` メールアドレスを生成します。このアドレスは橋渡しの役割を果たします：

1. **あなた**は、このアドレスを使用してアプリケーションで有効なユーザーアカウントを作成し、認証します。
2. **エージェント**は、スキャン中にこの受信箱を監視し、リアルタイムでログインコードを取得したりマジックリンクをクリックしたりします。

### セットアップガイド

{% stepper %}
{% step %}
**Aikido にメールアドレスを作成させる**

**Authentication Set** モーダルで：

1. **Email Inbox** セクションまでスクロールします。
2. `+ Generate Email Address` をクリックします。
3. アドレス（例：`random-name@auto-pentest.com`）をコピーします。

<div data-with-frame="true"><figure><img src="https://help.aikidogov.us/_assets/b3b6cbf1ea64/Screenshot-2025-12-10-at-18.26.57-1.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**アプリケーションでテストユーザーを作成する**

アプリケーションにアクセスし、作成したばかりのアドレスを使用して新しいユーザーを登録します。
{% endstep %}

{% step %}
**アカウントを認証する（必要な場合）**

アプリが登録時に「メールアドレスを確認してください」というリンクを送信する場合：

1. Aikido のモーダルに戻ります。
2. **Open Inbox** アイコンをクリックします（またはメールアドレス自体をクリックします）。
3. アプリからの確認メールが表示されます。
4. メールを開き、確認リンク/ボタンをクリックしてユーザーを有効化します。

<div data-with-frame="true"><figure><img src="https://help.aikidogov.us/_assets/ddde52dd020e/Screenshot-2025-12-10-at-18.10.23.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Aikido でログインロジックを更新する**

**Login Logic** テキストエリアで、この受信箱を確認するようエージェントに明示的に指示する必要があります。

**マジックリンクの指示例：**

```
1. Navigate to https://app.example.com/login
2. Enter email: [insert the created email here]
3. Click "Send Magic Link"
4. Check the inbox for the login email and click the link inside.
```

**メール MFA の指示例：**

```
1. Navigate to https://app.example.com/login
2. Enter username and password.
3. When prompted for the code, check the inbox.
4. Extract the 6-digit code from the latest email.
5. Enter the code into the verification field and submit.
```

<div data-with-frame="true"><figure><img src="https://help.aikidogov.us/_assets/a2c1f78f7022/Screenshot-2025-12-10-at-18.31.49-1.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**設定をテストする**

最後に、エージェントが指示を解釈できることを確認します：

1. **Save & Test** をクリックします。
2. エージェントがブラウザセッションを起動し、認証情報と受信箱の指示を使用してログインを試みます。
3. 成功すると、エージェントが認証され、ログイン後の状態に到達したことを示す確認が表示されます。

<div data-with-frame="true"><figure><img src="https://help.aikidogov.us/_assets/c35fd892eee3/Screenshot-2025-12-10-at-18.36.04.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}
