> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# CAPTCHA ログインを設定する

> Pentest のパスワードログイン用に CAPTCHA を設定し、チャレンジでアクセスできない場合のテスト範囲を確認します。

[Pentest](/ja/guide/security/pentest) のテストアカウントがログイン時に CAPTCHA を要求される場合に設定します。アカウントの保存だけでは、保護されたページへのアクセスを証明できません。

## 前提条件

* 登録済みの Pentest アプリと、テストユーザーの編集権限。
* **Password** 認証を使う専用のテストアカウント。
* テストキーを使う場合は、テスト対象の CAPTCHA 設定へのアクセス。
* 自動フォールバックを使う場合は、管理者による機能の有効化と必要なソルバーの設定。

## ログインを設定する

<Steps>
  <Step title="パスワードアカウントを開く">
    アプリの **Settings → Test users** で **Add test user** または **Add authentication** を開きます。**Password** を選び、アカウント情報を入力します。

    必要に応じて **Login URL (optional)** を入力します。ログインページは保存済みの対象と範囲内にある必要があります。**CAPTCHA options (optional)** を展開します。
  </Step>

  <Step title="CAPTCHA オプションを選ぶ">
    対象側の例外を用意していない場合、**Customer bypass** は **None** にします。テスト環境にテストキーを設定済みの場合は **Target test keys** を選びます。

    **CAPTCHA provider** を選び、対象に設定済みの公開 sitekey を **Installed test sitekey** に入力します。検証用の secret はアプリのサーバーに保持します。

    **Automated fallback** で **Allow for this identity** または **Disable for this identity** を選びます。インストール全体で無効な機能は、ここで許可しても有効になりません。

    <Frame>
      <img src="https://mintcdn.com/cloudthinker/TxXX1MnlWP2dTEtM/images/security/cyber/14-captcha-options.png?fit=max&auto=format&n=TxXX1MnlWP2dTEtM&q=85&s=cb3e03b396f34f5955a86fc8121307fd" alt="パスワードアカウントのバイパスと自動フォールバック設定。" width="992" height="408" data-path="images/security/cyber/14-captcha-options.png" />
    </Frame>

    <p style={{textAlign: 'center', fontSize: '0.9em', color: '#666', marginTop: '8px'}}>パスワードアカウントの CAPTCHA オプション。</p>
  </Step>

  <Step title="保存して実行結果を確認する">
    **Save login** をクリックし、オンデマンドの pentest を開始します。保護されたページをテスト済みと判断する前に、認証結果を読みます。

    **成功状態:** 実行がログイン後のアクセスを証明し、匿名アクセスの拒否を確認します。アカウント保存や CAPTCHA の完了だけでは不十分です。

    CAPTCHA が未解決なら認証後のテストはできません。設定を修正するか、検証済みの **Session token** を追加してから再実行します。
  </Step>
</Steps>

## 対象側の例外を選ぶ

| Customer bypass | 必要な条件 |
| - | - |
| **None** | 対象側の例外なし。有効なフォールバックがチャレンジを試行できます |
| **Bypass header** | 対象が専用ヘッダーと secret を検証して CAPTCHA を省略すること。パスワードは必要です。保護された認証情報の設定を管理者に依頼します |
| **Target test keys** | ウィジェットとサーバー検証で対応するテストキーを使い、公開 sitekey を CloudThinker に入力すること |

Bypass header のフォームには **Header name** と **Bypass secret** が表示されます。保存が拒否される場合、管理者に保護された設定を依頼するか、検証済みのセッションを使います。

### プロバイダーのテストキー

| プロバイダー | テスト時の注意 |
| - | - |
| **reCAPTCHA v2** | Google のテストキーペアはチャレンジを省略し、検証に成功します。[reCAPTCHA FAQ](https://developers.google.com/recaptcha/docs/faq) を参照してください |
| **reCAPTCHA v3** | テスト専用キーを使います。スコアは実際の通信と異なる場合があり、ログイン成功を保証しません。[Google FAQ](https://developers.google.com/recaptcha/docs/faq) を参照してください |
| **hCaptcha** | テスト sitekey の応答には対応する test secret が必要です。[hCaptcha テストキー](https://docs.hcaptcha.com/#integration-testing-test-keys) を参照してください |
| **Cloudflare Turnstile** | dummy sitekey と対応する test secret を使います。本番 secret はテスト応答を拒否します。[Turnstile テスト](https://developers.cloudflare.com/turnstile/troubleshooting/testing/) を参照してください |

<Warning>
  テストキーはテスト環境だけで使います。ボット対策を無効にする場合があるため、pentest のために本番の保護を置き換えないでください。
</Warning>

<Frame>
  <img src="https://mintcdn.com/cloudthinker/TxXX1MnlWP2dTEtM/images/security/cyber/15-captcha-test-keys.png?fit=max&auto=format&n=TxXX1MnlWP2dTEtM&q=85&s=91e41f1108a31fb60faa38688dfdfb02" alt="CAPTCHA プロバイダーと設定済みの公開 test sitekey。" width="992" height="776" data-path="images/security/cyber/15-captcha-test-keys.png" />
</Frame>

<p style={{textAlign: 'center', fontSize: '0.9em', color: '#666', marginTop: '8px'}}>テストキー設定。検証用 secret はアプリのサーバーに保持します。</p>

## 自動フォールバックの動作

CloudThinker は設定済みの顧客バイパスを先に試します。フォールバックが有効な場合、対応する reCAPTCHA v2、reCAPTCHA v3、hCaptcha、Turnstile のログインを同じブラウザーセッションで試行できます。

チャレンジやプロバイダーの検証が拒否する場合もあります。プロバイダーの選択は成功を保証しません。設定済みソルバーのクレジットを消費する場合があります。

これらはパスワードログイン用の設定です。他のログイン方法は [Pentest の実行](/ja/guide/security/pentest) を参照してください。

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

<AccordionGroup>
  <Accordion title="CAPTCHA がログインを妨げる">
    対象のテストキーやバイパス、フォールバックの利用可否を確認します。解決できない場合は検証済みセッションを使います。
  </Accordion>

  <Accordion title="フォールバックを利用できない">
    管理者に機能と必要なソルバーの設定を確認してもらいます。**Allow for this identity** はインストール全体の無効設定を上書きしません。
  </Accordion>

  <Accordion title="Test sitekey が動作しない">
    ウィジェットとサーバーに、選択したプロバイダーの対応するテストキーが設定されているか確認します。CloudThinker への入力は対象の検証設定を変更しません。
  </Accordion>

  <Accordion title="Bypass header を保存できない">
    ヘッダーポリシーには保護された認証情報の設定が必要です。管理者に依頼するか、検証済みセッションを追加します。
  </Accordion>
</AccordionGroup>

## 次のステップ

<CardGroup cols={2}>
  <Card title="Pentest を実行する" icon="crosshairs" href="/ja/guide/security/pentest">
    テスト前に範囲、アクセス、強度を確認
  </Card>

  <Card title="Cyber レポートを作成する" icon="file-lines" href="/ja/guide/security/cyber-reports">
    証拠とテストの制限を共有
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.