# 二要素認証（TOTP）の処理
Aikido の AI エージェントは、有効な時間ベースのワンタイムパスワード（TOTP）を生成し、認証済みスキャン中に 2FA 画面を突破できます。
**アプリケーションで次のものが必要な場合は、この機能を使用してください：**
* **認証アプリ：** ログインフローで、Google Authenticator、Authy、1Password などの 6 桁のコードを求められる場合。
{% hint style="info" %}
アプリがメールでコードを送信する場合は、[メール認証機能](https://help.aikido.dev/docs/docs-ja/pentests/configure-a-pentest/setting-up-authenticated-testing/handling-email-verification-and-magic-links)を使用してください。
アプリが SMS コードを使用する場合は、[SMS 認証](https://help.aikido.dev/docs/docs-ja/pentests/configure-a-pentest/setting-up-authenticated-testing/handling-sms-verification)を使用してください。
{% endhint %}
### 仕組み
スマートフォンで QR コードをスキャンする代わりに、アプリケーションから生の**シークレットキー**（または `otpauth://` URI）を取得し、Aikido に貼り付けます。エージェントはこのシークレットを使用して、スキャン中に有効なコードをその場で数学的に生成します。
### セットアップガイド
{% stepper %}
{% step %}
**シークレットキーを見つける**
対象アプリケーションの 2FA 設定画面（通常 QR コードをスキャンする画面）に移動します。
1. **「QR コードをスキャンできませんか？」**、**「スキャンできない場合」**、または**「セットアップキーを表示」**などのテキストリンクを探します。
2. それをクリックして、生のテキストコード（シークレットキー）を表示します。
3. この文字列をコピーします（例：`4IKIDOI5AW35OME`）。
{% endstep %}
{% step %}
**Aikido を設定する**
Aikido の**認証セット**モーダルで：
1. **TOTP 設定**セクションまでスクロールします。
2. シークレットキー（または完全な `otpauth://` URI）を入力フィールドに貼り付けます。
3. システムが形式を即座に検証します。
{% endstep %}
{% step %}
**ログインロジックを更新する**
エージェントにコードを入力するタイミングを明示的に指示する必要があります。
**指示の例：**
```
1. Navigate to https://app.example.com/login
2. Enter username: admin
3. Enter password: abc123
4. Click "Log In"
5. When the 2FA screen appears, generate a TOTP code and enter it into the verification field.
6. Click "Verify"
```
{% endstep %}
{% step %}
**設定をテストする**
エージェントがコードを正しく生成・入力できることを確認します：
1. **Save & Test** をクリックします。
2. エージェントがブラウザセッションを起動します。
3. 再生ログを確認し、エージェントが 2FA プロンプトを突破してダッシュボードに到達したことを確かめます。
{% endstep %}
{% endstepper %}
