お問い合わせフォーム システム構成案¶
さくらVPSで配信する既存のAstro静的サイトと、メール送信用のさくらレンタルサーバーを維持し、AWSにフォーム受付・検証・メール送信処理を追加する提案です。この図は当初のAWS構成案です。現在はAWS版・自前版の送信APIが実装されています。現行仕様は仕様書とAPI仕様、初回構築はAWSセットアップを参照してください。図の検証結果はAWSの稼働確認を示すものではありません。
成果物¶
| ファイル | 用途 |
|---|---|
| architecture.html | ブラウザーで開く構成図。拡大縮小、ライト/ダーク切替、画像出力に対応。外部ライブラリの読み込み不要 |
| architecture.png | 提案書・スライドに貼り付ける画像(5440×2600px) |
| architecture.svg | 拡大しても劣化しないベクター画像 |
| architecture.json | Archify形式の編集元 |
| build.mjs | AWS公式アイコンを追加して検証・HTML生成するスクリプト |
| icons/SOURCES.json | アイコンの取得元・リリース・SHA-256 |
| validation.json | 最終成果物の検証結果・SHA-256 |
| architecture.visual-check.html | 検証時のライト/ダーク画像一覧 |
図の内容は日本語です。Archifyの固定操作UIとHTMLの言語属性は、生成ツールの対応言語の都合により英語です。PNG・SVGは図本体のみを出力し、操作UIは含みません。
AWS各サービスには、AWS公式アーキテクチャアイコンの2026年7月31日版を使用しています。CloudflareにはArchify同梱のCloudflareロゴ(Simple Icons)を使用しています。いずれもHTML・SVG内に埋め込み、閲覧時に外部から取得しません。AWSロゴの追加処理は作業用コピーで行い、インストール済みArchifyスキルは変更しません。
前提¶
- 入力内容を指定の受信メールアドレスに送信する。
- 投稿者への自動応答メールは送信しない。
- さくらレンタルサーバーのSMTPはインターネットからSMTP認証で接続可能で、接続元の固定IP制限はない。
- SMTP接続には587番+STARTTLS、または465番+TLSを使用する。どちらを使用するかは実装時に決める。
- bot対策にCloudflare Turnstileを使用する。利用者の本人確認・メールアドレスの所有確認を行うものではない。
- 正常な投稿は月100件未満を想定。時間・日単位の具体的な送信上限は別途決定する。
- AWSは東京リージョンを想定。Lambdaを自分のVPCへ接続せず、NAT Gateway・SESは使用しない。
各サービスの役割¶
| 構成要素 | 役割 |
|---|---|
| さくらVPS | nginxでAstroの静的ファイルを配信 |
| API Gateway / HTTP API | HTTPSの受付、CORS設定、リクエスト頻度の制限 |
| Lambda | 入力・同意・Turnstileの検証、送信枠の確保、さくらレンタルサーバーのSMTPへのメール送信 |
| DynamoDB | 時間・日単位のカウンターを管理。問い合わせ本文の保管は行わない |
| Secrets Manager | SMTP認証情報とTurnstile秘密鍵を管理 |
| IAM | Lambdaから対象テーブル・秘密情報・ログへのアクセスを最小権限で許可 |
| CloudWatch | 個人情報を除いた処理ログ、エラー・スロットリング等の監視、アラーム |
| SNS | 異常時に管理者へ通知。投稿者宛ての自動返信には使用しない |
| Cloudflare Turnstile | ブラウザーで発行されたトークンをSiteverify APIで検証 |
| さくらレンタルサーバー | TLS・SMTP認証でメールを受け付け、固定の受信先へ配送 |
図のAWS枠はサービスをまとめた概念的な境界です。VPCやネットワーク隔離を表すものではありません。IAMは全体の権限制御として図の補足欄に記載しています。
送信の流れ¶
- 利用者がさくらVPSから入力画面を取得し、入力・確認を行う。
- 送信直前にブラウザーでTurnstileのトークンを取得する。
- 入力値とトークンをAPI GatewayへHTTPS POSTで送信する。
- Lambdaが項目の型・文字数・メール形式・問い合わせ種別・同意を再検証する。
- LambdaがTurnstileのSiteverify APIを呼び出し、成功・hostname・actionを検証する。
- DynamoDBで送信枠を確保する。複数期間の上限を同時に適用する場合は、トランザクション内の条件付き更新などで判定と加算を一体化する。
- LambdaがさくらレンタルサーバーのSMTPへ接続し、固定の宛先に1通送信する。Fromは固定し、投稿者のアドレスは検証したうえでReply-Toに設定する。
- SMTP受付成功後、API経由でブラウザーへ結果を返す。SMTP受付成功は受信箱への最終到達を保証するものではない。
図は主要な構成・呼び出し関係を示し、応答矢印とブラウザーからTurnstileへのトークン取得経路は省略しています。Secrets Manager・DynamoDBへの矢印はLambdaからの要求を表し、データの一方向転送だけを示すものではありません。
制限・障害時の方針¶
- 入力不正、Turnstile検証失敗・通信障害、上限到達、件数管理の障害時はメールを送信しない。
- 送信枠はSMTP接続前に消費し、SMTP失敗時も試行回数として扱う方針とする。正常送信数の厳密な集計とは異なる。
- API GatewayのスロットリングとLambdaの同時実行数制限も併用する。これらは日単位の送信件数制限を代替しない。
- SMTP受付とDynamoDBの更新は単一トランザクションにできない。SMTP受付後の通信切断などでは送信済みか断定できないため、無条件の自動再送はしない。重複送信の防止方法は実装時に具体化する。
- AWS側の件数制限は本フォーム経由の送信に適用する。SMTP認証情報が漏れて外部から直接使われる場合には適用できない。
- SMTPのTLS・証明書検証は必須とし、フォーム専用アカウントを使用する。
- ログに本文・氏名・メールアドレス・パスワード・Turnstileトークンを記録しない。ログ保存期間を設定する。
検証¶
Archifyのshowcase検証9項目すべて合格、構図診断はエラー0・警告0。1440×900、1600×1000、1920×1080、2048×1320で縦横のはみ出しなし。生成HTMLのライト/ダーク画像と、提案用PNGを目視確認しました。ネットワーク疎通、Turnstile認証、実メール送信を検証した資料ではありません。
再生成例(Archifyのインストール先は環境に合わせて変更):
node docs/contact-form/architecture/build.mjs <archify-dir>
node <archify-dir>/bin/archify.mjs visual-check docs/contact-form/architecture/architecture.html --json
JSONを変更した場合は再検証・HTML再生成後に、HTMLのExportメニューからPNG・SVGも更新してください。
build.mjs はArchifyの一時コピーへ、この資料専用のAWSブランド定義と28pxのアイコン配置を適用します。通常のArchifyコマンドだけではAWSの追加ブランドIDを解決できないため、HTMLの再生成には上記スクリプトを使用してください。生成時の検証記録は目視確認前のため visual_review: pending となります。画像を確認してから記録を更新します。