Worker バックエンド

Slack API の呼び出しは Cloudflare Worker の内側に閉じ込める。bot トークンと signing secret はフロントエンドへ渡さない。

基本の立場

このサイトで扱う Slack 連携は、ブラウザではなくすべて Cloudflare Worker を経由する。bot トークンを保持し、届いたリクエストが本当に Slack から来たものかを検証し、slack.com/api/* を呼ぶ。その一切を担う唯一の場所が Worker である。Slack 由来のものはクライアントへ一切渡さない。ページからの fetch にトークンを載せることも、バンドルされた JS に signing secret を混ぜることも、ブラウザから Slack へ直接リクエストすることもない。

これはスタイルの好みではなく、bot トークンと signing secret を秘密のまま保つ唯一の形だ。ブラウザに届いた時点でシークレットは公開されたも同然で、devtools を開いてネットワークタブなりバンドルなりを読めば誰でも使えてしまう。一方 Worker はサーバーサイドの実行環境であり、wrangler secret put で設定した値は暗号化され、ダッシュボードにも Wrangler CLI にも二度と表示されない（シークレットと設定を参照）。Slack への呼び出しをすべてこの境界の内側に置くことこそが、そもそもトークンを持てるようにしている前提である。

どこに何を置くか

bot トークンが要る処理は Worker のなかで行う。ページが単に、Worker が（D1 なり KV なりへ）すでに書き込んだ内容を表示したいだけなら、クライアントは Worker 自身の /api/* ルートから取得すればよい。Slack から直接取りにいくことはない。

セクションの地図

このセクションのページを、新しく連携を組むときに必要になる順で並べると次のようになる。

• シークレットと設定 -- bot トークンと signing secret の置き場所、そして何もコミットせずにローカル開発へ渡す方法。

• リクエストの検証 -- 受け取ったリクエストに反応する前に、それが本当に Slack からのものだと確かめる。

• 3 秒 ack -- Slack の応答時間の予算と、ctx.waitUntil() でそれを満たす方法。

• fetch による Web API 呼び出し -- Worker から Slack を呼ぶ側の話。認証、エンコーディング、レート制限。

• Cron による定期投稿 -- 同じ Worker を webhook ではなく時計で駆動し、スケジュールに沿って投稿する。