HN 日本語サマリー

← 一覧へ戻る
セキュリティ

Captchaはあなたが人間であることを証明する。HATCHAはあなたが人間ではないことを証明する。

Captcha proves you're human. HATCHA proves you're not (github.com)

58 pointsby backlit403467 コメント

要約

HATCHAは、人間にとっては困難だがAIエージェントにとっては簡単な課題(大きな数の乗算、文字列の反転、バイナリデコードなど)を通過させることで、アクセスを制限するリバースCAPTCHAです。 サーバーサイドでの検証を行い、回答はクライアントに到達せず、HMAC署名付きトークンを使用するためステートレスでデータベース不要です。 Next.js App RouterおよびExpressミドルウェア用のフレームワークアダプターが付属し、テーマ設定やカスタムチャレンジの登録も可能です。

全文翻訳

HATCHA

CAPTCHAは人間であることを証明する。HATCHAは人間でないことを証明する。

[画像: npm] [画像: License] [画像: CI]


[画像: HATCHAモーダルが動作中]

HATCHA (Hyperfast Agent Test for Computational Heuristic Assessment) は、AIエージェントにとっては容易だが人間には困難なチャレンジ(大規模乗算、文字列反転、バイナリデコードなど)でアクセスを制限する、リバースCAPTCHAです。

  • サーバーサイド検証 — 回答はクライアントに到達しません。HMAC署名付きトークン、ステートレス、データベース不要。
  • 5つの組み込みチャレンジタイプ — 数学、文字列反転、文字カウント、ソート、バイナリデコード。
  • 拡張可能 — ランタイムでカスタムチャレンジジェネレーターを登録できます。
  • テーマ設定可能 — CSSカスタムプロパティ経由でダーク、ライト、または自動モード。
  • フレームワークアダプター — すぐに使えるNext.js App RouterおよびExpressミドルウェア。

クイックスタート (Next.js)

1. インストール
npm install @mondaycom/hatcha-react @mondaycom/hatcha-server
2. APIルートを追加
// app/api/hatcha/[...hatcha]/route.ts
import { createHatchaHandler } from "@mondaycom/hatcha-server/nextjs";

const handler = createHatchaHandler({
  secret: process.env.HATCHA_SECRET!,
});

export const GET = handler;
export const POST = handler;
3. レイアウトをラップ
// app/layout.tsx
import { HatchaProvider } from "@mondaycom/hatcha-react";
import "@mondaycom/hatcha-react/styles.css";

export default function RootLayout({ children }) {
  return (
    <html lang="en">
      <body>
        <HatchaProvider>{children}</HatchaProvider>
      </body>
    </html>
  );
}
4. 検証をトリガー
"use client";
import { useHatcha } from "@mondaycom/hatcha-react";

function AgentModeButton() {
  const { requestVerification } = useHatcha();

  return (
    <button
      onClick={() =>
        requestVerification((token) => {
          console.log("Agent verified!", token);
        })
      }
    >
      Agent Modeに入る
    </button>
  );
}
5. シークレットを設定
# .env.local
HATCHA_SECRET=your-random-secret-here

仕組み

クライアント                            サーバー
  │                                 │
  │  GET /api/hatcha/challenge      │
  │────────────────────────────────►│
  │                                 │  チャレンジを生成
  │                                 │  回答をハッシュ化
  │                                 │  { hash, expiry } をHMAC署名
  │  { challenge (回答なし), token }
  │◄────────────────────────────────│
  │                                 │
  │  エージェントがチャレンジを解く     │
  │                                 │
  │  POST /api/hatcha/verify        │
  │  { answer, token }
  │────────────────────────────────►│
  │                                 │  HMAC署名を検証
  │                                 │  有効期限を確認
  │                                 │  回答ハッシュを比較
  │  { success, verificationToken }
  │◄────────────────────────────────│

回答はクライアントに到達しません。署名付きトークンは不透明で、ハッシュ化された回答と有効期限のみを含みます。検証はステートレスで、データベースは不要です。

チャレンジタイプ

タイプアイコン内容時間制限
math×5桁 × 5桁の乗算30秒
string↔60-80文字のランダムな文字列を反転30秒
count#約250文字中の特定文字をカウント30秒
sort⇅15個の数値をソートし、k番目に小さい値を返す30秒
binary01バイナリオクテットをASCIIにデコード30秒

カスタムチャレンジ

import { registerChallenge } from "@mondaycom/hatcha-server";

registerChallenge({
  type: "hex",
  generate() {
    const n = Math.floor(Math.random() * 0xffffff);
    return {
      display: {
        type: "hex",
        icon: "0x",
        title: "Hex Decode",
        description: "この16進数を10進数に変換してください。",
        prompt: `0x${n.toString(16).toUpperCase()}`,
        timeLimit: 30,
        answer: String(n),
      },
      answer: String(n),
    };
  },
});

テーマ設定

HATCHAは --hatcha-* でスコープされたCSSカスタムプロパティを使用します。これらは任意の親要素でオーバーライドできます。

[data-hatcha-theme] {
  --hatcha-accent: #3b82f6;
  --hatcha-accent-light: #60a5fa;
  --hatcha-bg: #060b18;
  --hatcha-fg: #e4eaf6;
  --hatcha-success: #22c55e;
  --hatcha-danger: #ef4444;
}

<HatchaProvider> または <Hatcha> に theme="dark"、theme="light"、または theme="auto" を渡します。

Express

import express from "express";
import { hatchaRouter } from "@mondaycom/hatcha-server/express";

const app = express();
app.use(express.json());
app.use("/api/hatcha", hatchaRouter({ secret: process.env.HATCHA_SECRET! }));

app.listen(3000);

パッケージ

パッケージ説明
@mondaycom/hatcha-coreチャレンジ生成と暗号検証
@mondaycom/hatcha-reactReactコンポーネント、プロバイダー、スタイル
@mondaycom/hatcha-serverNext.jsおよびExpressサーバーハンドラー

開発

git clone https://github.com/mondaycom/HATCHA.git
cd HATCHA
pnpm install
pnpm build
cd examples/nextjs-app
pnpm dev

貢献

貢献を歓迎します!セットアップ手順とガイドラインについては、CONTRIBUTING.md を参照してください。

ライセンス

MIT