すべてのプロダクト
Search
ドキュメントセンター

Captcha:シナリオ管理

最終更新日:Nov 10, 2025

Captcha 2.0 を有効化した後、サービスを統合するために検証シナリオを作成する必要があります。このトピックでは、検証シナリオの作成方法について説明します。

前提条件

Alibaba Cloud Captcha 2.0 サービスを有効化したこと

検証シナリオの作成

検証シナリオを作成した後、Captcha 2.0 を統合するために Scenario ID を取得する必要があります。

重要

検証シナリオを作成する際、Rule StatusTest Mode に設定できます。この設定により、Captcha の脅威ポリシーチェックがバイパスされ、接続が成功したことのみが検証されます。これにより、統合テスト中に Captcha がお客様の操作をマシンの動作として誤って識別するのを防ぎます。

統合を完了し、接続が成功したことを確認した後、シナリオの Rule StatusOfficial Release に変更します。この設定により、Captcha は脅威ポリシーのチェックを実行し、攻撃から防御できます。

  1. 左側のナビゲーションウィンドウで、Scenarios をクリックしますScenarios ページで、Create Scenario をクリックします。

  2. Create Scenario パネルで、次のパラメーターを指定し、[OK] をクリックします。

    設定項目

    説明

    Scenario Name

    新しい Captcha シナリオの名前を入力します。

    名前は 1~32 文字で、漢字、英字、数字、アンダースコア (_) を使用できます。

    Integration Method

    Captcha の接続タイプを選択します。次のオプションが利用可能です:

    • Web/H5: このオプションを選択して、クライアントとサーバーに Captcha を統合します。詳細については、「Web および H5 の統合」をご参照ください。

    • Webview+H5 (アプリ/ミニアプリ統合用): このオプションを選択して、クライアント、サーバー、およびアプリに Captcha を統合します。詳細については、「アプリクライアントの統合」および「ミニプログラムの統合」をご参照ください。

    • WeChat ミニプログラムネイティブプラグイン: このオプションを選択して、クライアントに Captcha を統合します。詳細については、「WeChat ミニプログラム V2 アーキテクチャの統合」をご参照ください。

    説明
    • WeChat ミニプログラムの統合では、カスタムポリシーはサポートされていません。

    • 同じ接続タイプを使用する複数のサービスで、シーン ID を共有できます。接続タイプが異なるサービスには、個別のシナリオ構成が必要です。

    • 接続タイプは、デフォルトのセキュリティポリシーと密接に関連しています。構成された接続タイプが実際の統合と一致しない場合、認証は失敗します。構成を慎重に確認してください。

    • 接続タイプは、選択後に変更することはできません。間違ったタイプを選択した場合は、シナリオを削除して新しいシナリオを作成してください。

    Verification Type

    Captcha タイプを選択します。次のオプションが利用可能です:

    • Invisible CAPTCHA: 知覚できない認証を提供します。

      このオプションを選択した場合、セカンダリチャレンジが必要です。Additional Challenge は、One-click CAPTCHASlider CAPTCHAPuzzle Verification、および Image Restoration をサポートします。

      重要

      フリクションレス検証は、埋め込み (embed) 認証をサポートしていません。ポップアップ (popup) 認証を使用してください。

    • One-click CAPTCHA: ボタンをクリックして認証を完了します。

    • Slider CAPTCHA: スライダーをドラッグして認証を完了します。

    • Puzzle Verification: スライダーをドラッグしてパズルを完成させます。

    • Image Restoration: スライダーをドラッグして画像を復元します。

    Rule Status

    新しい検証シナリオのステータスを設定します。次のオプションが利用可能です:

    • Official Release (デフォルト): この状態では、Captcha はサーバーリクエストの脅威評価を実行し、攻撃から防御するための認証結果を返します。

    • Test Mode: この状態では、Captcha は接続が正常かどうかのみをチェックし、脅威チェックは実行しません。構成された認証結果のみを返します。テスト後、Official Release 状態に戻します。変更が有効になるまで約 5 分かかります。

      テスト状態では、各 Verification Type に対して次の認証結果を構成できます:

      • Invisible CAPTCHA + One-click CAPTCHA または Slider CAPTCHA (二次認証): Pass Invisible CAPTCHAFail Invisible CAPTCHA and Pass Additional ChallengeFail Invisible CAPTCHA and Additional Challenge

      • Invisible CAPTCHA + Puzzle Verification または Image Restoration (二次認証): Pass Invisible CAPTCHAFail Invisible CAPTCHA

      • One-click CAPTCHA: Pass VerificationFail Verification

      • Slider CAPTCHA: Pass VerificationFail Verification

      • パズル検証: Pass VerificationFail Verification

      • Image Restoration: Pass VerificationFail Verification

    重要

    Rule StatusOfficial Release であるか Test Mode であるかに関わらず、Captcha の呼び出しごとに課金されます。

  3. 検証シナリオが作成された後、クライアント統合のためにシナリオリストから Scenario ID を取得します。image.png

その他の操作

  • 統合ガイド

    対象シナリオの Actions 列にある Integration Guide をクリックして、統合手順とコード例を表示します。

  • 編集

    対象シナリオの Actions 列にある Modify をクリックして、その名前、Captcha タイプ、およびポリシーステータスを変更します。

  • カスタムポリシー

    対象シナリオの Actions 列にある Custom Policy をクリックして、カスタムポリシーを構成します。詳細については、「カスタムポリシー」をご参照ください。

  • 削除

    対象シナリオの Actions 列にある Delete をクリックします。Confirm Delete ダイアログボックスで、Scenario ID を入力し、リスクリマインダーのチェックボックスを選択して、OK をクリックします。

    警告

    検証シナリオを削除すると、そのすべての履歴データが完全に削除されます。このシナリオの構成を使用する Captcha の呼び出しも失敗します。シナリオが不要になったことが確実な場合にのみ、シナリオを削除してください。

    image