1. 概要
Claude Code や Slack から生成した HTML を、社内IPからのみ閲覧できる sandbox 領域に
ワンコマンドで公開するためのツールです。アップロードした HTML は
{timestamp}_{username} 形式の自動パス、または {slug} 形式の
固定パスで配信されます。
用途: 内部レビュー用のモック共有・PoC・記事下書き・お試しのウェブUIなど。
顧客向けの本番配信、認証が必要な業務情報、公開予定の制作物には使わない。
顧客向けの本番配信、認証が必要な業務情報、公開予定の制作物には使わない。
2. コマンド一覧
| コマンド | 用途 | 備考 |
|---|---|---|
upload | HTMLまたはディレクトリを公開 | ディレクトリは自動でzipに固める |
list | 自分の公開サイト一覧 | TTL・状態を一覧 |
activate | TTL切れサイトを再公開 | 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 path | custom path | |
|---|---|---|
| 形式 | 20260605T093000Z_tatematsu | demo-foo / 任意slug |
| 再上書き | 新規ごとに別URL | 同名にアップロードで上書き |
| TTL | 90日で自動 unpublish | TTLなし(明示deleteまで残る) |
| 典型用途 | その場のレビュー | 共有用の固定URL |
4. 信頼境界・既知リスク
- OK 公開URLは Terraform変数
allowed_ipsのIPからのみ CloudFront Function が許可する - OK S3 バケットは private + OAC で CloudFront 経由のみアクセス可
- OK Slack 経路はHMAC署名検証 (5分以内)、Claude Code 経路はBearer token
- OK 秘密情報は SSM Parameter Store (SecureString / KMS暗号化) で管理
- Caveat API Gateway の rate limit は throttling burst 50 / rate 25 のデフォルト。WAFは未導入
詳細な評価は
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>
トークン漏洩時
- 漏洩したユーザーのトークンを失効
./scripts/manage-tokens.sh revoke <username> - 必要なら新しいトークンを発行し、本人に配布
./scripts/manage-tokens.sh issue <username> - 不正アップロード分は
list scope=allで確認しdelete
6. エンドポイント仕様
| Method | Path | 認証 | 用途 |
|---|---|---|---|
| GET | https://<cdn>/{path}/[file] | CloudFront Function (IP allowlist) | 公開HTML/アセット配信 |
| POST | https://<api>/upload | Bearer <個人トークン> | Claude Code からアップロード |
| POST | https://<api>/list | 同上 | サイト一覧 |
| POST | https://<api>/activate | 同上 (owner一致) | 再公開 / TTLリセット |
| POST | https://<api>/delete | 同上 (owner一致) | 完全削除 |
| POST | https://<api>/slack/upload | Slack 署名 | slash command 受け口 |
| — | EventBridge cron | IAM (events.amazonaws.com) | 日次 TTL 監視 (Lambda 直接呼び出し) |