← 戻る

OpenResty Edge で hCaptcha の検証ページを設定する

章亦春投稿日 Jun 6, 2023 更新日 Dec 17, 2024

読了時間約7分

閲覧数

本日は、OpenResty Edge でアプリケーションに hCaptcha サービスを設定する方法をご紹介いたします。hCaptcha は、ウェブサイトをマルウェア、自動化スクリプト、スパム攻撃から保護するためのサードパーティサービスです。

OpenResty Edge で hCaptcha を設定する

いつものように、OpenResty Edge の Admin Web コンソールにアクセスしましょう。これは私たちのコンソールのサンプルデプロイメントです。各ユーザーは独自のローカルデプロイメントを持っています。

アプリケーションで hCaptcha を有効にする前に、hCaptcha の Sitekey と Secret key を設定する必要があります。

グローバル設定ページに移動します。

CAPTCHA 設定ページに進みます。

hCaptcha の Sitekey と Secret key は、hCaptcha の公式ウェブサイトから取得する必要があります。

hCaptcha の公式ウェブサイトにアクセスしてログインまたは登録します。

次に、ウェブサイトページに進み、Sitekey リストを確認します。Sitekey 設定ページに移動します。

ここで Sitekey の詳細情報を取得できます。

次に、設定ページに移動して Secret key を確認します。

ここで Secret key を取得できます。

hCaptcha ウェブサイトから取得した Sitekey と Secret key を入力します。

保存をクリックします。

これで hCaptcha の Sitekey と Secret key が設定されました。

次に、アプリケーションに hCaptcha を設定しましょう。

引き続き test-edge.com ドメインを使用して、hCaptcha の設定方法をデモンストレーションします。

このアプリケーションに進みます。

前回のチュートリアルで、すでにアップストリームを定義しています。

この my_backend アップストリームは、バックエンドサーバーを定義しています。

また、ページルールも定義済みです。

前回のチュートリアルでは、このページルールで先ほど確認したアップストリームへのリバースプロキシを設定しました。

では、hCaptcha アクションを有効にする新しいページルールを追加しましょう。

このルールには条件を設定していないことに注意してください。これは、このルールが無条件にトリガーされることを意味します。

新しいアクションを追加します。

「Enable hCaptcha」アクションを検索します。

「Enable hCaptcha」オプションを選択します。

クライアントが CAPTCHA 検証を通過した後、OpenResty Edge は指定された期間内に同じクライアントからのすべてのリクエストを許可します。この期間は clearance time と呼ばれます。hCaptcha は cookie を使用して検証情報を記録します。

この時間を 10 秒に設定します。

このルールを最上位に移動して、優先的に実行されるようにします。これはデモンストレーションを容易にするための設定です。実際には任意の順序に設定できます。

このルールを保存します。

いつものように、編集したページルールをプッシュするために新しい設定をリリースする必要があります。

このボタンをクリックします。

リリースします。

完全に同期されました。

これで、新しいページルールがすべてのゲートウェイクラスターとサーバーにプッシュされました。

設定の変更にはサーバーのリロード、再起動、バイナリのアップグレードは必要ありません。そのため、非常に効率的でスケーラブルです。

OpenResty Edge ですべてのアプリケーションを管理する

テスト

では、test-edge.com にアクセスしてみましょう。オリジンサイトのコンテンツではなく、hCaptcha の検証ページが表示されることがわかります。

検証をクリックします。指示に従って正しい画像を選択してください。

正しくない画像を選択した場合、別の画像セットが表示され、選択を続けることができます。

検証が完了すると、この URI で期待されるコンテンツが表示されます。先ほど clearance time を 10 秒に設定したことに注意してください。これは、10 秒間 CAPTCHA なしでこのドメインにアクセスできることを意味します。

10 秒経過後は、再度検証が必要になります。

アクションで CAPTCHA を設定するだけでなく、WAF ルールでも CAPTCHA を設定できます。WAF ルールの具体的な機能については、別の動画でデモンストレーションいたします。

まずは、WAF ルールで hCaptcha を設定する方法を簡単に見てみましょう。

WAF を有効にします。

ここでブロックアクションを hCaptcha に設定できます。

「OpenResty Edge gateway server captcha challenge - hCaptcha」オプションを選択します。

先ほどアクションを設定したときと同様に、ここでも clearance time を設定する必要があります。ここでは詳細なデモンストレーションは省略します。詳細については、WAF ルールに関連する動画をご覧ください。

ちなみに、OpenResty Edge の組み込み CAPTCHA サービスもサポートしています。OpenResty Edge の組み込み CAPTCHA のチュートリアル動画で、この機能の詳細をご覧いただけます。

OpenResty Edge について

OpenResty Edge は、マイクロサービスと分散トラフィックアーキテクチャ向けに設計された多機能ゲートウェイソフトウェアで、当社が独自に開発しました。トラフィック管理、プライベート CDN 構築、API ゲートウェイ、セキュリティ保護などの機能を統合し、現代のアプリケーションの構築、管理、保護を容易にします。OpenResty Edge は業界をリードする性能と拡張性を持ち、高並発・高負荷シナリオの厳しい要求を満たすことができます。K8s などのコンテナアプリケーショントラフィックのスケジューリングをサポートし、大量のドメイン名を管理できるため、大規模ウェブサイトや複雑なアプリケーションのニーズを容易に満たすことができます。

OpenResty Edge の試用を申請する

著者について

章亦春（Zhang Yichun）は、オープンソースの OpenResty^® プロジェクトの創始者であり、OpenResty Inc. の CEO および創業者です。

章亦春（GitHub ID: agentzh）は中国江蘇省生まれで、現在は米国ベイエリアに在住しております。彼は中国における初期のオープンソース技術と文化の提唱者およびリーダーの一人であり、Cloudflare、Yahoo!、Alibaba など、国際的に有名なハイテク企業に勤務した経験があります。「エッジコンピューティング」、「動的トレーシング」、「機械プログラミング」の先駆者であり、22 年以上のプログラミング経験と 16 年以上のオープンソース経験を持っております。世界中で 4000 万以上のドメイン名を持つユーザーを抱えるオープンソースプロジェクトのリーダーとして、彼は OpenResty^® オープンソースプロジェクトをベースに、米国シリコンバレーの中心部にハイテク企業 OpenResty Inc. を設立いたしました。同社の主力製品である OpenResty XRay 動的トレーシング技術を利用した非侵襲的な障害分析および排除ツール）と OpenResty Edge（マイクロサービスおよび分散トラフィックに最適化された多機能ゲートウェイソフトウェア）は、世界中の多くの上場企業および大企業から高い評価を得ております。OpenResty 以外にも、章亦春は Linux カーネル、Nginx、LuaJIT、GDB、SystemTap、LLVM、Perl など、複数のオープンソースプロジェクトに累計 100 万行以上のコードを寄与し、60 以上のオープンソースソフトウェアライブラリを執筆しております。