# SMS認証の処理

Aikidoは、認証セット専用の電話番号をプロビジョニングすることで、認証付きペンテストにおけるSMSベースの認証をサポートしています。

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

* **SMS 2FA / MFA:** ユーザー名/パスワードの入力後に、テキストメッセージのコードが必要です。

{% hint style="info" %}
電話番号の作成は無料で、クレジットは差し引かれませんが、不正利用を防ぐための残高チェックとして、Aikidoウォレットに少なくとも500クレジットの残高が必要です。\
アプリで認証アプリを使用している場合は、[TOTPセットアップ](https://help.aikido.dev/docs/docs-ja/pentests/configure-a-pentest/setting-up-authenticated-testing/handling-two-factor-authentication-totp)を使用してください。

アプリがメールでコードを送信する場合は、[メール認証機能](https://help.aikido.dev/docs/docs-ja/pentests/configure-a-pentest/setting-up-authenticated-testing/handling-email-verification-and-magic-links)を使用してください。
{% endhint %}

#### 仕組み

**Test User**モーダルで、Aikidoはプロジェクト用の電話番号を作成できます。その番号をログインフローで使用し、`<phone_number>`プレースホルダーを使って手順に含めます。

**View Messages**をいつでも開いて、受信したSMSメッセージを確認し、検出された認証コードをすばやくコピーできます。

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

{% stepper %}
{% step %}
**SMS認証方式を選択する**

テストユーザーを追加する際に、**Username & Password + SMS Verification**を選択します。
{% endstep %}

{% step %}
**電話番号を作成する**

**SMS Phone Number**セクションで:

1. **Create Phone Number**をクリックします。
2. 生成された番号をコピーします。

<div data-with-frame="true"><figure><img src="https://help.aikido.dev/_assets/84612d9a8932/Screenshot-2026-03-04-at-13.03.10-1.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**アプリで番号を使用する**

SMS認証コードが生成された番号に送信されるよう、テストユーザーを設定します。
{% endstep %}

{% step %}
**認証手順を更新する**

明確なステップごとの手順を使用し、必要に応じて`<phone_number>`を含めてください。

**手順の例:**

```
1. Navigate to https://app.example.com/login
2. Enter username: pentest_user
3. Enter password: super_secure_password
4. Click "Log In"
5. Wait for an SMS verification code sent to +1234567890
6. Enter the SMS code and click "Verify"
```
{% endstep %}

{% step %}
**受信メッセージを確認する**

**View Messages**をクリックしてSMS受信トレイを開きます:

* メッセージはリアルタイムで表示されます。
* 数字のコードが検出された場合は、**Copy Code**を使用してすばやく入力/テストできます。

<div data-with-frame="true"><figure><img src="https://help.aikido.dev/_assets/839c81a3f3c5/Screenshot-2026-03-04-at-13.06.38.png" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

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

1. **Save & Test**をクリックします。
2. エージェントがSMS認証ステップを含むログインフローを実行します。
3. 認証済みの状態に到達したことを確認します。
{% endstep %}
{% endstepper %}

#### トラブルシューティング

* **SMSが届かない:** アプリが生成された番号に正確にコードを送信していること、およびテストユーザーのプロフィールが更新されていることを確認してください。
* **プレースホルダーが置換されない:** 手順内では正確なトークン`<phone_number>`を使用してください。
* **電話番号を作成できない:** ウォレットの残高を確認してください。電話番号の作成は無料ですが、不正利用を防ぐため、ウォレットに十分なクレジットが必要です。