docs: add security options for TLS verification and unsafe HTML handling

Author: canaria-computer

doc/app-behavior-config.md

@@ -86,6 +86,30 @@ email:
     uri: "smtp://user@example.com:password@smtp.example.com:587"
     secure: "STARTTLS" # "None", "SSL", "STARTTLS"  
   mime-type: "text/plain" # "text/plain", "multipart/alternative" (HTMLへの変換は自動的に行います。)
+  
+  # セキュリティオプション (開発環境専用、詳細は下記セクション参照)
+  security:
+    ignore_tls_errors: false # TLS証明書検証をスキップ
+    allow_unsafe_html: false # HTMLサニタイゼーションを無効化
+```
+
+### Email セキュリティオプション
+
+次の機能は、セキュリティの一部を意図的に無効化するものです。
+その危険性を理解している場合のみ有効にしてください。
+
+#### `email.security.ignore_tls_errors`
+
+SMTP/IMAP接続時のTLS/SSL証明書検証をスキップします。
+自己署名証明書、証明書が期限切れのテスト用途としての場合に使用します。
+
+#### `email.security.allow_unsafe_html`
+
+Markdownメールに埋め込むHTMLコンテンツのサニタイゼーションを無効化します。
+この機能を無効化する場合には、細心の注意を払って送信するメールペイロードを確認してください。
+悪意あるコンテンツは、配信された場合あなただけでなく他の第三者にも被害を及ぼす可能性があるほか、
+あなたのドメインやメールアドレス、IPアドレスの評判が損なわれる可能性もあります。
+
 ```
 
 ## 2. 環境変数マッピング
@@ -128,6 +152,14 @@ CI/CDパイプラインやコンテナ環境での利用を想定し、すべて
 | `reporter.consent.share_with_third_parties`  | `DOWNFORCE_CONSENT_SHARE_THIRD` | 第三者共有の同意 (true/false)   |
 | `reporter.consent.identity_to_third_parties` | `DOWNFORCE_CONSENT_ID_THIRD`    | 第三者への身元開示 (true/false) |
 
+### Email セキュリティ
+
+| YAMLキー                           | 環境変数                                     | デフォルト | 説明                           |
+| ---------------------------------- | -------------------------------------------- | ---------- | ------------------------------ |
+| `email.security.ignore_tls_errors` | `DOWNFORCE_EMAIL_SECURITY_IGNORE_TLS_ERRORS` | `false`    | TLS証明書検証をスキップ        |
+| `email.security.allow_unsafe_html` | `DOWNFORCE_EMAIL_SECURITY_ALLOW_UNSAFE_HTML` | `false`    | HTMLサニタイゼーションを無効化 |
+
+
 ## 3. 参照
 
 - ターゲット設定: `evidence.yaml` (コマンドライン引数 `-c` で指定)

internal/appconfig/config.template.yaml

@@ -72,24 +72,7 @@ email:
     secure: "" # "None", "SSL", "STARTTLS"
   mime_type: "text/plain" # "text/plain", "multipart/alternative" (HTMLへの変換は自動的に行います。)
 
-  # セキュリティオプション
-  # これらのオプションは開発環境でのテストやトラブルシューティング用です。
-  # 本番環境では絶対に有効にしないでください。
+  # セキュリティオプション (開発環境専用、詳細はドキュメント参照)
   security:
-    # ignore_tls_errors: 自己署名証明書やTLS検証エラーを無視する
-    # WARNING: TLS/SSL証明書の検証をスキップします。
-    # 中間者攻撃の対象になるため、開発環境でのみ使用してください。
-    # 使用例: DOWNFORCE_EMAIL_SECURITY_IGNORE_TLS_ERRORS=true
-    ignore_tls_errors: false # default: false (TLS検証は強制)
-
-    # allow_unsafe_html: Markdownで埋め込むHTMLのサニタイゼーションを無効化する
-    # WARNING: 信頼できないソースからのHTMLが埋め込まれた場合、
-    # XSS (クロスサイトスクリプティング) などのセキュリティリスクが生じます。
-    # HTMLコンテンツのソースが完全に信頼できる場合のみ有効にしてください。
-    # 使用例: DOWNFORCE_EMAIL_SECURITY_ALLOW_UNSAFE_HTML=true
-    allow_unsafe_html: false # default: false (HTML自動エスケープ)
-
-# 環境変数による設定例:
-# export DOWNFORCE_EMAIL_SECURITY_IGNORE_TLS_ERRORS=true
-# export DOWNFORCE_EMAIL_SECURITY_ALLOW_UNSAFE_HTML=true
-# down-force email draft --preview
+    ignore_tls_errors: false # TLS証明書検証をスキップ (WARNING: 開発環境のみ)
+    allow_unsafe_html: false # HTMLサニタイゼーションを無効化 (WARNING: XSSリスク)