お問い合わせフォーム仕様書¶
更新日:2026年11月11日
対象ページ:/contact/
1. 目的と対象範囲¶
株式会社テクタスの商品・サービス、システム開発、採用などに関する問い合わせを受け付け、指定のメールアドレスへ通知する。投稿者への自動応答メールは送信しない。
本仕様書では、リポジトリ内の実装、試験環境での確認、本番公開に必要な設定を区別する。画面と両方式のAPIは実装済みで、2026年11月10日に利用者から自前版でのブラウザー送信・メール受信の成功が報告された。Turnstileを省略した試験であり、実Turnstileの検証、AWSへの配置、本番公開は未実施である。本番用の宛先や認証情報などは「未決定事項」で扱う。要求・応答はAPI共通仕様、構築方法はAWSの構築・運用手順または自前サーバーのセットアップ、試験時の切り分けはトラブルシューティングを参照する。
| 対象 | 状態 |
|---|---|
| 入力画面、確認画面、修正操作 | 実装済み |
| ブラウザーでの入力検証とエラー表示 | 実装済み |
| 「送信する」ボタン | 送信中・成功・失敗の表示まで実装済み。未設定時は電話へ案内 |
| Turnstileによるbot対策 | 実装済み。今回の試験では省略し、実キーでの検証は未実施 |
| 送信API、サーバーでの入力検証、SMTP送信 | 実装済み。自前版の試験環境でブラウザー送信・受信が利用者から報告済み。AWS版は未検証 |
| DynamoDBまたはSQLiteによる件数制限 | 受付IDと時間・日のカウンターを一括更新する処理を実装済み |
| AWSリソース、監視・通知 | AWS SAMの構築定義を作成済み。未デプロイ |
| 自前アプリサーバー | 試験環境へ配置し、利用者が送信・受信を確認。本番配置、監視通知、バックアップ・復旧などの運用確認は別途必要 |
問い合わせの管理画面、添付ファイル、投稿者への自動返信、問い合わせ本文のデータベース保存は、今回の対象に含めない。
2. システム構成¶
WebサイトはさくらVPSで静的ファイルとして配信し、送信処理はAWS版または自前アプリサーバー版を配置時に選択する。メールはさくらレンタルサーバーのSMTPで送信する。フロントの入力・応答形式は共通とし、公開APIの接続先で切り替える。既存のシステム構成図はAWS版を示す。
自前版は公開プロキシから内部アプリサーバーへ転送し、専用Node.jsプロセスとSQLiteを使用する。外向きのHTTPS・SMTPはNAT・ゲートウェイを経由する。Redmineとは実行ユーザー・プロセス・設定を分離する。以下の構成要素表はAWS版のものである。
| 構成要素 | 役割 |
|---|---|
| さくらVPS | nginxでAstroの静的サイトを配信 |
| Amazon API Gateway(HTTP API) | HTTPSで投稿を受け付け、CORSとアクセス頻度の制限を設定 |
| AWS Lambda | 入力・Turnstileの検証、送信枠の確保、SMTP送信を実行 |
| Amazon DynamoDB | 時間・日単位の送信件数を管理 |
| AWS Secrets Manager | SMTP認証情報とTurnstileの秘密鍵を保管 |
| AWS IAM | 各リソースへのアクセス権限を制御 |
| Amazon CloudWatch | 処理結果を記録し、エラーやアクセス増加を監視 |
| Amazon SNS | 異常時に管理者へ通知 |
| Cloudflare Turnstile | 投稿時のbot対策。トークンの有効性をサーバーで検証 |
| さくらレンタルサーバー | SMTP認証とTLSを使ってメールを受け付け、固定の宛先へ配送 |
AWSは東京リージョンを想定する。SMTPは社外から接続でき、固定IPによる接続元制限がないことを前提に、Lambdaを自分のVPCへ接続しない構成とする。NAT GatewayとAmazon SESは使用しない。自前版では試験環境からの送受信が報告されているが、Lambdaからの接続はAWS構築時に別途確認する。
3. 入力画面¶
3.1. 入力項目¶
現在の入力項目と上限は次のとおりである。文字数の上限はHTMLのmaxlengthで指定している。サーバーでも同じ上限を検証し、ブラウザーとサーバーで数え方が変わらないようにする。現在のHTMLに合わせる場合、長さはUTF-16コード単位で数えるため、一部の絵文字は2文字分になる。
| 項目 | フィールド名 | 必須 | 上限・選択肢 |
|---|---|---|---|
| お問い合わせ種別 | category |
必須 | 商品・サービスについて/システム開発について/採用について/その他 |
| 会社名・団体名 | company |
任意 | 200文字 |
| お名前 | name |
必須 | 100文字 |
| メールアドレス | email |
必須 | 254文字。type="email"による形式検証 |
| 電話番号 | phone |
任意 | 30文字。現時点では電話番号の書式を限定しない |
| お問い合わせ内容 | message |
必須 | 5,000文字。複数行を入力可能 |
| 個人情報の取扱いへの同意 | consent |
必須 | チェック済みであること |
個人情報の取扱いは、既存の説明ページへ案内する。このリンクは公開サイト上のURLを示す。同意欄は初期状態では未チェックとし、利用者が自分で選択する。
3.2. 入力検証とエラー表示¶
入力欄からフォーカスが外れたときと、「入力内容を確認する」を押したときに検証する。確認ボタンでは全項目を検証し、エラーがある場合は確認画面へ進めず、最初のエラー項目へフォーカスを移す。
エラーメッセージは該当欄の下へ表示する。エラーのある欄を修正したときは再検証し、条件を満たしたら表示を消す。色に加えて文章とaria-invalidで状態を示し、補足文との関連にはaria-describedbyを使う。
各入力欄の下には補助説明・エラー用の領域を確保し、エラー時は同じ領域で説明を切り替える。正常になったら元の説明と読み上げの関連付けを戻す。長いメッセージは折り返しを許容する。同意欄の文書リンクは、独立した高さ44px以上の操作領域とする。
| 条件 | 現在のメッセージ |
|---|---|
| 種別が未選択 | お問い合わせ種別を選択してください。 |
| お名前が未入力 | お名前を入力してください。 |
| メールアドレスが未入力 | メールアドレスを入力してください。 |
| メール形式が不正 | メールアドレスを正しい形式で入力してください。(例:name@example.com) |
| お問い合わせ内容が未入力 | お問い合わせ内容を入力してください。 |
| 同意が未チェック | 個人情報の取扱いへの同意が必要です。 |
| 文字数超過を検出 | 入力できる文字数を超えています。 |
必須のテキスト項目は、空白文字だけの入力も未入力として扱う。通常の入力操作ではmaxlengthで文字数を制限するが、APIへ直接投稿される場合もあるため、サーバー側の検証を別途実装する。
4. 確認・修正・送信の画面操作¶
4.1. 入力内容の確認¶
入力に問題がなければフォームを非表示にし、同じページ内に確認内容を表示する。確認画面には、種別・会社名・お名前・メールアドレス・電話番号・お問い合わせ内容を並べる。任意項目が空の場合は「未入力」と表示する。
確認中は入力用の案内を非表示にする。修正操作やAPIの入力エラーでフォームへ戻る場合は、入力用の案内も復元する。
確認内容は前後の空白を除いて表示し、本文中の改行は維持する。入力値はHTMLとして解釈せず、文字列として表示する。同意は確認画面へ進む条件として扱い、「個人情報の取扱い:同意済み」は重ねて表示しない。
4.2. 入力内容の修正¶
「入力内容を修正する」を押したら確認画面を非表示にし、入力フォームを再表示する。全入力値と同意チェックを保持し、先頭の「お問い合わせ種別」へフォーカスを移す。値を保持したまま修正し、再び確認画面へ進める。
入力値は同じページの入力欄に保持する。再読み込みや別ページへの移動後に復元する機能は実装しておらず、localStorageやsessionStorageにも保存しない。
4.3. 送信操作¶
確認画面には、枠線の「入力内容を修正する」と、青い「送信する」を表示する。API URLとTurnstileサイトキーが設定されていない場合、送信時に電話での問い合わせを案内し、外部へ通信しない。
送信時はTurnstileのトークン取得後にAPIへ投稿する。処理中は送信・修正ボタンを無効にし、認証中・送信中の状態を文章で示す。成功時は入力・確認画面と操作ボタンを非表示にし、「お問い合わせを送信しました。」という完了メッセージ、担当者からの連絡案内、ホームへのリンクを表示する。入力値と確認欄の内容は消去し、完了領域へフォーカスを移す。失敗時は入力を保持し、結果に応じた案内を表示する。
完了時には円とチェックマークを約0.55秒で描くアニメーションを一度表示する。OSやブラウザーで動きを減らす設定が有効な場合は、アニメーションを行わず完成したマークを表示する。完了メッセージは動きの有無にかかわらず表示する。
4.4. 表示・操作環境¶
PCとスマートフォン、ライトとダークの配色に対応する。キーボードで各項目とボタンを操作でき、フォーカス位置を輪郭で示す。エラーや送信結果は、色だけに依存しない形で表示する。
JavaScriptが無効な場合は確認ボタンを表示せず、電話での問い合わせを案内する。今後の送信機能もJavaScriptの利用を前提とする。
5. サーバー側の受付と検証¶
5.1. 受付APIの実装方針¶
APIはPOST /contactでJSONを受け付ける。入力項目に加えて、真偽値のconsent、UUID v4形式のrequestId、文字列のturnstileTokenを送る。APIのURLは、AWS版ではSAMの出力、自前版では公開プロキシのURLをサイトの公開環境変数へ設定する。応答には結果の分類codeとログ照合用のreceiptIdを含める。HTTPステータスと分類は構築・運用手順に記載する。
APIでは項目の型・必須条件・長さ・メール形式・問い合わせ種別・同意状態を検証し、仕様にない項目を拒否する。宛先、From、SMTP接続先はサーバー設定から取得し、利用者の入力で変更できないようにする。本文はUTF-8で32KiBまでとし、JSON以外を拒否する。
5.2. 処理の順序¶
- 送信許可設定、オリジン、要求の形式・サイズと入力値を検証する。
- 同じ受付IDの記録を調べる。記録があれば入力のHMACを照合し、記録済みの状態を返す。
- 新しい要求ではTurnstileのトークンを検証する。
- DynamoDBまたはSQLiteのトランザクションで受付IDと時間・日単位の送信枠を一括して確保する。
- さくらレンタルサーバーへSMTP認証とTLSで接続し、メールを1通送信する。
- SMTPの結果を記録し、ブラウザーへ処理結果を返す。
入力検証・Turnstile検証・送信枠の確保のいずれかに失敗したら、SMTP送信へ進まない。SMTPサーバーがメールを受け付けた場合に送信成功を返す。ただし、SMTP受付後も配送先で拒否や隔離が起こり得るため、成功応答は受信箱への到達保証を意味しない。
6. メール送信¶
メールはさくらレンタルサーバーのSMTPを使用する。接続元の固定IP制限はなく、587番または465番でSMTP認証を行う前提である。接続先ホスト名とアカウントの実値は、公開資料と分離して管理する。
| 項目 | 実装方針 |
|---|---|
| 宛先(To) | サーバー設定の1件以上のアドレスへ固定。複数指定はカンマ区切り。To一覧は全受信者に見える。本番用の実値は設定待ち |
| 差出人(From) | サーバー側で固定。SMTPで送信を許可されたアドレスを使用 |
| 返信先(Reply-To) | 検証済みの投稿者メールアドレス |
| 件名 | 【Webお問い合わせ】に許可された種別を続ける |
| 本文 | プレーンテキスト。種別、会社名、お名前、メールアドレス、電話番号、内容を記載 |
| 接続方式 | 587番+STARTTLS、または465番+接続開始時からTLS。使用する方式は未決定 |
| TLS検証 | 証明書と接続先ホスト名を検証し、暗号化できなければ送信を中止 |
| 自動応答 | 投稿者には送信しない |
| 添付ファイル | 受け付けない |
メールヘッダーはSMTPライブラリの機能で組み立てる。入力値を直接連結せず、ヘッダーに使用する値の改行などを検証する。SMTPアカウントはフォーム専用とする方針で、作成の可否は運用担当者に確認する。
複数Toでも1回のSMTP送信、問い合わせ1件として件数を管理する。全宛先の受付を確認できた場合だけ成功とし、一部だけ受け付けられた場合はUNKNOWNとして全体の再送を止める。管理者がSMTP側・各受信先で確認し、既に受信した相手への重複送信を避ける。宛先を設定し直しても、成功済みの同じ受付IDは再送しない。
7. Cloudflare Turnstile¶
Turnstileはbot対策として使用する。利用者の本人確認や、入力されたメールアドレスの所有確認を行うものではない。
ブラウザーでトークンを取得し、選択したバックエンドからSiteverify APIへ検証を要求する。検証結果のsuccessに加え、想定したhostnameとactionに一致することを確認する。検証失敗や検証先への通信障害時は、メールを送信しない。
トークンは発行から5分間有効で、1回だけ検証できる。確認中の期限切れを避けるため、送信直前に取得する方針とする。修正や再送信で新しい検証が必要になった場合は、トークンを再取得する。これらの性質はCloudflareの公式仕様に従う。
サイトキーはブラウザーで使用し、秘密鍵はAWS版ではSecrets Manager、自前版では非公開の設定ファイルで管理する。本番と開発・テストで設定を分け、本番の許可ホスト名を限定する。actionはcontactに固定する。ウィジェットは確認内容の下、ボタンの上に配置し、認証操作が必要な場合に表示する。キーの実値は設定待ちである。
自前版のローカル検証では、画面とAPIの設定でTurnstileを一時的に省略できる。既定は有効とし、公開前に認証を戻す。設定方法は自前版セットアップを参照する。AWS版は引き続き認証を必須とする。
8. 送信件数の制限¶
8.1. 制限する件数¶
DynamoDBまたはSQLiteで、本フォーム経由の送信試行に時間・日単位の上限を設ける。JSTの毎時区切り、毎日0時区切りとし、両方式の設定例の初期値を毎時10件・1日30件に設定する。月100件未満は通常時の利用想定であり、上限値を算出する根拠にはしていない。許容する集中投稿数を確認し、公開前にパラメーターを調整する。
これに加え、IP別の送信試行上限を毎時3件・1日10件の初期値で設ける。IPは信頼する接続情報から取得し、生のIPではなくHMACをカウンターのキーに使う。全体・IP別の4カウンターを同じトランザクションで確保する。共有IPの誤制限と、複数IPから全体上限を消費される制約は受付制限と停止攻撃への対策に従う。
送信枠は入力・Turnstile検証の成功後、SMTP接続前に消費する。一度確保した枠は、SMTP送信に失敗した場合も試行回数として扱い、戻さない方針とする。このため、カウンターは正常に配送されたメール数とは一致しない。
8.2. 同時投稿と期間の更新¶
上限の確認とカウンターの加算は、条件付き更新で一体として行う。AWS版ではTransactWriteItemsで各カウンターをまとめて更新し、一方だけが加算される状態を避ける。DynamoDBのトランザクション仕様に従い、失敗した場合はSMTP送信へ進まない。
カウンターは期間ごとに識別し、新しい期間では別のカウンターを使う。記録は7日保持する。AWS版ではTTL(期限を過ぎた項目を自動削除する機能)を古いデータの整理に使う。上限のリセットにTTLを使わないのは、削除が期限直後に完了する保証がないためである。AWS公式仕様
自前版はSQLiteのBEGIN IMMEDIATEで受付IDと両カウンターを一括更新し、失敗時は全体をロールバックする。起動時と1時間ごとの処理で7日の期限を過ぎたデータを削除する。
カウンターをプロセスのメモリーだけで管理しない。実行環境間で値を共有するため、AWS版はDynamoDB、自前版は同じローカルDBファイルへ集約する。件数管理が利用できない場合は送信を止め、無制限送信へ切り替えない。
8.3. アクセス頻度・同時実行数との役割分担¶
AWS版はAPI Gatewayのスロットリングで短時間の大量アクセスを抑え、Lambdaの同時実行数制限でSMTPへの同時接続を抑える。DynamoDBの件数制限とは対象が異なるため、併用する。API Gatewayのスロットリングはベストエフォートであり、厳密な受付件数の上限には使用しない。API Gateway公式仕様
自前版は公開プロキシでIP別に平均6要求/分・バースト2、同時処理1件に制限し、超過を429で拒否する。APIでは1プロセスあたり同時処理を2件に制限する。NGINXの設定例を実環境へ反映し、信頼するプロキシから実IPを受け取る設定が必要である。AWS版の現行HTTP APIにはWAFを直接関連付けられず、外部照会前のIP別制限には別途構成変更が必要になる。
これらの制限は、SMTPアカウントそのものの送信上限にはならない。認証情報が漏れて外部からSMTPへ直接接続された場合には適用できない。また、送信を拒否したリクエストでもAWSの処理料金は発生し得るため、送信件数の上限と利用料金の上限は分けて管理する。
9. 失敗時の表示と重複送信¶
送信に失敗した場合は入力内容を保持し、利用者が次の操作を判断できる説明を表示する。SMTPの応答や内部例外をそのまま画面へ返さず、原因を分類した結果を返す。処理に失敗した場合は、時間を置く方法や電話での問い合わせを案内する。
| 状況 | 実装方針 |
|---|---|
| 入力不正 | 該当項目を案内し、修正できる状態にする |
| Turnstileの失敗・期限切れ | 検証のやり直しを案内する |
| 送信上限への到達 | 時間を置くか電話で問い合わせる方法を案内する |
| 件数管理・秘密情報取得などの障害 | メールを送らず、一時的な受付不能として案内する |
| SMTPの明確な拒否・接続失敗 | 送信失敗として案内する |
| SMTP受付の成否が不明 | 成功とも未送信とも断定せず、確認方法を案内する |
SMTPが受け付けた後に通信が切れると、バックエンドやブラウザーで成功を確認できない場合がある。SMTPと管理DBを一つのトランザクションにはできないため、無条件の自動再送は行わない。
送信中はボタンを無効にし、APIでは受付IDによる重複管理を行う。同じ入力と受付IDで成功記録が見つかれば、メールを再送せず成功を返す。入力は保存せず、専用秘密値で計算したHMACを照合する。
通信断で結果を取得できなかった場合、画面では同じ受付IDを保持して「受付結果を確認する」を表示する。処理中の記録にはprocessingを返す。成否不明が記録されている場合は送信・修正を停止して電話での確認を促し、明確な送信失敗の場合は次の手動操作で新しい受付IDを発行する。記録は7日保持し、削除後まで重複を判定するものではない。
10. セキュリティと個人情報の扱い¶
SMTP認証情報とTurnstileの秘密鍵はAWS版ではSecrets Manager、自前版では非公開のJSONファイルで管理し、フロントエンドのコード、生成HTML、Gitへ保存しない。Lambdaには必要な秘密情報の取得、件数管理テーブルの更新、ログ出力に限定したIAM権限を付与する。
CORSでは本番サイトのオリジンを指定する。ただし、CORSはブラウザー向けの制約であり、APIへの直接投稿は防げない。サーバーでの入力検証、Turnstile、件数制限を別々に実装する。
氏名・メールアドレス・問い合わせ本文はDynamoDBにもSQLiteにも保存しない。選択したバックエンドとSMTPを経由してメールとして扱い、受信メール側の閲覧権限と保存期間は運用担当者が決める。AWSへ本文を永続保存しない設計でも、処理中はAWSで個人情報を取り扱うため、既存の個人情報に関する説明との整合を公開前に確認する。
ログには本文・氏名・メールアドレス・認証情報・Turnstileトークンを記録しない。例外やSMTPライブラリのデバッグ出力にも同じ方針を適用する。受付ID、処理結果、エラー分類、処理時間など、障害調査に必要な情報を記録する。
11. 運用と監視¶
以下のCloudWatch・SNSはAWS版に適用する。自前版はsystemdと既存の監視基盤でプロセス・処理結果・容量・プロキシ異常を監視する。SQLiteと秘密情報・配置設定のバックアップ、復旧時の送信記録欠損の確認は自前版の手順に従う。
CloudWatchでAPIの異常応答、Lambdaのエラー・スロットリング、SMTP送信失敗、件数制限の発生を監視する。APIの応答として処理済みの失敗は、Lambdaのエラー件数だけでは分からない場合があるため、処理結果のログや必要なメトリクスでも確認する。
異常通知はSNSから管理者へ送る。SMTP失敗・成否不明・依存サービスの障害、Lambdaのエラーとスロットリング、APIの5xxにアラームを設定する。ログは30日、件数と受付状態の記録は7日保持する。通知先の実値と運用上の閾値は公開前に確認し、構築・運用手順に従って通知登録・停止・秘密情報の更新を行う。
12. 未決定事項¶
| 分類 | 実装・公開前に決める内容 |
|---|---|
| メール | To・Fromの実値、フォーム専用アカウントの作成可否 |
| SMTP | 接続先ホスト名、587番または465番の選択、認証情報、HMAC用の秘密値 |
| API | デプロイ後のURL、環境ごとのオリジンと関数名 |
| Turnstile | サイトキーと秘密鍵、環境ごとの許可ホスト名 |
| 件数・負荷制限 | 毎時10件・1日30件、レート毎秒1件・バースト3、同時実行2、45秒タイムアウトの初期値が運用に適するか |
| 障害対応 | 成否不明・処理中の記録が続く場合の管理者の確認手順と担当者 |
| 運用 | AWSアカウントとリージョンの確定、管理者通知先、監視閾値、予算通知、保持期間の運用確認 |
| 個人情報 | 受信メールの閲覧権限と保存期間、個人情報の取扱いに関する説明の確認 |
13. 受入確認¶
現在の画面と今後の送信処理を分けて確認する。以下は受入時の確認項目であり、本仕様書の作成に伴って全項目の試験を実施したことを示すものではない。
13.1. 入力・確認・修正¶
- 必須項目の未入力、空白だけの入力、メール形式の不正、同意の未チェックで確認画面へ進まない。
- エラーは該当欄の下へ表示され、確認操作時に最初のエラー欄へフォーカスが移る。
- 各項目の長さの上限と、種別の選択肢が仕様と一致する。
- 確認画面で改行と任意項目の「未入力」が表示され、HTMLを含む入力も文字列として扱われる。
- 修正操作後も全項目と同意状態が残り、先頭の入力欄へ戻る。
- PC・スマートフォン、ライト・ダーク、キーボード操作で利用できる。
- JavaScript無効時に確認・送信へ進まず、電話の案内を表示する。
13.2. 送信機能の実装後¶
- 正常な投稿で設定した全To宛先にメールが届き、投稿者へ自動返信されない。複数宛先でも問い合わせ1件として送信枠を消費する。
- Fromは固定され、Reply-Toと本文が入力内容に対応する。
- APIへ直接投稿した場合も、入力不正・未同意・不正な種別・サイズ超過を拒否する。
- Turnstileの不正・期限切れ・再利用・想定外のhostnameやactionを拒否する。
- 件数制限の上限直前に同時投稿しても、確保する送信枠が上限を超えない。
- 複数期間のいずれかが上限に達した場合、カウンターが部分的に更新されない。
- 期間の切替、古いカウンターの削除遅延、DynamoDBの障害を確認する。
- SMTP認証失敗、TLS検証失敗、タイムアウトで成功表示しない。
- SMTP受付後の通信切断で、確定した再送方針どおりに動作する。
- 秘密情報と個人情報が、生成ファイル・API応答・ログ・通知へ意図せず含まれない。
- 監視通知、送信停止・再開、秘密情報の更新手順を確認する。
14. 実装と関連資料¶
| 資料・ソース | 用途 |
|---|---|
| 入力・確認画面 | 現在の項目、検証、確認・修正操作 |
| 画面側の送信処理 | Turnstileの取得、API呼び出し、処理結果の表示 |
| 送信API | 受付・検証・重複確認・SMTP送信の処理順序 |
| AWS構築定義 | API、Lambda、DynamoDB、監視・通知・権限 |
| AWSセットアップ/設定・運用リファレンス | 初回構築、秘密情報、設定、監視・停止 |
| 自前版セットアップ/手動更新 | アプリサーバー構築、更新・切り戻し |
| API共通仕様 | 要求・応答、件数制限、再試行 |
| フォームのスタイル | 配色、入力欄、ボタン、余白 |
| 共通レイアウト | ヘッダー・モバイルメニュー・フッターからの導線 |
| 商品情報ページ | 商品情報配下からの問い合わせ導線 |
| システム構成図 | 採用予定のサービスと接続関係 |
| 構成図の説明 | 前提、図の省略事項、生成方法 |