Sandbox Hosting

IP制限付き個人向けHTMLホスティング — 運用者ガイド

1. 概要

Claude Code や Slack から生成した HTML を、社内IPからのみ閲覧できる sandbox 領域に ワンコマンドで公開するためのツールです。アップロードした HTML は {timestamp}_{username} 形式の自動パス、または {slug} 形式の 固定パスで配信されます。

用途: 内部レビュー用のモック共有・PoC・記事下書き・お試しのウェブUIなど。
顧客向けの本番配信、認証が必要な業務情報、公開予定の制作物には使わない。

2. コマンド一覧

コマンド用途備考
uploadHTMLまたはディレクトリを公開ディレクトリは自動でzipに固める
list自分の公開サイト一覧TTL・状態を一覧
activateTTL切れサイトを再公開TTLは公開日から+90日リセット
deleteサイト完全削除blob/metaを物理削除

Claude Code から

# 単一HTMLを公開
./skills/sandbox-upload/scripts/upload.sh ./report.html

# ディレクトリ(index.html必須)
./skills/sandbox-upload/scripts/upload.sh ./build

# 固定slug指定(上書き)
./skills/sandbox-upload/scripts/upload.sh --path demo-foo ./report.html

# 一覧 / 再アクティブ / 削除
./skills/sandbox-upload/scripts/upload.sh list
./skills/sandbox-upload/scripts/upload.sh activate <path>
./skills/sandbox-upload/scripts/upload.sh delete   <path>

Slack から

/sandbox <html>
/sandbox demo-foo <html>
/sandbox https://files.slack.com/.../site.zip

3. auto path vs custom path

auto pathcustom path
形式20260605T093000Z_tatematsudemo-foo / 任意slug
再上書き新規ごとに別URL同名にアップロードで上書き
TTL90日で自動 unpublishTTLなし(明示deleteまで残る)
典型用途その場のレビュー共有用の固定URL

4. 信頼境界・既知リスク

詳細な評価は docs/architecture-review.md 参照。WAF rate limit ルールが次フェーズの対応候補。

5. 運用ランブック

初回セットアップ(運用者)

aws configure
cd terraform && cp terraform.tfvars.example terraform.tfvars  # 編集
cd ..
./scripts/setup-aws.sh        # ビルド → terraform apply

クライアント初期設定(各利用者)

./scripts/setup-client.sh        # ~/.config/sandbox-hosting/env を生成
./scripts/healthcheck.sh         # 公開→閲覧の往復チェック

TTL切れに気付いたとき

./skills/sandbox-upload/scripts/upload.sh list
./skills/sandbox-upload/scripts/upload.sh activate <path>

誤って上げてしまったとき

./skills/sandbox-upload/scripts/upload.sh delete <path>

トークン漏洩時

  1. 漏洩したユーザーのトークンを失効
    ./scripts/manage-tokens.sh revoke <username>
  2. 必要なら新しいトークンを発行し、本人に配布
    ./scripts/manage-tokens.sh issue <username>
  3. 不正アップロード分は list scope=all で確認し delete

6. エンドポイント仕様

MethodPath認証用途
GEThttps://<cdn>/{path}/[file]CloudFront Function (IP allowlist)公開HTML/アセット配信
POSThttps://<api>/uploadBearer <個人トークン>Claude Code からアップロード
POSThttps://<api>/list同上サイト一覧
POSThttps://<api>/activate同上 (owner一致)再公開 / TTLリセット
POSThttps://<api>/delete同上 (owner一致)完全削除
POSThttps://<api>/slack/uploadSlack 署名slash command 受け口
—EventBridge cronIAM (events.amazonaws.com)日次 TTL 監視 (Lambda 直接呼び出し)