From 4f1ef6b672e420d7aa40a483d5e36438ae19fd34 Mon Sep 17 00:00:00 2001
From: nishi_74322014 <nishi_74322014@ksj.biglobe.ne.jp>
Date: Sat, 15 Aug 2026 13:33:46 +0900
Subject: [PATCH 1/5] fixing #541

---
 .../MVC_Sample/MVC_Sample/Web.config          |  27 +++
 root/programs/CS/Samples4NetCore/ANALYSIS.md  |  72 ++++++++
 .../Backend/MVC_Sample/MVC_Sample/Startup.cs  | 169 ++++++++++++++++--
 .../MVC_Sample/MVC_Sample/appsettings.json    |  37 ++++
 4 files changed, 291 insertions(+), 14 deletions(-)

diff --git a/root/programs/CS/Samples/WebApp_sample/MVC_Sample/MVC_Sample/Web.config b/root/programs/CS/Samples/WebApp_sample/MVC_Sample/MVC_Sample/Web.config
index fbeaf2b1a..54fa77ef1 100644
--- a/root/programs/CS/Samples/WebApp_sample/MVC_Sample/MVC_Sample/Web.config
+++ b/root/programs/CS/Samples/WebApp_sample/MVC_Sample/MVC_Sample/Web.config
@@ -10,6 +10,14 @@
       <section name="pages" type="System.Web.WebPages.Razor.Configuration.RazorPagesSection, System.Web.WebPages.Razor, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" requirePermission="false"/>
     </sectionGroup>
   </configSections>
+  <!--
+    **パスワードが直に書いてあるのは、すぐ動かせるサンプルだからである。**（#541）
+    実際の環境へ持って行くときは、ここに書かず、次のいずれかで渡すこと。
+      ・別ファイルへ逃がす　　<connectionStrings configSource="connections.config" />
+      ・暗号化する　　　　　　aspnet_regiis -pef connectionStrings <パス>
+      ・統合認証にする　　　　Integrated Security=SSPI（パスワード自体を無くす）
+    netcore 側（Samples4NetCore の appsettings.json）にも同じ注記がある。
+  -->
   <connectionStrings>
     <!-- SQL Server / SQL Client用 -->
     <add name="ConnectionString_SQL" connectionString="Data Source=localhost;Initial Catalog=Northwind;User ID=sa;Password=seigi@123;Encrypt=false;"/>
@@ -64,6 +72,25 @@
             of SQL Server (including SQL Azure and SQL  Compact) instead of to SQL Server Express.
       -->
     <sessionState cookieName="mvc_session" timeout="20" cookieless="false" mode="StateServer" stateConnectionString="tcpip=127.0.0.1:42424"/>
+    <!--
+      **Web サーバを複数台にするなら machineKey も要る。**（#541）
+
+      セッションを StateServer や SQLServer に外出ししても、それだけでは足りない。
+      認証 Cookie（forms）と ViewState は machineKey で保護されており、
+      **指定しないとサーバごとに別の鍵が自動生成される。**
+      台数を増やした途端、片方が発行した Cookie をもう片方が復号できず、
+      ログインし直しや「ビューステートの検証に失敗しました」になる。
+
+      サンプルは 1 台で動かすため、既定（自動生成）のままにしてある。
+      複数台にするときは、全台で同じ値を書くこと。
+
+      <machineKey validationKey="＜同じ値＞" decryptionKey="＜同じ値＞"
+                  validation="HMACSHA256" decryption="AES" />
+
+      netcore 側では DataProtection の鍵が同じ役割を持つ
+      （Samples4NetCore の appsettings.json : DataProtectionKeyPath）。
+    -->
+    <!--<machineKey validationKey="..." decryptionKey="..." validation="HMACSHA256" decryption="AES"/>-->
     <!--
       SQLサーバ（利用の際は、以下のスクリプトを実行する）
       C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727
diff --git a/root/programs/CS/Samples4NetCore/ANALYSIS.md b/root/programs/CS/Samples4NetCore/ANALYSIS.md
index b44e5b305..14c6808dc 100644
--- a/root/programs/CS/Samples4NetCore/ANALYSIS.md
+++ b/root/programs/CS/Samples4NetCore/ANALYSIS.md
@@ -262,6 +262,78 @@ net48 の `app.config` → Core は `appsettings.json`。**`appSettings` / `conn
   **定義ファイルを追加したら csproj にもコピー指定を足す**必要がある。
 - `Backend/MVC_Sample` は Web SDK なので `appsettings.json` は自動でコピーされる。
 
+### 5-1. 環境を移すときに変える値（#541）
+
+**`appsettings.json` の値は、環境変数でそのまま上書きできる。** 区切りは `__`（下線 2 つ）。
+
+```
+appSettings__FxXMLSPDefinition=/app/files/resource/XML/SPDefinition.xml
+connectionStrings__ConnectionString_SQL=Data Source=db;...
+```
+
+`Backend/MVC_Sample` は `Host.CreateDefaultBuilder` を使っており、これが環境変数を
+構成に含める。`Startup` はその `IConfiguration` を
+`GetConfigParameter.InitConfiguration` へ渡すので、**フレームワーク側から読む値にも効く。**
+
+> **`FxContainerization` は要らない。**
+> あちらは ON のとき「接頭辞なしのキー名」で環境変数を読む別の仕組みである。
+> 上の `appSettings__` 方式とは経路が違うので、混同しないこと。
+
+`Backend/MVC_Sample` には、環境ごとに変えたい設定を `appSettings` のキーで
+切り替える口を用意してある。**既定値はいずれも従来どおりの動作**（サンプルは
+平文 HTTP で動かすため）。
+
+| キー | 既定 | 効果 |
+|---|---|---|
+| `UseHttpsRedirection` | `off` | `on` で `app.UseHttpsRedirection()` を挟む |
+| `CookieSecurePolicy` | (空) | `always` で Cookie に `Secure` を必ず付ける |
+| `DataProtectionKeyPath` | (空) | データ保護の鍵を、指定フォルダへ永続化する |
+
+### 5-2. この 3 つで踏むこと（実測）
+
+**① `UseHttpsRedirection` は、on にしただけでは何もしない。**
+
+リダイレクト先のポートが決まらないと、警告を 1 行出して素通りする。
+**有効にしたのに HTTP のまま 200 が返る**ので、気付きにくい。
+
+```
+warn: Microsoft.AspNetCore.HttpsPolicy.HttpsRedirectionMiddleware[3]
+      Failed to determine the https port for redirect.
+```
+
+ポートは、https の URL をバインドするか、次の環境変数で与える。
+
+| 環境変数 | 結果（実測） |
+|---|---|
+| `ASPNETCORE_HTTPS_PORT=44399`（**単数**） | 307 `Location: https://localhost:44399/...` |
+| `HTTPS_PORT=44399` | 307（同上） |
+| `ASPNETCORE_HTTPS_PORTS=44399`（**複数**） | **効かない**（200 のまま） |
+
+複数形は Kestrel が待ち受けるポートを決めるもので、**このミドルウェアが読むのは単数形。**
+
+**② `CookieSecurePolicy=always` を平文 HTTP でやると、ログインできなくなる。**
+
+Antiforgery の Cookie も返らなくなるため、症状は
+**「ログイン画面は出るが、POST が 400」**になる（実測）。
+
+**③ データ保護は `AddCookie` ではなくアプリ全体に設定する。**
+
+`AddCookie` の `options.DataProtectionProvider` は**認証 Cookie にしか効かない。**
+セッションと Antiforgery も同じ鍵を使うので、`services.AddDataProtection()` 側に置く。
+
+```csharp
+services.AddDataProtection()
+    .PersistKeysToFileSystem(new DirectoryInfo(keyPath))
+    .SetApplicationName("MVC_Sample");   // 既定はコンテンツ ルートのパス由来
+```
+
+**`SetApplicationName` も要る。** 既定のアプリケーション名はコンテンツ ルートのパスから
+決まるため、鍵を共有していても**配置先のパスが違うと復号できない**
+（Windows の `C:\...` とコンテナの `/app` など）。
+
+net48 側の対応物は `machineKey` である（`Samples/WebApp_sample/MVC_Sample` の
+`Web.config` にコメントで記載）。
+
 ---
 
 ## 6. ビルド
diff --git a/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/Startup.cs b/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/Startup.cs
index cc47441dc..8e128518b 100644
--- a/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/Startup.cs
+++ b/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/Startup.cs
@@ -15,8 +15,37 @@
 //*  日時        更新者            内容
 //*  ----------  ----------------  -------------------------------------------------
 //*  20xx/xx/xx  ＸＸ ＸＸ         ＸＸＸＸ
+//*  2026/08/15  玄人 幸道         環境を移しても動くように整理（#541）。
+//*                                本番向けの設定を、コメントアウトではなく
+//*                                appsettings.json の値で切り替える形にした。
 //**********************************************************************************
 
+// ＜設定で切り替えるもの＞（#541）
+//
+//   本番でだけ有効にしたい設定を「コメントアウトして置いておく」と、
+//   環境を移すときにソースを書き換えることになる。
+//   appsettings.json（および環境変数）で切り替えられるようにしてある。
+//
+//   | キー（appSettings）      | 既定   | on にすると |
+//   |--------------------------|--------|-------------|
+//   | UseHttpsRedirection      | off    | HTTP を HTTPS へリダイレクトする |
+//   | CookieSecurePolicy       | (空)   | always で Cookie に Secure 属性を必ず付ける |
+//   | DataProtectionKeyPath    | (空)   | データ保護の鍵を、指定フォルダに永続化する |
+//
+//   **既定値は、いずれも従来どおりの動作**である。
+//
+// ＜環境変数で上書きできる＞
+//
+//   Host.CreateDefaultBuilder が環境変数を構成に含めるため、
+//   appsettings.json の値は環境変数で上書きできる。区切りは「__」（下線 2 つ）。
+//
+//     appSettings__UseHttpsRedirection=on
+//     appSettings__FxXMLSPDefinition=/app/files/resource/XML/SPDefinition.xml
+//     connectionStrings__ConnectionString_SQL=...
+//
+//   **FxContainerization は要らない。** あちらは「接頭辞なしのキー名」で
+//   環境変数を読む別の仕組みで、ON にしたときだけ効く。
+
 using System;
 using System.IO;
 
@@ -92,7 +121,33 @@ public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
                 // The default HSTS value is 30 days.
                 // You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
                 app.UseHsts();
-                //app.UseHttpsRedirection();
+            }
+
+            // HTTPS へのリダイレクト（#541）
+            //
+            //   **既定は off。** 平文 HTTP で動かす環境（疎通確認や、
+            //   TLS を前段のリバース プロキシで終端する構成）でリダイレクトすると、
+            //   到達できなくなるため。
+            //   TLS を自分で終端するなら on にする。
+            //
+            //   **on にするだけでは足りない。リダイレクト先のポートも要る。**
+            //   決められないと、ミドルウェアは警告を出すだけで素通りする
+            //   （見落としやすい。有効にしたのに HTTP のまま通ってしまう）。
+            //
+            //     warn: ...HttpsRedirectionMiddleware[3]
+            //           Failed to determine the https port for redirect.
+            //
+            //   ポートは、次のいずれかで決まる。
+            //     ・https の URL を Kestrel にバインドする（--urls に https://... を含める）
+            //     ・環境変数 ASPNETCORE_HTTPS_PORT=443（単数）
+            //     ・環境変数 HTTPS_PORT=443
+            //
+            //   **ASPNETCORE_HTTPS_PORTS（複数）では決まらない。**
+            //   あちらは Kestrel が「どのポートで待ち受けるか」を決めるもので、
+            //   このミドルウェアが読むのは単数形の方である。紛らわしいので注意。
+            if (Startup.IsOn("UseHttpsRedirection"))
+            {
+                app.UseHttpsRedirection();
             }
 
             // HttpContextのマイグレーション用
@@ -103,12 +158,12 @@ public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
             app.UseStaticFiles();
 
             // Cookieを使用する。
-            app.UseCookiePolicy(new CookiePolicyOptions()
-            {
-                HttpOnly = HttpOnlyPolicy.Always,
-                MinimumSameSitePolicy = SameSiteMode.Strict,
-                //Secure= CookieSecurePolicy.Always
-            });
+            //
+            // **引数を渡さない。**（#541）
+            //   引数を渡すと、ConfigureServices の services.Configure(CookiePolicyOptions)
+            //   が使われなくなる。以前は両方に書いてあり、**DI 側は効いていなかった。**
+            //   設定は ConfigureServices 側に一本化してある。
+            app.UseCookiePolicy();
 
             // Sessionを使用する。
             app.UseSession(new SessionOptions()
@@ -117,7 +172,9 @@ public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
                 IOTimeout = TimeSpan.FromSeconds(30),
                 Cookie = new CookieBuilder()
                 {
-                    Expiration = TimeSpan.FromDays(1), // 効かない
+                    // **Expiration は書かない。**（#541）
+                    //   セッション Cookie は有効期限を持たない（ブラウザを閉じると消える）ため、
+                    //   指定しても無視される。持続時間を変えたいなら上の IdleTimeout を使う。
                     HttpOnly = true,
                     Name = "mvc_session",
                     Path = "/",
@@ -157,17 +214,45 @@ public void ConfigureServices(IServiceCollection services)
             // HttpContextのマイグレーション用
             services._AddHttpContextAccessor();
 
+            // Cookie ポリシー（#541）
+            //
+            //   Configure 側の app.UseCookiePolicy() が、ここの設定を使う。
+            //   **以前は Configure 側で引数を渡しており、ここは効いていなかった。**
             services.Configure<CookiePolicyOptions>(options =>
             {
-                // This lambda determines whether user consent
-                // for non-essential cookies is needed for a given request.
-                options.CheckConsentNeeded = context => true;
+                options.HttpOnly = HttpOnlyPolicy.Always;
+                options.MinimumSameSitePolicy = SameSiteMode.Strict;
+
+                // Cookie の Secure 属性（既定は空＝各 Cookie の設定に従う）
+                //
+                //   TLS で公開するなら always にする。
+                //   平文 HTTP の環境で always にすると、**Cookie が送られず
+                //   ログインできなくなる**ので、既定では変えない。
+                //   （Antiforgery の Cookie も返らなくなるため、
+                //   　症状は「ログイン画面は出るが POST が 400」になる）
+                if (Startup.GetValue("CookieSecurePolicy").ToLower() == "always")
+                {
+                    options.Secure = CookieSecurePolicy.Always;
+                }
+
+                // ＜同意の確認は既定で無効＞
+                //   options.CheckConsentNeeded = context => true; と書いてあったが、
+                //   上記のとおり効いていなかった。**有効にすると、同意前は
+                //   必須でない Cookie（セッションを含む）が送られなくなる**ため、
+                //   挙動が変わる。必要な画面を用意したうえで有効にすること。
             });
 
             // Sessionのモード
+            //
+            // **AddDistributedMemoryCache はプロセス内に持つ。**（#541）
+            //   名前に反して分散しない。次のいずれかに当てはまるなら、
+            //   外部のストアに替えないとセッションが失われる。
+            //     ・インスタンスを複数立てる（ロード バランサの配下など）
+            //     ・コンテナを作り直す・再起動する
+            //   net48 側の WebForms_Sample / MVC_Sample が StateServer を使うのと同じ論点である。
             services.AddDistributedMemoryCache(); // 開発用
-            //services.AddDistributedSqlServerCache();
-            //services.AddDistributedRedisCache();
+            //services.AddDistributedSqlServerCache();   // Microsoft.Extensions.Caching.SqlServer
+            //services.AddStackExchangeRedisCache();     // Microsoft.Extensions.Caching.StackExchangeRedis
 
             // Sessionを使用する。
             services.AddSession();
@@ -215,12 +300,68 @@ public void ConfigureServices(IServiceCollection services)
                 options.ExpireTimeSpan = TimeSpan.FromHours(1);
                 options.SlidingExpiration = true;
                 options.Cookie.HttpOnly = true;
-                //options.DataProtectionProvider = DataProtectionProvider.Create(new DirectoryInfo(@"C:\artifacts"));
+
+                // ここに options.DataProtectionProvider を書くと、
+                // **認証 Cookie にしか効かない。**（#541）
+                // セッションや Antiforgery も同じ鍵を使うので、
+                // 下の AddDataProtection でアプリ全体に設定している。
             });
 
+            // データ保護の鍵の置き場所（#541）
+            //
+            //   認証 Cookie・セッション・Antiforgery トークンは、この鍵で保護されている。
+            //   **鍵が変わると、既存の Cookie が読めなくなり、ログインし直しになる。**
+            //   既定の置き場所はプロセスの環境に依存する（下は Windows の例）ため、
+            //     ・コンテナを作り直す
+            //     ・インスタンスを複数立てる
+            //   と鍵が揃わない。永続化・共有する場所を指定できるようにしてある。
+            //
+            //     info: ...XmlKeyManager[63]
+            //           User profile is available. Using
+            //           'C:\Users\＜user＞\AppData\Local\ASP.NET\DataProtection-Keys'
+            //           as key repository ...
+            //
+            //   既定は空＝従来どおり（指定しない）。
+            string keyPath = Startup.GetValue("DataProtectionKeyPath");
+
+            if (!string.IsNullOrEmpty(keyPath))
+            {
+                services.AddDataProtection()
+                    .PersistKeysToFileSystem(new DirectoryInfo(keyPath))
+                    // **アプリケーション名も固定する。**
+                    //   既定ではコンテンツ ルートのパスから決まるため、
+                    //   鍵を共有していても**配置先のパスが違うと復号できない**。
+                    //   （Windows の C:\... とコンテナの /app など）
+                    .SetApplicationName("MVC_Sample");
+            }
+
             #endregion
         }
 
         #endregion
+
+        #region 設定の読み取り
+
+        /// <summary>appSettings の値を取得する（無ければ空文字）</summary>
+        /// <param name="key">キー</param>
+        /// <returns>値</returns>
+        /// <remarks>
+        /// 環境変数 appSettings__＜キー＞ でも上書きできる（#541）。
+        /// Host.CreateDefaultBuilder が環境変数を構成に含めるため。
+        /// </remarks>
+        private static string GetValue(string key)
+        {
+            return GetConfigParameter.GetConfigValue(key) ?? "";
+        }
+
+        /// <summary>appSettings の値が on かを判定する</summary>
+        /// <param name="key">キー</param>
+        /// <returns>on なら true</returns>
+        private static bool IsOn(string key)
+        {
+            return Startup.GetValue(key).ToLower() == "on";
+        }
+
+        #endregion
     }
 }
diff --git a/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/appsettings.json b/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/appsettings.json
index 235c8f464..55f83c319 100644
--- a/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/appsettings.json
+++ b/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/appsettings.json
@@ -7,6 +7,12 @@
   },
   "AllowedHosts": "*",
   // connectionStrings section
+  //
+  // **パスワードが直に書いてあるのは、すぐ動かせるサンプルだからである。**（#541）
+  //   実際の環境へ持って行くときは、ここに書かず、次のいずれかで渡すこと。
+  //     ・環境変数            connectionStrings__ConnectionString_SQL=...
+  //     ・ユーザー シークレット（開発時） dotnet user-secrets set ...
+  //     ・シークレット ストア（本番）
   "connectionStrings": {
     "ConnectionString_SQL": "Data Source=localhost;Initial Catalog=Northwind;User ID=sa;Password=seigi@123;Encrypt=false;",
     "ConnectionString_ODBC": "Dsn=odbc_test1",
@@ -16,10 +22,41 @@
   },
 
   // appSettings section
+  //
+  // ＜環境を移すとき＞（#541）
+  //   ここの値は、環境変数で上書きできる。区切りは「__」（下線 2 つ）。
+  //
+  //     appSettings__FxXMLSPDefinition=/app/files/resource/XML/SPDefinition.xml
+  //     connectionStrings__ConnectionString_SQL=Data Source=db;...
+  //
+  //   Host.CreateDefaultBuilder が環境変数を構成に含めるため、
+  //   **FxContainerization を on にしなくても効く**
+  //   （あちらは「接頭辞なしのキー名」で読む別の仕組み）。
+  //
+  //   下の C:/root/... は、このリポジトリを Windows に展開したときの配置である。
+  //   コンテナや別の環境へ移すときは、上記の環境変数で差し替える。
   "appSettings": {
     // Webサービス用
     //"Azure": "MVC_Sample",
 
+    // 本番向けの切り替え（既定はいずれも従来どおりの動作） - start
+
+    // HTTP を HTTPS へリダイレクトするか（on / off）
+    // TLS を前段のリバース プロキシで終端する構成では off のままにする。
+    // **on にするだけでは足りない。** リダイレクト先のポートが決まらないと、
+    // 警告を出すだけで素通りする。https の URL をバインドするか、
+    // 環境変数 ASPNETCORE_HTTPS_PORT=443（単数）を併せて指定する。
+    "UseHttpsRedirection": "off",
+    // Cookie に Secure 属性を必ず付けるか（always / 空）
+    // **平文 HTTP の環境で always にすると、Cookie が送られずログインできない。**
+    "CookieSecurePolicy": "",
+    // データ保護の鍵の置き場所（空なら既定＝プロセスの環境に依存する場所）
+    // **コンテナを作り直す／複数インスタンスで動かす場合は、共有できる場所を指定する。**
+    // 指定しないと鍵が揃わず、認証 Cookie とセッションが失効する。
+    "DataProtectionKeyPath": "",
+
+    // 本番向けの切り替え - end
+
     // フレームワークの使用するパラメータ - start
     // 基盤画面パス"
     "FxErrorScreenPath": "/Error/Index",

From e16d4a827e73579f5af26ee3251e5f8738bf6944 Mon Sep 17 00:00:00 2001
From: nishi_74322014 <nishi_74322014@ksj.biglobe.ne.jp>
Date: Sat, 15 Aug 2026 17:36:40 +0900
Subject: [PATCH 2/5] fixed #548

---
 root/programs/CS/Samples4NetCore/ANALYSIS.md  |  12 +-
 .../CS/Samples4NetCore/Docker/.dockerignore   |  12 +
 .../CS/Samples4NetCore/Docker/.gitignore      |   6 +
 .../CS/Samples4NetCore/Docker/0_SetupCert.ps1 | 104 ++++++++
 .../Samples4NetCore/Docker/1_PublishAndUp.bat |  65 +++++
 .../CS/Samples4NetCore/Docker/2_Down.bat      |  17 ++
 .../CS/Samples4NetCore/Docker/Dockerfile      |  40 ++++
 .../CS/Samples4NetCore/Docker/README.md       | 225 ++++++++++++++++++
 .../Docker/appsettings.Container.json         |  53 +++++
 .../Docker/conf/SampleLogConf.xml             | 104 ++++++++
 .../Samples4NetCore/Docker/docker-compose.yml |  76 ++++++
 11 files changed, 713 insertions(+), 1 deletion(-)
 create mode 100644 root/programs/CS/Samples4NetCore/Docker/.dockerignore
 create mode 100644 root/programs/CS/Samples4NetCore/Docker/.gitignore
 create mode 100644 root/programs/CS/Samples4NetCore/Docker/0_SetupCert.ps1
 create mode 100644 root/programs/CS/Samples4NetCore/Docker/1_PublishAndUp.bat
 create mode 100644 root/programs/CS/Samples4NetCore/Docker/2_Down.bat
 create mode 100644 root/programs/CS/Samples4NetCore/Docker/Dockerfile
 create mode 100644 root/programs/CS/Samples4NetCore/Docker/README.md
 create mode 100644 root/programs/CS/Samples4NetCore/Docker/appsettings.Container.json
 create mode 100644 root/programs/CS/Samples4NetCore/Docker/conf/SampleLogConf.xml
 create mode 100644 root/programs/CS/Samples4NetCore/Docker/docker-compose.yml

diff --git a/root/programs/CS/Samples4NetCore/ANALYSIS.md b/root/programs/CS/Samples4NetCore/ANALYSIS.md
index 14c6808dc..52d7336d6 100644
--- a/root/programs/CS/Samples4NetCore/ANALYSIS.md
+++ b/root/programs/CS/Samples4NetCore/ANALYSIS.md
@@ -10,13 +10,14 @@
 
 ## 1. これは何か
 
-Open棟梁の **.NET (Core) 系サンプル**。3 つの区画に分かれており、性格がまったく違う。
+Open棟梁の **.NET (Core) 系サンプル**。4 つの区画に分かれており、性格がまったく違う。
 
 | 区画 | 中身 | 性格 |
 |---|---|---|
 | **`Backend/`** | `MVC_Sample`（ASP.NET Core MVC） | **現行の推奨サンプル。** ここが本命 |
 | **`Frontend/`** | README のみ | 別リポジトリ `FrontendTemplates` へ移動済み |
 | **`Legacy/`** | `2CS_sample` / `Bat_sample` / `CLI_sample` / `WS_sample` | `../Samples`（net48）を .NET へ移植した**独立コピー**。名前どおり「レガシー」扱い |
+| **`Docker/`** | `Backend/MVC_Sample` を Linux コンテナで動かす一式 | サンプルのコードは持たない。**手順と設計は [`Docker/README.md`](Docker/README.md)**（#548） |
 
 **全プロジェクトが SDK 形式 csproj / `net10.0`（GUI は `net10.0-windows7.0`）。**
 
@@ -334,6 +335,15 @@ services.AddDataProtection()
 net48 側の対応物は `machineKey` である（`Samples/WebApp_sample/MVC_Sample` の
 `Web.config` にコメントで記載）。
 
+### 5-3. コンテナで動かす場合は `Docker/` を見る（#548）
+
+`Backend/MVC_Sample` を Linux コンテナで動かす一式が `Docker/` にある。
+**手順・設計・落とし穴は [`Docker/README.md`](Docker/README.md) が一次情報**で、ここには書かない。
+
+上の 5-1 / 5-2 で書いた `%OT_RESOURCE_ROOT%` と 3 つの切り替えを、実際に使っている
+（`appsettings.Container.json` ＋ `docker-compose.yml` の環境変数）。
+`appsettings.{環境名}.json` が**キー単位のオーバーライド**である点も、あちらに書いてある。
+
 ---
 
 ## 6. ビルド
diff --git a/root/programs/CS/Samples4NetCore/Docker/.dockerignore b/root/programs/CS/Samples4NetCore/Docker/.dockerignore
new file mode 100644
index 000000000..45fac3788
--- /dev/null
+++ b/root/programs/CS/Samples4NetCore/Docker/.dockerignore
@@ -0,0 +1,12 @@
+# ビルド コンテキストから除くもの（#548）
+#
+# **https/ は必ず除く。** 秘密鍵をイメージに焼かないため。
+# 証明書は実行時にボリュームでマウントする（docker-compose.yml）。
+https/
+
+# 手順・スクリプトはイメージに要らない
+README.md
+*.bat
+*.ps1
+.gitignore
+.dockerignore
diff --git a/root/programs/CS/Samples4NetCore/Docker/.gitignore b/root/programs/CS/Samples4NetCore/Docker/.gitignore
new file mode 100644
index 000000000..7be6e4754
--- /dev/null
+++ b/root/programs/CS/Samples4NetCore/Docker/.gitignore
@@ -0,0 +1,6 @@
+# dotnet publish の成果物（1_PublishAndUp.bat が作る）
+publish/
+
+# HTTPS の開発用証明書と秘密鍵（0_SetupCert.ps1 が作る）
+# **秘密鍵をリポジトリに入れない。**
+https/
diff --git a/root/programs/CS/Samples4NetCore/Docker/0_SetupCert.ps1 b/root/programs/CS/Samples4NetCore/Docker/0_SetupCert.ps1
new file mode 100644
index 000000000..137f537d4
--- /dev/null
+++ b/root/programs/CS/Samples4NetCore/Docker/0_SetupCert.ps1
@@ -0,0 +1,104 @@
+<#
+.SYNOPSIS
+    HTTPS の開発用証明書を、PEM 形式で書き出す（#548）。
+
+.DESCRIPTION
+    ＜パスワードを持たせない＞
+
+    参照元（ASPNETMVCOnDocker）は PFX ＋ .env の CERT_PASSWORD を使うが、
+    ここでは PEM ＋ 秘密鍵ファイルにして、**パスワードという管理対象を無くす**。
+
+      ・.env が要らない（平文パスワードのファイルを作らない）
+      ・compose での ${CERT_PASSWORD} 展開が要らない
+      ・初回に決めるパスワードが無い
+
+    守る対象は localhost 限定・自己署名・1 年で失効する開発用証明書であり、
+    本番の TLS は前段のリバース プロキシが終端する想定である（README 参照）。
+    PFX ＋ パスワードにしても、結局 PFX とパスワードの両方がホストに置かれるので、
+    実質の防御力は変わらない。守るのはファイルの権限である。
+
+    ＜出力＞
+      .\https\aspnetapp.pem   証明書
+      .\https\aspnetapp.key   秘密鍵（**リポジトリには含めない。.gitignore 済み**）
+
+.PARAMETER SkipTrust
+    証明書を信頼済みにする手順（dotnet dev-certs https --trust）を省く。
+    ブラウザで警告が出てもよい場合や、確認ダイアログを出したくない場合に指定する。
+
+.EXAMPLE
+    powershell -NoProfile -ExecutionPolicy Bypass -File .\0_SetupCert.ps1
+
+.NOTES
+    Windows PowerShell 5.1 / PowerShell 7 の両方で動く。
+#>
+param(
+    [switch]$SkipTrust
+)
+
+$ErrorActionPreference = "Stop"
+
+$httpsDir = Join-Path $PSScriptRoot "https"
+$pemPath  = Join-Path $httpsDir "aspnetapp.pem"
+$keyPath  = Join-Path $httpsDir "aspnetapp.key"
+
+Write-Host "============================================"
+Write-Host "  HTTPS 開発用証明書のセットアップ（PEM）"
+Write-Host "============================================"
+Write-Host ""
+
+if (-not (Test-Path $httpsDir))
+{
+    New-Item -ItemType Directory -Path $httpsDir | Out-Null
+}
+
+# ------------------------------------------------------------------
+# PEM 形式で書き出す
+# ------------------------------------------------------------------
+# -np（--no-password）を付けるので、パスワードの入力は無い。
+Write-Host "[1/2] 証明書を PEM で書き出す ..."
+dotnet dev-certs https --format Pem -ep $pemPath -np
+
+if ($LASTEXITCODE -ne 0)
+{
+    Write-Host "[エラー] 証明書の書き出しに失敗しました。" -ForegroundColor Red
+    exit 1
+}
+
+if (-not (Test-Path $pemPath) -or -not (Test-Path $keyPath))
+{
+    # 終了コードだけでは判断しない（生成物の存在も確認する）。
+    Write-Host "[エラー] 出力が見つかりません : $pemPath / $keyPath" -ForegroundColor Red
+    exit 1
+}
+
+# ------------------------------------------------------------------
+# 信頼済みにする
+# ------------------------------------------------------------------
+if ($SkipTrust)
+{
+    Write-Host "[2/2] 信頼設定は省略しました（-SkipTrust）。"
+    Write-Host "      ブラウザで証明書の警告が出ます。"
+}
+else
+{
+    Write-Host "[2/2] 証明書を信頼済みにする ..."
+    Write-Host "      **Windows のセキュリティ警告が出たら「はい」を選ぶこと。**"
+
+    dotnet dev-certs https --trust
+
+    if ($LASTEXITCODE -ne 0)
+    {
+        # 信頼設定は失敗しても起動はできる（ブラウザで警告が出るだけ）。
+        Write-Host "[警告] 信頼設定に失敗しました。手動での信頼が要ります。" -ForegroundColor Yellow
+    }
+}
+
+Write-Host ""
+Write-Host "============================================"
+Write-Host "  完了"
+Write-Host "============================================"
+Write-Host "  証明書 : $pemPath"
+Write-Host "  秘密鍵 : $keyPath"
+Write-Host ""
+Write-Host "  次は 1_PublishAndUp.bat を実行してください。"
+Write-Host ""
diff --git a/root/programs/CS/Samples4NetCore/Docker/1_PublishAndUp.bat b/root/programs/CS/Samples4NetCore/Docker/1_PublishAndUp.bat
new file mode 100644
index 000000000..529282d04
--- /dev/null
+++ b/root/programs/CS/Samples4NetCore/Docker/1_PublishAndUp.bat
@@ -0,0 +1,65 @@
+@echo off
+rem NOTE: keep this file pure ASCII (root/programs/CODING.md section 4).
+rem       Japanese explanations are in README.md.
+rem
+rem Host-build type: publish on the host, then copy into the runtime image.
+rem See README.md and #548.
+
+setlocal
+pushd "%~dp0"
+
+set SLN_DIR=..\Backend\MVC_Sample\MVC_Sample
+set FX_DLL=..\..\Frameworks\Infrastructure\Build_netcore100\net10.0\OpenTouryo.Framework.dll
+
+echo === 1/4 : checking prerequisites ===
+
+if not exist "%FX_DLL%" (
+    echo [ERROR] Framework is not built: %FX_DLL%
+    echo         Build the framework first ^(root\programs\1_BuildAll.ps1^).
+    goto :fail
+)
+
+if not exist ".\https\aspnetapp.pem" (
+    echo [ERROR] .\https\aspnetapp.pem not found.
+    echo         Run 0_SetupCert.ps1 first.
+    goto :fail
+)
+
+docker network inspect common_link >nul 2>&1
+if errorlevel 1 (
+    echo [ERROR] docker network "common_link" not found.
+    echo         Start LocalServicesOnDocker first ^(it owns the network and the DB^).
+    echo         https://github.com/NetDevInfraWGinOSSConsortium/LocalServicesOnDocker
+    goto :fail
+)
+
+echo === 2/4 : dotnet publish ===
+if exist ".\publish" rmdir /s /q ".\publish"
+dotnet publish "%SLN_DIR%\MVC_Sample.csproj" -c Release -o ".\publish"
+if errorlevel 1 goto :fail
+
+if not exist ".\publish\MVC_Sample.dll" (
+    echo [ERROR] publish output not found: .\publish\MVC_Sample.dll
+    goto :fail
+)
+
+echo === 3/4 : docker compose up --build ===
+docker compose up --build -d
+if errorlevel 1 goto :fail
+
+echo === 4/4 : done ===
+echo   HTTP  : http://localhost:8080  ^(redirects to HTTPS^)
+echo   HTTPS : https://localhost:8081
+echo.
+echo   logs  : docker compose logs -f
+echo   stop  : 2_Down.bat
+popd
+endlocal
+exit /b 0
+
+:fail
+echo.
+echo [FAILED]
+popd
+endlocal
+exit /b 1
diff --git a/root/programs/CS/Samples4NetCore/Docker/2_Down.bat b/root/programs/CS/Samples4NetCore/Docker/2_Down.bat
new file mode 100644
index 000000000..9b54086f9
--- /dev/null
+++ b/root/programs/CS/Samples4NetCore/Docker/2_Down.bat
@@ -0,0 +1,17 @@
+@echo off
+rem NOTE: keep this file pure ASCII (root/programs/CODING.md section 4).
+rem       Japanese explanations are in README.md.
+rem
+rem Stops and removes the container.
+rem Named volumes (logs / data protection keys) are kept on purpose:
+rem removing the keys invalidates auth cookies and sessions.
+rem Use "docker compose down -v" if you really want to drop them.
+
+setlocal
+pushd "%~dp0"
+
+docker compose down
+set RC=%ERRORLEVEL%
+
+popd
+endlocal & exit /b %RC%
diff --git a/root/programs/CS/Samples4NetCore/Docker/Dockerfile b/root/programs/CS/Samples4NetCore/Docker/Dockerfile
new file mode 100644
index 000000000..dceb695f6
--- /dev/null
+++ b/root/programs/CS/Samples4NetCore/Docker/Dockerfile
@@ -0,0 +1,40 @@
+# ホストビルド型の Dockerfile（#548）
+#
+#   ホスト側で `dotnet publish` した成果物を、ランタイム イメージへ置くだけ。
+#   **コンテナ内ではビルドしない。**
+#
+#   理由：MVC_Sample.csproj はフレームワークを
+#     <Reference><HintPath>..\Frameworks\Infrastructure\Build_netcore100\net10.0\*.dll
+#   というビルド済み DLL への相対参照で持っている。
+#   Frameworks を先にビルドしないと restore すら通らないため、
+#   コンテナ内でビルドするならビルド コンテキストを root/programs/CS 全体へ
+#   広げることになる（Samples4NetCore/ANALYSIS.md 2-1）。
+#
+#   publish は 1_PublishAndUp.bat が行う。
+
+FROM mcr.microsoft.com/dotnet/aspnet:10.0 AS final
+
+WORKDIR /app
+
+# publish 成果物
+COPY ./publish/ ./
+
+# コンテナ用の設定（appsettings.json を上書きする。ASPNETCORE_ENVIRONMENT=Container で効く）
+COPY ./appsettings.Container.json ./
+# コンテナ用の log4net 定義（出力先を %env{OT_LOG_ROOT}）
+COPY ./conf/ ./conf/
+
+# ログと鍵の置き場所を、非 root ユーザで書けるようにしておく。
+#
+#   **名前付きボリュームは、初回にイメージ側の所有者と権限を引き継ぐ。**
+#   ここで chown しておかないと、マウント後に root 所有のままとなり、
+#   USER で切り替えた非 root ユーザが書けない。
+RUN mkdir -p /app/logs /app/keys && chown -R $APP_UID /app/logs /app/keys
+
+# 非 root で動かす（ベース イメージが用意している app ユーザ）
+USER $APP_UID
+
+EXPOSE 8080
+EXPOSE 8081
+
+ENTRYPOINT ["dotnet", "MVC_Sample.dll"]
diff --git a/root/programs/CS/Samples4NetCore/Docker/README.md b/root/programs/CS/Samples4NetCore/Docker/README.md
new file mode 100644
index 000000000..306215014
--- /dev/null
+++ b/root/programs/CS/Samples4NetCore/Docker/README.md
@@ -0,0 +1,225 @@
+# MVC_Sample を Docker で動かす
+
+`Samples4NetCore/Backend/MVC_Sample`（net10.0）を Linux コンテナで動かす（#548）。
+
+方式は [ASPNETMVCOnDocker](https://github.com/NetDevInfraWGinOSSConsortium/ASPNETMVCOnDocker) に倣い、**ホストビルド型**を採っている。
+
+## 前提
+
+| | |
+|---|---|
+| Docker エンジン | Docker Desktop / Rancher Desktop（Linux コンテナ） |
+| .NET 10 SDK | `dotnet publish` と `dotnet dev-certs` に使う |
+| **フレームワークのビルド** | `root/programs/1_BuildAll.ps1` を先に通しておく |
+| **DB** | [LocalServicesOnDocker](https://github.com/NetDevInfraWGinOSSConsortium/LocalServicesOnDocker) を先に起動しておく |
+
+DB は向こうが提供する。ネットワーク `common_link` に相乗りし、**サービス名 `sqlserver`** で届く。
+Northwind は向こうの `sqlserver/init/start-up.sh` が自動で作る。
+
+## 手順
+
+```powershell
+# 1. HTTPS の開発用証明書を作る（初回のみ）
+powershell -NoProfile -ExecutionPolicy Bypass -File .\0_SetupCert.ps1
+
+# 2. publish してコンテナを起動する
+.\1_PublishAndUp.bat
+
+# 3. 止める
+.\2_Down.bat
+```
+
+| プロトコル | URL |
+|---|---|
+| HTTP | http://localhost:8080 （HTTPS へ 307 リダイレクト） |
+| HTTPS | https://localhost:8081 |
+
+ログイン画面でユーザ名を入れると入れる（**ユーザ名が空でなければ認証する**実装）。
+
+## ファイル構成
+
+| | 役割 |
+|---|---|
+| `Dockerfile` | ホストビルド型。publish 成果物をランタイム イメージへ置く |
+| `docker-compose.yml` | ポート・ボリューム・環境変数・ネットワーク |
+| `appsettings.Container.json` | コンテナ用の設定（`appsettings.json` を**上書き**する） |
+| `conf/SampleLogConf.xml` | コンテナ用の log4net 定義（出力先が違う） |
+| `0_SetupCert.ps1` | 開発用証明書を **PEM** で書き出す（パスワード無し） |
+| `1_PublishAndUp.bat` | `dotnet publish` → `docker compose up --build` |
+| `2_Down.bat` | `docker compose down` |
+| `publish/` `https/` | 生成物。**Git 管理対象外** |
+
+---
+
+## 設定をどこに書くか
+
+読み込み順は次のとおりで、**後が勝つ**。
+
+```
+appsettings.json → appsettings.Container.json → 環境変数（compose の environment）
+```
+
+`appsettings.Container.json` は `ASPNETCORE_ENVIRONMENT=Container` のときだけ読まれ、
+**書いたキーだけを上書きする**（丸ごと差し替えではない）。
+書いていないキーは `appsettings.json` の値がそのまま生きる。
+
+| 置き場所 | 入れるもの |
+|---|---|
+| `appsettings.Container.json` | 配置に依らない「コンテナならこう」（パス・HTTPS・Cookie・鍵） |
+| compose の `environment` | 配置ごとに変わる値、秘密（リソースの場所・接続文字列・証明書） |
+
+こうすると compose が短くなり、**なぜその値なのかをコメント付き JSON で説明できる。**
+
+### `%OT_RESOURCE_ROOT%` はフレームワークが展開している
+
+OS の機能ではない。`ResourceLoader.ResolveFilePath` が
+`StringVariableOperator.BuiltStringIntoEnvironmentVariable` を呼び、
+`%` で区切って `Environment.GetEnvironmentVariable(..., Process)` を引いている。
+**Windows の書式に依存しない自前の実装なので、Linux コンテナでも効く。**
+
+定義ファイル（`FxXML*Definition`）・log4net 定義・SQL ファイルは、いずれも
+`ResolveFilePath` を通るため展開される。
+
+なお、**この `OT_RESOURCE_ROOT` という命名と「絶対パスを環境変数へ張り替える」規約は、
+[Open棟梁の CA スキル](https://github.com/OpenTouryoProject/OpenTouryoCodingAgentAssets)
+に倣ったもの**である。あちらはセットアップ時に設定ファイルを書き換える側で、
+**実行時に展開するのはフレームワーク側**。両者は別の役割なので、
+展開の実装を探すときは `ResourceLoader` を見ること。
+
+> **`FxContainerization` とは別の仕組みである。**
+> あちらは ON のとき「接頭辞なしのキー名」で環境変数を読む。ここでは使っていない。
+
+---
+
+## 踏みやすいところ
+
+### `WORKDIR` が要る
+
+`appsettings*.json` は**コンテンツ ルート＝プロセスの作業ディレクトリ**から読まれる。
+`WORKDIR /app` を置かないと、**設定ファイルが一切読まれないまま起動する**
+（それでも画面は出るので気付きにくい）。
+
+### フォルダ名は `Xml`。`XML` ではない
+
+`appsettings.json` は `C:/root/files/resource/XML/...` と書いているが、実フォルダは `Xml`。
+Windows は大文字小文字を区別しないので通るが、**Linux では開けない。**
+`appsettings.Container.json` では `Xml` に直してある。
+
+### `Data Source` は `localhost` ではなく `sqlserver`
+
+コンテナから見た `localhost` は自分自身であり、DB には届かない。
+
+### リソースは読み取り専用。ログは別の場所へ
+
+`files/resource` は `:ro` でマウントしている。log4net の出力先をその中にすると書けない。
+`OT_LOG_ROOT`（`/app/logs`）に向け、名前付きボリュームを当てている。
+
+**log4net 定義の「中身」は Open棟梁が展開しない**（ログ ライブラリへそのまま渡す）ため、
+中の変数は log4net の書式で書く必要がある。
+
+```xml
+<file type="log4net.Util.PatternString" value="%env{OT_LOG_ROOT}/ACCESS" />
+```
+
+`<param name="File">` ではなく、**型付きの `<file>`** である点に注意。
+
+### 非 root で動く。書き込み先の所有者は `Dockerfile` が用意する（手動作業は無い）
+
+`USER $APP_UID` で動かしているので、`/app/logs` と `/app/keys` は非 root で書ける必要がある。
+これは**イメージのビルド時に自動で済む**。利用者が手で `chown` することは無い。
+
+```dockerfile
+RUN mkdir -p /app/logs /app/keys && chown -R $APP_UID /app/logs /app/keys
+USER $APP_UID
+```
+
+**空の名前付きボリュームは、初回マウント時にイメージ側の中身・所有者・権限を引き継ぐ。**
+上のとおり `USER` へ切り替える前（＝root のうち）に作って `chown` してあるので、
+ボリュームも `app` 所有で作られる。実際、起動後はこうなる。
+
+```
+/app/logs:  drwxr-xr-x 2 app root
+            -rw-r--r-- 1 app app  ACCESS.2026-08-15.log
+/app/keys:  -rw------- 1 app app  key-....xml
+```
+
+ただし、この仕組みが効く条件が 2 つある。**変えるときは注意すること。**
+
+| | |
+|---|---|
+| **名前付きボリュームであること** | **バインド マウント（ホストのパス）に変えると引き継がれない。** ホスト側の所有者がそのまま見えるため、Linux ホストでは書けなくなる（Docker Desktop / Rancher Desktop では緩く見えることが多く、**気付かないまま Linux で落ちる**） |
+| **ボリュームが空であること** | 既に中身のあるボリュームには引き継がれない。`Dockerfile` の `chown` を後から直しても**既存のボリュームは直らない**ので、`docker compose down -v` で作り直す |
+
+### データ保護の鍵を捨てない
+
+`2_Down.bat` は `docker compose down`（`-v` なし）である。
+鍵のボリュームを消すと、**認証 Cookie とセッションが失効する。**
+
+---
+
+## 証明書とパスワード
+
+**PEM ＋ 秘密鍵にして、パスワードという管理対象を無くしてある。**
+
+```
+dotnet dev-certs https --format Pem -ep .\https\aspnetapp.pem -np
+```
+
+```yaml
+- Kestrel__Certificates__Default__Path=/https/aspnetapp.pem
+- Kestrel__Certificates__Default__KeyPath=/https/aspnetapp.key
+```
+
+参照元は PFX ＋ `.env` の `CERT_PASSWORD` だが、こちらは `.env` を作らない。
+守る対象は **localhost 限定・自己署名・1 年で失効する開発用証明書**であり、
+本番の TLS は前段のリバース プロキシが終端する想定だからである。
+PFX にしても PFX とパスワードの両方がホストに置かれるので、実質の防御力は変わらない。
+
+### 秘密を渡す口（本番向けの一例）
+
+接続文字列のパスワードは、**本番でも実在する秘密**である。
+ここではサンプルとして compose に直接書いているが、実際には次のような口がある。
+
+```yaml
+# Docker / Kubernetes の secrets（ファイルとしてマウントする）
+secrets:
+  - connectionStrings__ConnectionString_SQL
+```
+
+```csharp
+// ファイル名がそのまま構成キーになる（__ がセクション区切り）
+builder.Configuration.AddKeyPerFile("/run/secrets", optional: true);
+```
+
+`Microsoft.Extensions.Configuration.KeyPerFile` が要る。
+**キー名は環境変数のときと同じ**なので、置き換えても設定の書き方は変わらない。
+Kubernetes の Secret もファイル マウントなので、そのまま移行できる。
+
+どれを選ぶかは運用側の方式（Pod の信頼方式など）による。ここでは一例を示すに留める。
+
+---
+
+## 本番へ持って行くとき
+
+**この compose は開発用である。本番向けは書き直す前提でよい。**
+ただし実際に変わるのは、ほぼ compose 側だけである。
+
+| | 本番で変わるか |
+|---|---|
+| `Dockerfile` | **ほぼそのまま** |
+| 証明書のマウント・8081 の公開・`Kestrel__Certificates__*` | **消える**（TLS は前段で終端） |
+| `UseHttpsRedirection` | `on` → **`off`**（前段で終端するなら、on にすると無限リダイレクト） |
+| `CookieSecurePolicy` | **`always` のまま。** 前段で終端する構成では、これが実質必須になる |
+| 接続文字列・リソースの場所 | 環境ごとに差し替え |
+
+`CookieSecurePolicy` を `always` のままにする理由は、リバース プロキシ配下では
+`Request.IsHttps` が false になり、**フレームワーク側の自動判定（#536）が効かない**ため。
+`X-Forwarded-Proto` を見ていない件は **#549** で扱う。
+
+---
+
+## 対象外
+
+- **CI には載せていない。** 現行の疎通は `windows-latest` で回っており、Linux コンテナを動かせない
+- **net48 側（`Samples/`）の Windows コンテナ対応**は行わない
+- `3_SmokeTest.ps1` は従来どおり、コンテナを経由しない経路で `MVC_Sample (net10.0)` を確認する
diff --git a/root/programs/CS/Samples4NetCore/Docker/appsettings.Container.json b/root/programs/CS/Samples4NetCore/Docker/appsettings.Container.json
new file mode 100644
index 000000000..2a8bd232e
--- /dev/null
+++ b/root/programs/CS/Samples4NetCore/Docker/appsettings.Container.json
@@ -0,0 +1,53 @@
+// コンテナで動かすときの設定（#548）
+//
+// ＜これはオーバーライドである＞
+//   ASPNETCORE_ENVIRONMENT=Container のとき、appsettings.json の *後* に読まれ、
+//   **ここに書いたキーだけ**が上書きされる（丸ごと差し替えではない）。
+//   書いていないキー（FxErrorScreenPath、FxSqlTraceLog、OAuth2 の設定など）は
+//   appsettings.json の値がそのまま生きる。
+//
+//   さらに後段の環境変数（docker-compose.yml の environment）が最も強い。
+//
+//     appsettings.json → appsettings.Container.json → 環境変数
+//
+// ＜%OT_RESOURCE_ROOT% について＞
+//   これは OS の機能ではなく、**Open棟梁が自前で展開している**
+//   （ResourceLoader.ResolveFilePath → StringVariableOperator）。
+//   したがって Linux コンテナでも効く。値は docker-compose.yml で与える。
+{
+  "appSettings": {
+
+    // フレームワークの使用するパラメータ - start
+    //
+    // **フォルダ名は Xml。** appsettings.json は XML と書いているが、
+    // 実フォルダは Xml であり、**大文字小文字を区別する Linux では XML では開けない。**
+    "FxXMLSPDefinition": "%OT_RESOURCE_ROOT%/Xml/SPDefinition.xml",
+    "FxXMLMSGDefinition": "%OT_RESOURCE_ROOT%/Xml/MSGDefinition.xml",
+    "FxXMLTCDefinition": "%OT_RESOURCE_ROOT%/Xml/TCDefinition.xml",
+    "FxXMLTMInProcessDefinition": "%OT_RESOURCE_ROOT%/Xml/TMInProcessDefinition.xml",
+    // フレームワークの使用するパラメータ - end
+
+    // 共通部品の使用するパラメータ - start
+    //
+    // log4net の定義はコンテナ専用のものを使う（出力先が違うため）。
+    // リポジトリの resource/Log/SampleLogConf.xml は ro でマウントしており、
+    // 中の出力先も C:\root\... のままなので、そちらは使わない。
+    "FxLog4NetConfFile": "/app/conf/SampleLogConf.xml",
+    // 共通部品の使用するパラメータ - end
+
+    // 本番向けの切り替え - start
+    //
+    // HTTPS で公開するので、**本番と同じ設定のまま動かせる**。
+    // これが「開発は HTTP、本番だけ HTTPS」を避けたい理由でもある。
+    "UseHttpsRedirection": "on",
+    "CookieSecurePolicy": "always",
+    // データ保護の鍵。docker-compose.yml でボリュームを当てている。
+    "DataProtectionKeyPath": "/app/keys",
+    // 本番向けの切り替え - end
+
+    // アプリケーションの使用するパラメータ - start
+    "SpRp_RsaCerFilePath": "%OT_RESOURCE_ROOT%/X509/SHA256RSA_Server.cer",
+    "SqlTextFilePath": "%OT_RESOURCE_ROOT%/Sql"
+    // アプリケーションの使用するパラメータ - end
+  }
+}
diff --git a/root/programs/CS/Samples4NetCore/Docker/conf/SampleLogConf.xml b/root/programs/CS/Samples4NetCore/Docker/conf/SampleLogConf.xml
new file mode 100644
index 000000000..f0d122cdb
--- /dev/null
+++ b/root/programs/CS/Samples4NetCore/Docker/conf/SampleLogConf.xml
@@ -0,0 +1,104 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!--
+    コンテナ用の log4net 構成設定（#548）
+
+    resource/Log/SampleLogConf.xml との違いは、出力先だけである。
+
+      resource 側 : <param name="File" value="C:\root\files\resource\Log\ACCESS" />
+      こちら      : <file type="log4net.Util.PatternString" value="%env{OT_LOG_ROOT}/ACCESS" />
+
+    ＜なぜ別ファイルにするか＞
+      ・resource は読み取り専用（ro）でマウントするため、そこへは書けない
+      ・resource 側の出力先は Windows の絶対パスで、Linux では無効
+
+    ＜なぜ %env{} なのか＞
+      Open棟梁が展開するのは **設定ファイルのパス**（FxLog4NetConfFile）までで、
+      **その中身は展開せず、log4net へそのまま渡す**。
+      したがって中の変数は log4net の書式で書く必要がある。
+      log4net では PatternString の %env{} がそれに当たり、
+      <param name="File"> ではなく型付きの <file> で指定する。
+
+      OT_LOG_ROOT は docker-compose.yml で与えている。
+-->
+
+<log4net debug="true">
+
+    <!-- ローリング・ログファイル出力用アペンダ -->
+    <appender name="ACCESS" type="log4net.Appender.RollingFileAppender">
+        <file type="log4net.Util.PatternString" value="%env{OT_LOG_ROOT}/ACCESS" />
+        <!-- ローリングの設定 -->
+        <param name="StaticLogFileName" value="false" />
+        <param name="RollingStyle" value="date " />
+        <param name="DatePattern" value='"."yyyy-MM-dd".log"' />
+        <!-- 書き込み時の設定（追加 or 上書き、出力エンコーディング） -->
+        <param name="AppendToFile" value="true" />
+        <encoding value="utf-8" />
+        <!-- メッセージのフォーマット -->
+        <layout type="log4net.Layout.PatternLayout">
+            <param name="ConversionPattern" value="[%date{yyyy/MM/dd HH:mm:ss,fff}],[%-5level],[%thread],%message%newline" />
+        </layout>
+        <!-- フィルタ（範囲）の設定 -->
+        <filter type="log4net.Filter.LevelRangeFilter">
+            <levelMin value="DEBUG" />
+            <levelMax value="FATAL" />
+        </filter>
+    </appender>
+
+    <!-- ローリング・ログファイル出力用アペンダ -->
+    <appender name="SQLTRACE" type="log4net.Appender.RollingFileAppender">
+        <file type="log4net.Util.PatternString" value="%env{OT_LOG_ROOT}/SQLTRACE" />
+        <!-- ローリングの設定 -->
+        <param name="StaticLogFileName" value="false" />
+        <param name="RollingStyle" value="date " />
+        <param name="DatePattern" value='"."yyyy-MM-dd".log"' />
+        <!-- 書き込み時の設定（追加 or 上書き、出力エンコーディング） -->
+        <param name="AppendToFile" value="true" />
+        <encoding value="utf-8" />
+        <!-- メッセージのフォーマット -->
+        <layout type="log4net.Layout.PatternLayout">
+            <param name="ConversionPattern" value="[%date{yyyy/MM/dd HH:mm:ss,fff}],[%-5level],[%thread],%message%newline" />
+        </layout>
+        <!-- フィルタ（範囲）の設定 -->
+        <filter type="log4net.Filter.LevelRangeFilter">
+            <levelMin value="DEBUG" />
+            <levelMax value="FATAL" />
+        </filter>
+    </appender>
+
+    <!-- ローリング・ログファイル出力用アペンダ -->
+    <appender name="OPERATION" type="log4net.Appender.RollingFileAppender">
+        <file type="log4net.Util.PatternString" value="%env{OT_LOG_ROOT}/OPERATION" />
+        <!-- ローリングの設定 -->
+        <param name="StaticLogFileName" value="false" />
+        <param name="RollingStyle" value="date " />
+        <param name="DatePattern" value='"."yyyy-MM-dd".log"' />
+        <!-- 書き込み時の設定（追加 or 上書き、出力エンコーディング） -->
+        <param name="AppendToFile" value="true" />
+        <encoding value="utf-8" />
+        <!-- メッセージのフォーマット -->
+        <layout type="log4net.Layout.PatternLayout">
+            <param name="ConversionPattern" value="[%date{yyyy/MM/dd HH:mm:ss,fff}],[%-5level],[%thread],%message%newline" />
+        </layout>
+        <!-- フィルタ（範囲）の設定 -->
+        <filter type="log4net.Filter.LevelRangeFilter">
+            <levelMin value="DEBUG" />
+            <levelMax value="FATAL" />
+        </filter>
+    </appender>
+
+    <root>
+    </root>
+
+    <logger name="ACCESS">
+        <level value="All" />
+        <appender-ref ref="ACCESS" />
+    </logger>
+    <logger name="SQLTRACE">
+        <level value="All" />
+        <appender-ref ref="SQLTRACE" />
+    </logger>
+    <logger name="OPERATION">
+        <level value="All" />
+        <appender-ref ref="OPERATION" />
+    </logger>
+</log4net>
diff --git a/root/programs/CS/Samples4NetCore/Docker/docker-compose.yml b/root/programs/CS/Samples4NetCore/Docker/docker-compose.yml
new file mode 100644
index 000000000..bab5bdea6
--- /dev/null
+++ b/root/programs/CS/Samples4NetCore/Docker/docker-compose.yml
@@ -0,0 +1,76 @@
+# MVC_Sample (net10.0) を Docker で動かす（#548）
+#
+#   前提：DB は LocalServicesOnDocker が提供する。先に起動しておくこと。
+#     https://github.com/NetDevInfraWGinOSSConsortium/LocalServicesOnDocker
+#   あちらが作る common_link に相乗りし、サービス名 sqlserver で届く。
+#
+# ＜値をどこに書くか＞
+#   ・配置に依らない「コンテナならこう」 → appsettings.Container.json
+#   ・配置ごとに変わる値・秘密           → ここ（environment）
+#   読み込み順は appsettings.json → appsettings.Container.json → 環境変数で、
+#   **後が勝つ**ので、ここに書けば JSON より優先される。
+
+services:
+  mvc-sample:
+    image: opentouryo-mvc-sample
+    build:
+      context: .
+      dockerfile: Dockerfile
+    ports:
+      - "8080:8080"
+      - "8081:8081"
+    environment:
+      # Container 環境として起動する（appsettings.Container.json が読まれる）。
+      # **Development にはしない。** 開発者例外ページが出てしまうため。
+      - ASPNETCORE_ENVIRONMENT=Container
+
+      # 待ち受けポート
+      - ASPNETCORE_HTTP_PORTS=8080
+      - ASPNETCORE_HTTPS_PORTS=8081
+
+      # 証明書（PEM ＋ 秘密鍵。**パスワードを持たない**）
+      - Kestrel__Certificates__Default__Path=/https/aspnetapp.pem
+      - Kestrel__Certificates__Default__KeyPath=/https/aspnetapp.key
+
+      # リソースの置き場所
+      #
+      #   Open棟梁は設定値の中の %変数% を自前で展開する
+      #   （ResourceLoader.ResolveFilePath → StringVariableOperator）。
+      #   Windows の書式に依存しない実装なので、Linux コンテナでも効く。
+      - OT_RESOURCE_ROOT=/app/files/resource
+      # ログの出力先（**リソースは ro でマウントするので、ログは別の場所へ**）
+      - OT_LOG_ROOT=/app/logs
+
+      # 接続文字列
+      #
+      #   **Data Source は localhost ではなく sqlserver。**
+      #   コンテナから見た localhost は自分自身であり、DB には届かない。
+      #   パスワードを直に書いているのは、すぐ動かせるサンプルだからである。
+      #   実際の環境では secrets やシークレット ストアから渡すこと（README 参照）。
+      - connectionStrings__ConnectionString_SQL=Data Source=sqlserver;Initial Catalog=Northwind;User ID=sa;Password=seigi@123;Encrypt=false;
+
+    volumes:
+      # 定義ファイル・SQL・証明書（読み取り専用）
+      - ../../../../files/resource:/app/files/resource:ro
+      # HTTPS の開発用証明書（0_SetupCert.ps1 が作る。読み取り専用）
+      - ./https:/https:ro
+      # ログ（書き込む）
+      - mvc-sample-logs:/app/logs
+      # データ保護の鍵
+      #
+      #   **ここを永続化しないと、コンテナを作り直すたびに鍵が変わり、
+      #   認証 Cookie とセッションが失効する。**
+      - mvc-sample-keys:/app/keys
+
+    networks:
+      - common_link
+
+volumes:
+  mvc-sample-logs:
+  mvc-sample-keys:
+
+networks:
+  # LocalServicesOnDocker が作るネットワークに相乗りする。
+  # 先に向こうを起動しておくこと（無いと compose がエラーになる）。
+  common_link:
+    external: true

From ae38cc4e370b04867bb457e383e8cb3f6eeb69a0 Mon Sep 17 00:00:00 2001
From: nishi_74322014 <nishi_74322014@ksj.biglobe.ne.jp>
Date: Sat, 15 Aug 2026 23:56:13 +0900
Subject: [PATCH 3/5] fixed #550

---
 root/programs/3_SmokeTest.ps1                 | 23 +++++++++++++++++--
 .../ServiceInterface/WCFService/App.config    |  6 ++---
 root/programs/CS/Samples/ANALYSIS.md          |  2 +-
 .../WebForms_Sample/app.config                | 16 ++++++-------
 root/programs/CS/Samples4NetCore/ANALYSIS.md  |  6 ++---
 .../Backend/MVC_Sample/MVC_Sample/Startup.cs  |  2 +-
 .../MVC_Sample/MVC_Sample/appsettings.json    | 10 ++++----
 .../CS/Samples4NetCore/Docker/README.md       | 11 +++++----
 .../Docker/appsettings.Container.json         |  4 ++--
 .../ASPNETWebService/app.config               |  6 ++---
 .../ServiceInterface/WCFService/App.config    |  6 ++---
 .../WebForms_Sample/app.config                | 16 ++++++-------
 12 files changed, 65 insertions(+), 43 deletions(-)

diff --git a/root/programs/3_SmokeTest.ps1 b/root/programs/3_SmokeTest.ps1
index d3bf07e61..b152fc46b 100644
--- a/root/programs/3_SmokeTest.ps1
+++ b/root/programs/3_SmokeTest.ps1
@@ -70,6 +70,8 @@
      2026/08/01  玄人 幸道         新規作成（リリース ワークのエージェント化）
      2026/08/07  玄人 幸道         Orders2が無ければ作成するようにした
      2026/08/13  玄人 幸道         Lang を追加（VB 版の疎通に対応）
+     2026/08/15  玄人 幸道         Args を持たない対象が PowerShell 5.1 で起動できず、
+                                   しかも前回の出力で OK と判定されていたのを修正
 #>
 [CmdletBinding()]
 param(
@@ -1186,6 +1188,13 @@ foreach ($t in $selected)
     #   Start-Process でファイルへ直接リダイレクトすれば、どちらも起きない。
     #   出力は生のまま残り、環境による差も出ない。
     $err = "$out.err"
+
+    # **前回の出力を必ず消してから実行する。**
+    #   $out / $err は対象ごとの固定名で、$OutputDir（既定は %TEMP%）に残る。
+    #   消さずに実行すると、**起動に失敗しても前回の出力が判定に使われ、
+    #   実行していないのに OK になる**（所要時間が 0.0 秒になるのが兆候）。
+    Remove-Item $out, $err -Force -ErrorAction SilentlyContinue
+
     Write-Host "  実行中 ..."
     $sw = [Diagnostics.Stopwatch]::StartNew()
 
@@ -1199,7 +1208,7 @@ foreach ($t in $selected)
 
         $argList = @("`"$exe`"")
         if ($needSep) { $argList += "--" }
-        $argList += @($t.Args)
+        $argList += @($t.Args | Where-Object { $null -ne $_ })
 
         Start-Process "dotnet" -ArgumentList $argList -NoNewWindow -Wait `
             -WorkingDirectory (Split-Path $exe) `
@@ -1207,7 +1216,17 @@ foreach ($t in $selected)
     }
     else
     {
-        $argList = @($t.Args)
+        # **null 要素を落としてから数える。**
+        #   Args を持たない対象では $t.Args が $null になり、@($null) は
+        #   「要素数 1・中身 null」の配列になる。**Count は 0 にならない**ので、
+        #   下のガードをすり抜けて -ArgumentList に null 入りの配列が渡る。
+        #   これを Windows PowerShell 5.1 は拒否する（PS 7 は空文字に変換して通す）。
+        #
+        #     PS 5.1 : Start-Process : パラメーター 'ArgumentList の引数を確認できません。…
+        #     PS 7   : そのまま動く
+        #
+        #   5.1 でだけ落ちるため、7 で検証していると気付けない。
+        $argList = @($t.Args | Where-Object { $null -ne $_ })
 
         if ($argList.Count -eq 0)
         {
diff --git a/root/programs/CS/Frameworks/Infrastructure/ServiceInterface/WCFService/App.config b/root/programs/CS/Frameworks/Infrastructure/ServiceInterface/WCFService/App.config
index 68720f878..70f7df870 100644
--- a/root/programs/CS/Frameworks/Infrastructure/ServiceInterface/WCFService/App.config
+++ b/root/programs/CS/Frameworks/Infrastructure/ServiceInterface/WCFService/App.config
@@ -4,11 +4,11 @@
     <!-- WCF TCP/IPサービス用 -->
     <!-- フレームワークの使用するパラメータ - start -->
     <!-- メッセージ定義へのパス -->
-    <add key="FxXMLMSGDefinition" value="C:\root\files\resource\XML\MSGDefinition.xml" />
+    <add key="FxXMLMSGDefinition" value="C:\root\files\resource\Xml\MSGDefinition.xml" />
     <!-- トランザクション制御定義へのパス -->
-    <add key="FxXMLTCDefinition" value="C:\root\files\resource\XML\TCDefinition.xml" />
+    <add key="FxXMLTCDefinition" value="C:\root\files\resource\Xml\TCDefinition.xml" />
     <!-- 名前解決定義へのパス -->
-    <add key="FxXMLTMInProcessDefinition" value="C:\root\files\resource\XML\TMInProcessDefinition.xml" />
+    <add key="FxXMLTMInProcessDefinition" value="C:\root\files\resource\Xml\TMInProcessDefinition.xml" />
     <!-- フレームワークの使用するパラメータ - end -->
     <!-- 共通部品の使用するパラメータ - start -->
     <!-- Log4Netのコンフィグファイルへのパス -->
diff --git a/root/programs/CS/Samples/ANALYSIS.md b/root/programs/CS/Samples/ANALYSIS.md
index db6d3112d..6e8347dac 100644
--- a/root/programs/CS/Samples/ANALYSIS.md
+++ b/root/programs/CS/Samples/ANALYSIS.md
@@ -30,7 +30,7 @@ Open棟梁フレームワークの **使い方を示すサンプル兼テンプ
 **サンプルの設定ファイルは `C:\root\files\resource\...` という絶対パスを直書きしている。**
 
 ```xml
-<add key="FxXMLSPDefinition" value="C:\root\files\resource\XML\SPDefinition.xml" />
+<add key="FxXMLSPDefinition" value="C:\root\files\resource\Xml\SPDefinition.xml" />
 <add key="SqlTextFilePath"   value="C:\root\files\resource\Sql" />
 ```
 
diff --git a/root/programs/CS/Samples/WebApp_sample/WebForms_Sample/WebForms_Sample/app.config b/root/programs/CS/Samples/WebApp_sample/WebForms_Sample/WebForms_Sample/app.config
index 2f0928855..d377d2874 100644
--- a/root/programs/CS/Samples/WebApp_sample/WebForms_Sample/WebForms_Sample/app.config
+++ b/root/programs/CS/Samples/WebApp_sample/WebForms_Sample/WebForms_Sample/app.config
@@ -50,19 +50,19 @@
   <!-- 画面遷移チェック機能のon・off -->
   <add key="FxScreenTransitionCheck" value="on" />
   <!-- 共有情報定義へのパス -->
-  <add key="FxXMLSPDefinition" value="C:\root\files\resource\XML\SPDefinition.xml" />
+  <add key="FxXMLSPDefinition" value="C:\root\files\resource\Xml\SPDefinition.xml" />
   <!-- Message定義へのパス -->
-  <add key="FxXMLMSGDefinition" value="C:\root\files\resource\XML\MSGDefinition.xml" />
+  <add key="FxXMLMSGDefinition" value="C:\root\files\resource\Xml\MSGDefinition.xml" />
   <!-- 画面遷移定義へのパス -->
-  <add key="FxXMLSCDefinition" value="C:\root\files\resource\XML\SCDefinition.xml" />
+  <add key="FxXMLSCDefinition" value="C:\root\files\resource\Xml\SCDefinition.xml" />
   <!-- トランザクション制御定義へのパス -->
-  <add key="FxXMLTCDefinition" value="C:\root\files\resource\XML\TCDefinition.xml" />
+  <add key="FxXMLTCDefinition" value="C:\root\files\resource\Xml\TCDefinition.xml" />
   <!-- 名前解決定義へのパス -->
   <!-- In case of using IIS -->
-  <!--<add key="FxXMLTMProtocolDefinition" value="C:\root\files\resource\XML\TMProtocolDefinition.xml"/>-->
+  <!--<add key="FxXMLTMProtocolDefinition" value="C:\root\files\resource\Xml\TMProtocolDefinition.xml"/>-->
   <!-- In case of using IIS Express -->
-  <add key="FxXMLTMProtocolDefinition" value="C:\root\files\resource\XML\TMProtocolDefinition2.xml" />
-  <add key="FxXMLTMInProcessDefinition" value="C:\root\files\resource\XML\TMInProcessDefinition.xml" />
+  <add key="FxXMLTMProtocolDefinition" value="C:\root\files\resource\Xml\TMProtocolDefinition2.xml" />
+  <add key="FxXMLTMInProcessDefinition" value="C:\root\files\resource\Xml\TMInProcessDefinition.xml" />
   <!-- フレームワークの使用するパラメータ - end -->
 
   <!-- 共通部品の使用するパラメータ - start -->
@@ -132,7 +132,7 @@
   <!-- キャッシュ制御機能のon・off -->
   <add key="FxCacheControl" value="ON" />
   <!-- その他 -->
-  <add key="TestFilePath" value="C:\root\files\resource\test" />
+  <add key="TestFilePath" value="C:\root\files\resource\Test" />
   <add key="ImagePath" value="~/images/touryo/image.jpg" />
   <!-- アプリケーションの使用するパラメータ - end -->
 </appSettings>
\ No newline at end of file
diff --git a/root/programs/CS/Samples4NetCore/ANALYSIS.md b/root/programs/CS/Samples4NetCore/ANALYSIS.md
index 52d7336d6..ab7fe2552 100644
--- a/root/programs/CS/Samples4NetCore/ANALYSIS.md
+++ b/root/programs/CS/Samples4NetCore/ANALYSIS.md
@@ -51,7 +51,7 @@ dotnet build ../Frameworks/Infrastructure/Business_netcore100.sln
 `Backend/MVC_Sample` と `Legacy/*` の設定は `C:/root/files/resource/...` を直書きしている。
 
 ```json
-"FxXMLSPDefinition": "C:/root/files/resource/XML/SPDefinition.xml",
+"FxXMLSPDefinition": "C:/root/files/resource/Xml/SPDefinition.xml",
 "SqlTextFilePath":   "C:/root/files/resource/Sql"
 ```
 
@@ -247,7 +247,7 @@ net48 の `app.config` → Core は `appsettings.json`。**`appSettings` / `conn
     "ConnectionString_NPS": "HOST=localhost;DATABASE=postgres;..."
   },
   "appSettings": {
-    "FxXMLSPDefinition": "C:/root/files/resource/XML/SPDefinition.xml",
+    "FxXMLSPDefinition": "C:/root/files/resource/Xml/SPDefinition.xml",
     "FxLog4NetConfFile": "C:/root/files/resource/Log/SampleLogConf.xml",
     "FxSqlTraceLog": "on",
     "SqlTextFilePath": "C:/root/files/resource/Sql"
@@ -268,7 +268,7 @@ net48 の `app.config` → Core は `appsettings.json`。**`appSettings` / `conn
 **`appsettings.json` の値は、環境変数でそのまま上書きできる。** 区切りは `__`（下線 2 つ）。
 
 ```
-appSettings__FxXMLSPDefinition=/app/files/resource/XML/SPDefinition.xml
+appSettings__FxXMLSPDefinition=/app/files/resource/Xml/SPDefinition.xml
 connectionStrings__ConnectionString_SQL=Data Source=db;...
 ```
 
diff --git a/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/Startup.cs b/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/Startup.cs
index 8e128518b..4c3953fbe 100644
--- a/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/Startup.cs
+++ b/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/Startup.cs
@@ -40,7 +40,7 @@
 //   appsettings.json の値は環境変数で上書きできる。区切りは「__」（下線 2 つ）。
 //
 //     appSettings__UseHttpsRedirection=on
-//     appSettings__FxXMLSPDefinition=/app/files/resource/XML/SPDefinition.xml
+//     appSettings__FxXMLSPDefinition=/app/files/resource/Xml/SPDefinition.xml
 //     connectionStrings__ConnectionString_SQL=...
 //
 //   **FxContainerization は要らない。** あちらは「接頭辞なしのキー名」で
diff --git a/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/appsettings.json b/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/appsettings.json
index 55f83c319..11b086b27 100644
--- a/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/appsettings.json
+++ b/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/appsettings.json
@@ -26,7 +26,7 @@
   // ＜環境を移すとき＞（#541）
   //   ここの値は、環境変数で上書きできる。区切りは「__」（下線 2 つ）。
   //
-  //     appSettings__FxXMLSPDefinition=/app/files/resource/XML/SPDefinition.xml
+  //     appSettings__FxXMLSPDefinition=/app/files/resource/Xml/SPDefinition.xml
   //     connectionStrings__ConnectionString_SQL=Data Source=db;...
   //
   //   Host.CreateDefaultBuilder が環境変数を構成に含めるため、
@@ -61,13 +61,13 @@
     // 基盤画面パス"
     "FxErrorScreenPath": "/Error/Index",
     // 共有情報定義へのパス
-    "FxXMLSPDefinition": "C:/root/files/resource/XML/SPDefinition.xml",
+    "FxXMLSPDefinition": "C:/root/files/resource/Xml/SPDefinition.xml",
     // メッセージ定義へのパス
-    "FxXMLMSGDefinition": "C:/root/files/resource/XML/MSGDefinition.xml",
+    "FxXMLMSGDefinition": "C:/root/files/resource/Xml/MSGDefinition.xml",
     // トランザクション制御定義へのパス
-    "FxXMLTCDefinition": "C:/root/files/resource/XML/TCDefinition.xml",
+    "FxXMLTCDefinition": "C:/root/files/resource/Xml/TCDefinition.xml",
     // 名前解決定義へのパス
-    "FxXMLTMInProcessDefinition": "C:/root/files/resource/XML/TMInProcessDefinition.xml",
+    "FxXMLTMInProcessDefinition": "C:/root/files/resource/Xml/TMInProcessDefinition.xml",
 
     // フレームワークの使用するパラメータ - end
 
diff --git a/root/programs/CS/Samples4NetCore/Docker/README.md b/root/programs/CS/Samples4NetCore/Docker/README.md
index 306215014..c09ae729a 100644
--- a/root/programs/CS/Samples4NetCore/Docker/README.md
+++ b/root/programs/CS/Samples4NetCore/Docker/README.md
@@ -99,11 +99,14 @@ OS の機能ではない。`ResourceLoader.ResolveFilePath` が
 `WORKDIR /app` を置かないと、**設定ファイルが一切読まれないまま起動する**
 （それでも画面は出るので気付きにくい）。
 
-### フォルダ名は `Xml`。`XML` ではない
+### フォルダ名の大文字小文字は合わせる
 
-`appsettings.json` は `C:/root/files/resource/XML/...` と書いているが、実フォルダは `Xml`。
-Windows は大文字小文字を区別しないので通るが、**Linux では開けない。**
-`appsettings.Container.json` では `Xml` に直してある。
+実フォルダは `Xml`（`XML` ではない）。**Windows は大文字小文字を区別しないので
+間違っていても通るが、Linux では開けない。**
+
+`appsettings.json` はもともと `resource/XML/...` と書いており、
+このサンプルを作る過程で見つかった。**#550 で本体側を `Xml` に直してある。**
+`resource` 配下の他のフォルダ（`Log` / `Sql` / `Test` / `X509`）も同様。
 
 ### `Data Source` は `localhost` ではなく `sqlserver`
 
diff --git a/root/programs/CS/Samples4NetCore/Docker/appsettings.Container.json b/root/programs/CS/Samples4NetCore/Docker/appsettings.Container.json
index 2a8bd232e..d7ec04f99 100644
--- a/root/programs/CS/Samples4NetCore/Docker/appsettings.Container.json
+++ b/root/programs/CS/Samples4NetCore/Docker/appsettings.Container.json
@@ -19,8 +19,8 @@
 
     // フレームワークの使用するパラメータ - start
     //
-    // **フォルダ名は Xml。** appsettings.json は XML と書いているが、
-    // 実フォルダは Xml であり、**大文字小文字を区別する Linux では XML では開けない。**
+    // **フォルダ名は Xml（XML ではない）。**
+    // 大文字小文字を区別する Linux では、綴りが違うと開けない（#550）。
     "FxXMLSPDefinition": "%OT_RESOURCE_ROOT%/Xml/SPDefinition.xml",
     "FxXMLMSGDefinition": "%OT_RESOURCE_ROOT%/Xml/MSGDefinition.xml",
     "FxXMLTCDefinition": "%OT_RESOURCE_ROOT%/Xml/TCDefinition.xml",
diff --git a/root/programs/VB/Frameworks/Infrastructure/ServiceInterface/ASPNETWebService/ASPNETWebService/app.config b/root/programs/VB/Frameworks/Infrastructure/ServiceInterface/ASPNETWebService/ASPNETWebService/app.config
index 1b6c6451e..e5efdb7f5 100644
--- a/root/programs/VB/Frameworks/Infrastructure/ServiceInterface/ASPNETWebService/ASPNETWebService/app.config
+++ b/root/programs/VB/Frameworks/Infrastructure/ServiceInterface/ASPNETWebService/ASPNETWebService/app.config
@@ -6,11 +6,11 @@
 
   <!-- フレームワークの使用するパラメータ - start -->
   <!-- メッセージ定義へのパス -->
-  <add key="FxXMLMSGDefinition" value="C:\root\files\resource\XML\MSGDefinition.xml"/>
+  <add key="FxXMLMSGDefinition" value="C:\root\files\resource\Xml\MSGDefinition.xml"/>
   <!-- トランザクション制御定義へのパス -->
-  <add key="FxXMLTCDefinition" value="C:\root\files\resource\XML\TCDefinition.xml"/>
+  <add key="FxXMLTCDefinition" value="C:\root\files\resource\Xml\TCDefinition.xml"/>
   <!-- 名前解決定義へのパス -->
-  <add key="FxXMLTMInProcessDefinition" value="C:\root\files\resource\XML\TMInProcessDefinition.xml"/>
+  <add key="FxXMLTMInProcessDefinition" value="C:\root\files\resource\Xml\TMInProcessDefinition.xml"/>
   <!-- フレームワークの使用するパラメータ - end -->
 
   <!-- 共通部品の使用するパラメータ - start -->
diff --git a/root/programs/VB/Frameworks/Infrastructure/ServiceInterface/WCFService/App.config b/root/programs/VB/Frameworks/Infrastructure/ServiceInterface/WCFService/App.config
index 9ace65d19..5ba408dee 100644
--- a/root/programs/VB/Frameworks/Infrastructure/ServiceInterface/WCFService/App.config
+++ b/root/programs/VB/Frameworks/Infrastructure/ServiceInterface/WCFService/App.config
@@ -4,11 +4,11 @@
     <!-- WCF TCP/IPサービス用 -->
     <!-- フレームワークの使用するパラメータ - start -->
     <!-- メッセージ定義へのパス -->
-    <add key="FxXMLMSGDefinition" value="C:\root\files\resource\XML\MSGDefinition.xml"/>
+    <add key="FxXMLMSGDefinition" value="C:\root\files\resource\Xml\MSGDefinition.xml"/>
     <!-- トランザクション制御定義へのパス -->
-    <add key="FxXMLTCDefinition" value="C:\root\files\resource\XML\TCDefinition.xml"/>
+    <add key="FxXMLTCDefinition" value="C:\root\files\resource\Xml\TCDefinition.xml"/>
     <!-- 名前解決定義へのパス -->
-    <add key="FxXMLTMInProcessDefinition" value="C:\root\files\resource\XML\TMInProcessDefinition.xml"/>
+    <add key="FxXMLTMInProcessDefinition" value="C:\root\files\resource\Xml\TMInProcessDefinition.xml"/>
     <!-- フレームワークの使用するパラメータ - end -->
     <!-- 共通部品の使用するパラメータ - start -->
     <!-- Log4Netのコンフィグファイルへのパス -->
diff --git a/root/programs/VB/Samples/WebApp_sample/WebForms_Sample/WebForms_Sample/app.config b/root/programs/VB/Samples/WebApp_sample/WebForms_Sample/WebForms_Sample/app.config
index 286e190db..1dbf52f25 100644
--- a/root/programs/VB/Samples/WebApp_sample/WebForms_Sample/WebForms_Sample/app.config
+++ b/root/programs/VB/Samples/WebApp_sample/WebForms_Sample/WebForms_Sample/app.config
@@ -50,19 +50,19 @@
   <!-- 画面遷移チェック機能のon・off -->
   <add key="FxScreenTransitionCheck" value="on" />
   <!-- 共有情報定義へのパス -->
-  <add key="FxXMLSPDefinition" value="C:\root\files\resource\XML\SPDefinition.xml" />
+  <add key="FxXMLSPDefinition" value="C:\root\files\resource\Xml\SPDefinition.xml" />
   <!-- Message定義へのパス -->
-  <add key="FxXMLMSGDefinition" value="C:\root\files\resource\XML\MSGDefinition.xml" />
+  <add key="FxXMLMSGDefinition" value="C:\root\files\resource\Xml\MSGDefinition.xml" />
   <!-- 画面遷移定義へのパス -->
-  <add key="FxXMLSCDefinition" value="C:\root\files\resource\XML\SCDefinition.xml" />
+  <add key="FxXMLSCDefinition" value="C:\root\files\resource\Xml\SCDefinition.xml" />
   <!-- トランザクション制御定義へのパス -->
-  <add key="FxXMLTCDefinition" value="C:\root\files\resource\XML\TCDefinition.xml" />
+  <add key="FxXMLTCDefinition" value="C:\root\files\resource\Xml\TCDefinition.xml" />
   <!-- 名前解決定義へのパス -->
   <!-- In case of using IIS -->
-  <!--<add key="FxXMLTMProtocolDefinition" value="C:\root\files\resource\XML\TMProtocolDefinition.xml"/>-->
+  <!--<add key="FxXMLTMProtocolDefinition" value="C:\root\files\resource\Xml\TMProtocolDefinition.xml"/>-->
   <!-- In case of using IIS Express -->
-  <add key="FxXMLTMProtocolDefinition" value="C:\root\files\resource\XML\TMProtocolDefinition2.xml" />
-  <add key="FxXMLTMInProcessDefinition" value="C:\root\files\resource\XML\TMInProcessDefinition.xml" />
+  <add key="FxXMLTMProtocolDefinition" value="C:\root\files\resource\Xml\TMProtocolDefinition2.xml" />
+  <add key="FxXMLTMInProcessDefinition" value="C:\root\files\resource\Xml\TMInProcessDefinition.xml" />
   <!-- フレームワークの使用するパラメータ - end -->
 
   <!-- 共通部品の使用するパラメータ - start -->
@@ -132,7 +132,7 @@
   <!-- キャッシュ制御機能のon・off -->
   <add key="FxCacheControl" value="ON" />
   <!-- その他 -->
-  <add key="TestFilePath" value="C:\root\files\resource\test" />
+  <add key="TestFilePath" value="C:\root\files\resource\Test" />
   <add key="ImagePath" value="~/images/touryo/image.jpg" />
   <!-- アプリケーションの使用するパラメータ - end -->
 </appSettings>

From e4d31def6c3a1ff819e70a9d12dcd08afd07c049 Mon Sep 17 00:00:00 2001
From: nishi_74322014 <nishi_74322014@ksj.biglobe.ne.jp>
Date: Sun, 16 Aug 2026 01:21:11 +0900
Subject: [PATCH 4/5] fixing #549

---
 AGENTS.md                                     |   6 +
 .../Framework/Util/FxCmnFunction.cs           |  30 ++
 .../MVC_Sample/MVC_Sample/Web.config          |  34 ++
 root/programs/CS/Samples4NetCore/ANALYSIS.md  |  29 ++
 .../Backend/MVC_Sample/MVC_Sample/Startup.cs  |  82 ++++-
 .../MVC_Sample/MVC_Sample/appsettings.json    |  11 +
 .../CS/Samples4NetCore/Docker/README.md       |  17 +-
 root/programs/Configuration.md                | 338 ++++++++++++++++++
 root/programs/SMOKETEST.md                    |  34 +-
 9 files changed, 570 insertions(+), 11 deletions(-)
 create mode 100644 root/programs/Configuration.md

diff --git a/AGENTS.md b/AGENTS.md
index a6254b0cc..b22623b2d 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -144,10 +144,16 @@ gh auth switch --user OsscJpDevInfra  # 異なる場合は切り替え
 | 内容 | 読む文書 |
 |---|---|
 | **コーディング規約（全領域共通）** | [`CODING.md`](root/programs/CODING.md) |
+| **設定ファイルの扱い（全領域共通）** | [`Configuration.md`](root/programs/Configuration.md) |
 | `root/programs/CS/Frameworks/` の分析 | [`Frameworks/ANALYSIS.md`](root/programs/CS/Frameworks/ANALYSIS.md) |
 | `root/programs/CS/Samples/` の分析 | [`Samples/ANALYSIS.md`](root/programs/CS/Samples/ANALYSIS.md) |
 | `root/programs/CS/Samples4NetCore/` の分析 | [`Samples4NetCore/ANALYSIS.md`](root/programs/CS/Samples4NetCore/ANALYSIS.md) |
 
+**設定ファイルに「仕組み」を書き足したくなったら、[`Configuration.md`](root/programs/Configuration.md)
+に書く。** 設定ファイルは 86 個あり、一部にだけ詳しい説明があると、
+**書かれていないファイルを「該当しない」と誤読させる。**
+値の隣に書くのは「そのキーが何か」までにする（分担は同書 0 節）。
+
 **コードを変更する前に、[`CODING.md`](root/programs/CODING.md) と、
 作業対象を所管する `ANALYSIS.md` の両方を読むこと。**
 
diff --git a/root/programs/CS/Frameworks/Infrastructure/Framework/Util/FxCmnFunction.cs b/root/programs/CS/Frameworks/Infrastructure/Framework/Util/FxCmnFunction.cs
index c309f44f5..3c7183520 100644
--- a/root/programs/CS/Frameworks/Infrastructure/Framework/Util/FxCmnFunction.cs
+++ b/root/programs/CS/Frameworks/Infrastructure/Framework/Util/FxCmnFunction.cs
@@ -56,6 +56,8 @@
 //*  2018/03/29  西野 大介         .NET Standard対応で、削除機能に関連するメソッドを削除
 //*  2018/03/29  西野 大介         .NET Standard対応で、HttpCookieのポーティング
 //*  2026/08/10  玄人 幸道         Cookie に Secure 属性を設定（HTTPS のときのみ。CodeQL 対応）
+//*  2026/08/16  玄人 幸道         リバース プロキシで TLS を終端すると上記が効かないため、
+//*                                その旨と対処をコメントに追記（#549。挙動は変えていない）
 //**********************************************************************************
 
 using Touryo.Infrastructure.Framework.Exceptions;
@@ -968,6 +970,13 @@ public static void CreateCookieForSessionTimeoutDetection()
             // Secure属性を設定（CodeQL: Cookie 'Secure' attribute is not set to true）
             // HTTPSのときだけ立てる。無条件にtrueにすると、HTTPで動かす
             // 開発環境やサンプルでブラウザがCookieを保存しなくなるため。
+            //
+            // **リバース プロキシでTLSを終端すると、ここはfalseになる。**（#549）
+            //   利用者のブラウザはHTTPSでも、アプリから見た接続はHTTPのため。
+            //   アプリ側でUseForwardedHeadersを設定し、X-Forwarded-Protoを
+            //   取り込むこと（Samples4NetCoreのStartup.csに例がある）。
+            //   確実に立てたいなら、CookiePolicyのCookieSecurePolicy.Alwaysを使う。
+            //   あちらは全てのSet-Cookieを後段で上書きするため、ここの判断に依存しない。
             cookieOptions.Secure = MyHttpContext.Current.Request.IsHttps;
 
             // 設定
@@ -1007,6 +1016,13 @@ public static void DeleteCookieForSessionTimeoutDetection()
             // Secure属性を設定（CodeQL: Cookie 'Secure' attribute is not set to true）
             // HTTPSのときだけ立てる。無条件にtrueにすると、HTTPで動かす
             // 開発環境やサンプルでブラウザがCookieを保存しなくなるため。
+            //
+            // **リバース プロキシでTLSを終端すると、ここはfalseになる。**（#549）
+            //   利用者のブラウザはHTTPSでも、アプリから見た接続はHTTPのため。
+            //   アプリ側でUseForwardedHeadersを設定し、X-Forwarded-Protoを
+            //   取り込むこと（Samples4NetCoreのStartup.csに例がある）。
+            //   確実に立てたいなら、CookiePolicyのCookieSecurePolicy.Alwaysを使う。
+            //   あちらは全てのSet-Cookieを後段で上書きするため、ここの判断に依存しない。
             cookieOptions.Secure = MyHttpContext.Current.Request.IsHttps;
 
             // 設定
@@ -1046,6 +1062,13 @@ HttpCookie newCookie
             // Secure属性を設定（CodeQL: Cookie 'Secure' attribute is not set to true）
             // HTTPSのときだけ立てる。無条件にtrueにすると、HTTPで動かす
             // 開発環境やサンプルでブラウザがCookieを保存しなくなるため。
+            //
+            // **リバース プロキシでTLSを終端すると、ここはfalseになる。**（#549）
+            //   利用者のブラウザはHTTPSでも、IISから見た接続はHTTPのため。
+            //   IsSecureConnectionはコードから変えられないので、IIS側で
+            //   X-Forwarded-Protoを見てHTTPSサーバ変数を立てる
+            //   （Samples/WebApp_sample/MVC_SampleのWeb.configに例がある）。
+            //   確実に立てたいなら、forms要素のrequireSSL="true"を使う。
             newCookie.Secure = HttpContext.Current.Request.IsSecureConnection;
 
             // セッションタイムアウト検出用Cookie（データ有）
@@ -1085,6 +1108,13 @@ HttpCookie newCookie
             // Secure属性を設定（CodeQL: Cookie 'Secure' attribute is not set to true）
             // HTTPSのときだけ立てる。無条件にtrueにすると、HTTPで動かす
             // 開発環境やサンプルでブラウザがCookieを保存しなくなるため。
+            //
+            // **リバース プロキシでTLSを終端すると、ここはfalseになる。**（#549）
+            //   利用者のブラウザはHTTPSでも、IISから見た接続はHTTPのため。
+            //   IsSecureConnectionはコードから変えられないので、IIS側で
+            //   X-Forwarded-Protoを見てHTTPSサーバ変数を立てる
+            //   （Samples/WebApp_sample/MVC_SampleのWeb.configに例がある）。
+            //   確実に立てたいなら、forms要素のrequireSSL="true"を使う。
             newCookie.Secure = HttpContext.Current.Request.IsSecureConnection;
 
             // セッションタイムアウト検出用Cookie（データ空）
diff --git a/root/programs/CS/Samples/WebApp_sample/MVC_Sample/MVC_Sample/Web.config b/root/programs/CS/Samples/WebApp_sample/MVC_Sample/MVC_Sample/Web.config
index 54fa77ef1..d4b72f7e2 100644
--- a/root/programs/CS/Samples/WebApp_sample/MVC_Sample/MVC_Sample/Web.config
+++ b/root/programs/CS/Samples/WebApp_sample/MVC_Sample/MVC_Sample/Web.config
@@ -91,6 +91,40 @@
       （Samples4NetCore の appsettings.json : DataProtectionKeyPath）。
     -->
     <!--<machineKey validationKey="..." decryptionKey="..." validation="HMACSHA256" decryption="AES"/>-->
+    <!--
+      **リバース プロキシで TLS を終端するなら、IIS 側の設定も要る。**（#549）
+
+      前段で TLS を終端すると、IIS から見た接続は HTTP になる。
+      Request.IsSecureConnection が false のままなので、
+      **利用者のブラウザは HTTPS で繋いでいるのに Secure 属性が付かない**
+      （#536 でフレームワークが立てるようにした分が効かない）。
+
+      net48 では IsSecureConnection をコードから変えられないため、
+      **IIS 側で前段の X-Forwarded-Proto を見て HTTPS サーバ変数を立てる。**
+      IIS + ARR なら URL Rewrite の受信規則で行う（要 allowedServerVariables 登録）。
+
+      <rewrite>
+        <rules>
+          <rule name="ForwardedProto">
+            <match url=".*" />
+            <conditions>
+              <add input="{HTTP_X_FORWARDED_PROTO}" pattern="^https$" />
+            </conditions>
+            <serverVariables>
+              <set name="HTTPS" value="on" />
+            </serverVariables>
+            <action type="None" />
+          </rule>
+        </rules>
+      </rewrite>
+
+      **前段だけが到達できるネットワークに閉じてから使うこと。**
+      アプリを直接叩ける状態だと、クライアントが X-Forwarded-Proto を詐称でき、
+      HTTP で来ているのに HTTPS だと判断させられる。
+
+      netcore 側は UseForwardedHeaders で同じことを行う
+      （Samples4NetCore の appsettings.json : UseForwardedHeaders）。
+    -->
     <!--
       SQLサーバ（利用の際は、以下のスクリプトを実行する）
       C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727
diff --git a/root/programs/CS/Samples4NetCore/ANALYSIS.md b/root/programs/CS/Samples4NetCore/ANALYSIS.md
index ab7fe2552..143fb23ae 100644
--- a/root/programs/CS/Samples4NetCore/ANALYSIS.md
+++ b/root/programs/CS/Samples4NetCore/ANALYSIS.md
@@ -289,6 +289,8 @@ connectionStrings__ConnectionString_SQL=Data Source=db;...
 | `UseHttpsRedirection` | `off` | `on` で `app.UseHttpsRedirection()` を挟む |
 | `CookieSecurePolicy` | (空) | `always` で Cookie に `Secure` を必ず付ける |
 | `DataProtectionKeyPath` | (空) | データ保護の鍵を、指定フォルダへ永続化する |
+| `UseForwardedHeaders` | `off` | `X-Forwarded-Proto` / `-For` を取り込む（#549） |
+| `ForwardedHeadersKnownProxies` | (空) | 信用する前段のアドレス（空＝範囲を制限しない） |
 
 ### 5-2. この 3 つで踏むこと（実測）
 
@@ -335,6 +337,33 @@ services.AddDataProtection()
 net48 側の対応物は `machineKey` である（`Samples/WebApp_sample/MVC_Sample` の
 `Web.config` にコメントで記載）。
 
+**④ リバース プロキシで TLS を終端するなら `UseForwardedHeaders` が要る（#549）。**
+
+前段で終端すると、アプリから見た接続は HTTP になる。`Request.IsHttps` が false のままなので、
+**ブラウザは HTTPS で繋いでいるのに `Secure` 属性が付かない**
+（`#536` でフレームワークが立てるようにした分が効かない）。
+
+実測（`X-Forwarded-Proto: https` を付けて、平文 HTTP でログインしたときの `Set-Cookie`）。
+
+| 設定 | `secure` が付いた Cookie |
+|---|---|
+| 既定（`off`） | **0 / 1 件** |
+| `UseForwardedHeaders=on` | **3 / 4 件**（`SessionTimeOut` / `.AspNetCore.Cookies` / `mvc_session`） |
+| `on` ＋ `ForwardedHeadersKnownProxies=10.0.0.1` | **0 / 1 件**（前段の範囲外なので捨てられる） |
+| `on` ＋ ヘッダ無し | **0 / 1 件**（素の HTTP のまま。正しい） |
+
+> **`KnownIPNetworks` / `KnownProxies` を設定しないと黙って無視される。**
+> 既定ではループバックからの転送しか信用しない。コンテナや Kubernetes では
+> 前段が別アドレスになるため、**指定しないと何も起きない。**
+> 「on にしたのに直らない」の原因はほぼこれ。
+>
+> 逆に無条件に信用すると、**クライアントがヘッダを詐称できる**。
+> 前段だけが到達できるネットワークに閉じてから使うこと。
+
+net48 側はコードから変えられない（`Request.IsSecureConnection` は読み取り専用）ため、
+**IIS + ARR の URL Rewrite で `HTTPS` サーバ変数を立てる**
+（`Samples/WebApp_sample/MVC_Sample` の `Web.config` にコメントで記載）。
+
 ### 5-3. コンテナで動かす場合は `Docker/` を見る（#548）
 
 `Backend/MVC_Sample` を Linux コンテナで動かす一式が `Docker/` にある。
diff --git a/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/Startup.cs b/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/Startup.cs
index 4c3953fbe..8ecb1502c 100644
--- a/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/Startup.cs
+++ b/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/Startup.cs
@@ -18,6 +18,9 @@
 //*  2026/08/15  玄人 幸道         環境を移しても動くように整理（#541）。
 //*                                本番向けの設定を、コメントアウトではなく
 //*                                appsettings.json の値で切り替える形にした。
+//*  2026/08/16  玄人 幸道         転送ヘッダ（X-Forwarded-Proto）を取り込めるようにした（#549）。
+//*                                リバース プロキシで TLS を終端する構成で、
+//*                                Request.IsHttps が false のままになるのを解消する。
 //**********************************************************************************
 
 // ＜設定で切り替えるもの＞（#541）
@@ -26,11 +29,13 @@
 //   環境を移すときにソースを書き換えることになる。
 //   appsettings.json（および環境変数）で切り替えられるようにしてある。
 //
-//   | キー（appSettings）      | 既定   | on にすると |
-//   |--------------------------|--------|-------------|
-//   | UseHttpsRedirection      | off    | HTTP を HTTPS へリダイレクトする |
-//   | CookieSecurePolicy       | (空)   | always で Cookie に Secure 属性を必ず付ける |
-//   | DataProtectionKeyPath    | (空)   | データ保護の鍵を、指定フォルダに永続化する |
+//   | キー（appSettings）              | 既定   | on にすると |
+//   |----------------------------------|--------|-------------|
+//   | UseHttpsRedirection              | off    | HTTP を HTTPS へリダイレクトする |
+//   | CookieSecurePolicy               | (空)   | always で Cookie に Secure 属性を必ず付ける |
+//   | DataProtectionKeyPath            | (空)   | データ保護の鍵を、指定フォルダに永続化する |
+//   | UseForwardedHeaders              | off    | X-Forwarded-Proto / -For を取り込む（#549） |
+//   | ForwardedHeadersKnownProxies     | (空)   | 信用する前段のアドレス（空＝範囲を制限しない） |
 //
 //   **既定値は、いずれも従来どおりの動作**である。
 //
@@ -48,10 +53,12 @@
 
 using System;
 using System.IO;
+using System.Net;
 
 using Microsoft.AspNetCore.Builder;
 using Microsoft.AspNetCore.Hosting;
 using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.HttpOverrides;
 using Microsoft.AspNetCore.HttpsPolicy;
 using Microsoft.AspNetCore.CookiePolicy;
 using Microsoft.AspNetCore.Authentication;
@@ -109,7 +116,70 @@ public Startup(IConfiguration configuration)
         /// </summary>
         public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
         {
-            
+            // 転送ヘッダの取り込み（#549）
+            //
+            //   **リバース プロキシで TLS を終端すると、アプリから見た接続は HTTP になる。**
+            //   利用者のブラウザは HTTPS で繋いでいるのに Request.IsHttps は false のままで、
+            //   Secure 属性が付かない（#536 でフレームワークが立てるようにした分が効かない）。
+            //
+            //   前段が付ける X-Forwarded-Proto を取り込むと、IsHttps が正しくなる。
+            //
+            //   **必ずパイプラインの先頭に置く。**
+            //   後ろに置くと、それより前のミドルウェア（UseHttpsRedirection など）が
+            //   取り込み前のスキームを見てしまう。
+            //
+            //   既定は off。素の HTTP で動かす開発環境では、転送ヘッダを
+            //   誰でも付けられる（＝クライアントが詐称できる）ため。
+            if (Startup.IsOn("UseForwardedHeaders"))
+            {
+                ForwardedHeadersOptions options = new ForwardedHeadersOptions()
+                {
+                    ForwardedHeaders = ForwardedHeaders.XForwardedProto | ForwardedHeaders.XForwardedFor
+                };
+
+                // 信用する前段を指定する。
+                //
+                //   **既定ではループバックからの転送しか信用しない。**
+                //   コンテナや Kubernetes では前段が別アドレスになるため、
+                //   **指定しないとヘッダが黙って捨てられ、何も起きない。**
+                //   「on にしたのに直らない」の原因はほぼこれである。
+                //
+                //   ForwardedHeadersKnownProxies に、前段のアドレスをカンマ区切りで書く。
+                string knownProxies = Startup.GetValue("ForwardedHeadersKnownProxies");
+
+                if (string.IsNullOrEmpty(knownProxies))
+                {
+                    // **前段を特定できない場合（コンテナ等）は、範囲の制限を外す。**
+                    //   KnownIPNetworks / KnownProxies を空にすると、
+                    //   「どこからの転送でも信用する」という意味になる。
+                    //   （KnownNetworks は .NET 10 で非推奨。KnownIPNetworks を使う）
+                    //
+                    //   **アプリが前段を経由せず直接叩ける状態では使わないこと。**
+                    //   クライアントが X-Forwarded-Proto を詐称でき、
+                    //   HTTP で来ているのに HTTPS だと判断させられる。
+                    //   前段だけが到達できるネットワークに閉じてから使う。
+                    options.KnownIPNetworks.Clear();
+                    options.KnownProxies.Clear();
+                }
+                else
+                {
+                    options.KnownIPNetworks.Clear();
+                    options.KnownProxies.Clear();
+
+                    foreach (string ip in knownProxies.Split(','))
+                    {
+                        string trimmed = ip.Trim();
+
+                        if (!string.IsNullOrEmpty(trimmed))
+                        {
+                            options.KnownProxies.Add(IPAddress.Parse(trimmed));
+                        }
+                    }
+                }
+
+                app.UseForwardedHeaders(options);
+            }
+
             if (env.IsDevelopment())
             {
                 app.UseDeveloperExceptionPage();
diff --git a/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/appsettings.json b/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/appsettings.json
index 11b086b27..332839849 100644
--- a/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/appsettings.json
+++ b/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/appsettings.json
@@ -55,6 +55,17 @@
     // 指定しないと鍵が揃わず、認証 Cookie とセッションが失効する。
     "DataProtectionKeyPath": "",
 
+    // 転送ヘッダ（X-Forwarded-Proto / -For）を取り込むか（on / off）（#549）
+    // **リバース プロキシで TLS を終端するなら on にする。**
+    // off のままだと Request.IsHttps が false になり、ブラウザが HTTPS で
+    // 繋いでいても Cookie に Secure 属性が付かない。
+    "UseForwardedHeaders": "off",
+    // 信用する前段のアドレス（カンマ区切り。空なら範囲を制限しない）
+    // **空にすると、どこからの転送でも信用する。**
+    // アプリを前段だけが到達できるネットワークに閉じてから使うこと
+    // （直接叩ける状態では、クライアントが X-Forwarded-Proto を詐称できる）。
+    "ForwardedHeadersKnownProxies": "",
+
     // 本番向けの切り替え - end
 
     // フレームワークの使用するパラメータ - start
diff --git a/root/programs/CS/Samples4NetCore/Docker/README.md b/root/programs/CS/Samples4NetCore/Docker/README.md
index c09ae729a..eefc6147a 100644
--- a/root/programs/CS/Samples4NetCore/Docker/README.md
+++ b/root/programs/CS/Samples4NetCore/Docker/README.md
@@ -212,12 +212,21 @@ Kubernetes の Secret もファイル マウントなので、そのまま移行
 | `Dockerfile` | **ほぼそのまま** |
 | 証明書のマウント・8081 の公開・`Kestrel__Certificates__*` | **消える**（TLS は前段で終端） |
 | `UseHttpsRedirection` | `on` → **`off`**（前段で終端するなら、on にすると無限リダイレクト） |
-| `CookieSecurePolicy` | **`always` のまま。** 前段で終端する構成では、これが実質必須になる |
+| `CookieSecurePolicy` | **`always` のまま** |
+| `UseForwardedHeaders` | `off` → **`on`**（前段の `X-Forwarded-Proto` を取り込む） |
 | 接続文字列・リソースの場所 | 環境ごとに差し替え |
 
-`CookieSecurePolicy` を `always` のままにする理由は、リバース プロキシ配下では
-`Request.IsHttps` が false になり、**フレームワーク側の自動判定（#536）が効かない**ため。
-`X-Forwarded-Proto` を見ていない件は **#549** で扱う。
+**前段で TLS を終端すると、アプリから見た接続は HTTP になる。**
+`Request.IsHttps` が false のままなので、そのままでは
+**フレームワーク側の `Secure` 自動判定（#536）が効かない。**
+
+`UseForwardedHeaders=on` にすると `X-Forwarded-Proto` を取り込み、`IsHttps` が正しくなる（#549）。
+**`ForwardedHeadersKnownProxies` も併せて確認すること。**
+既定ではループバックからの転送しか信用しないため、
+前段が別アドレス（コンテナや Kubernetes では通常そうなる）だと**黙って無視される。**
+
+`CookieSecurePolicy=always` は、その保険として残しておく。
+こちらは `IsHttps` を見ずに明示的に立てるため、転送ヘッダの設定を誤っても効く。
 
 ---
 
diff --git a/root/programs/Configuration.md b/root/programs/Configuration.md
new file mode 100644
index 000000000..afb93fbb0
--- /dev/null
+++ b/root/programs/Configuration.md
@@ -0,0 +1,338 @@
+# Configuration.md — 設定ファイルの扱い
+
+対象: `root/programs` 配下（CS / VB、net48 / net10.0）
+配置: `root/programs`
+
+本書は**「設定がどう読まれ、どう上書きされ、どこで踏むか」**を扱う。
+**個々のキーが何を意味するかは書かない。**それは値の隣（各設定ファイルのコメント）にある。
+
+---
+
+## 0. どこに何を書くか
+
+設定ファイルは **86 個**ある。全部に同じ説明を書くことはできないし、書けば必ずずれる。
+
+| | 書く場所 | 例 |
+|---|---|---|
+| **仕組み**（読み込み順・上書き・展開・落とし穴） | **本書だけ** | 「環境変数は `__` 区切りで上書きする」 |
+| **そのキーが何か**（値の意味・既定値・選択肢） | **値の隣のコメント** | 「`FxSqlTraceLog` : Ｄ層のパフォーマンス ログ出力の on / off」 |
+| **そのサンプル固有の事情** | そのサンプルの `ANALYSIS.md` / `README.md` | 「`Legacy/*` は相対パスで書く」 |
+
+**設定ファイルに仕組みを書き足したくなったら、本書に書いて、そこから参照する。**
+一部のファイルにだけ詳しい説明がある状態は、**書かれていないファイルを「該当しない」と
+誤読させる。**（実際、86 個中 3 個にだけ詳細が書かれている状態になっていた）
+
+---
+
+## 1. 設定ファイルの種類
+
+| | net48 | net10.0 |
+|---|---|---|
+| デスクトップ・バッチ・CLI | `app.config` | `appsettings.json` |
+| Web | `Web.config`（＋ `app.config`） | `appsettings.json`（＋ `appsettings.{環境名}.json`） |
+
+net48 の Web では、`Web.config` が `appSettings` を**別ファイルへ委譲**していることがある。
+
+```xml
+<appSettings file="app.config"/>
+```
+
+このとき**キーの実体は `app.config` 側**にある。`Web.config` だけ見て「無い」と判断しない。
+
+### net10.0 では初期化が要る
+
+```csharp
+GetConfigParameter.InitConfiguration(configuration);   // Startup のコンストラクタ
+```
+
+**これが無いと `Fx*` 系の設定がすべて null になる。** net48 は暗黙に読まれるので不要。
+
+---
+
+## 2. セクション名の流儀
+
+**`appSettings` / `connectionStrings` というセクション名を、JSON でもそのまま使う。**
+
+```json
+{
+  "connectionStrings": { "ConnectionString_SQL": "..." },
+  "appSettings":       { "FxXMLSPDefinition": "..." }
+}
+```
+
+ASP.NET Core の標準（`ConnectionStrings` / 任意のセクション）とは綴りが違う。
+`GetConfigParameter` がこの名前で引くため、**変えると読めなくなる。**
+
+> **`appsettings.json` はコメント付き JSON（JSONC）で書いてよい。**
+> `Microsoft.Extensions.Configuration.Json` は `//` を許容する。
+> ただし**厳密な JSON パーサで読むと壊れる**ので、外部ツールに食わせるときは注意。
+
+---
+
+## 3. 読み込み順と優先順位（net10.0）
+
+`Host.CreateDefaultBuilder` が次の順に読む。**後が勝つ。**
+
+```
+appsettings.json → appsettings.{環境名}.json → user-secrets（Development のみ）
+  → 環境変数 → コマンドライン
+```
+
+`{環境名}` は `ASPNETCORE_ENVIRONMENT` の値。未指定なら `Production`。
+
+**`appsettings.{環境名}.json` は「キー単位」の上書きであって、丸ごと差し替えではない。**
+書いたキーだけが上書きされ、書いていないキーは `appsettings.json` の値が生きる（実測）。
+
+| 実験 | 結果 |
+|---|---|
+| `appsettings.Container.json` 無し（Production） | 200 |
+| 有り ＋ `ASPNETCORE_ENVIRONMENT=Container` | **500**（1 キーだけ壊した値を書いた。読まれている） |
+| 同じファイル ＋ 環境名なし | 200（読まれない） |
+
+> **環境名を変えると副作用がある。** `Development` にすると `env.IsDevelopment()` が真になり、
+> 開発者例外ページが出る（本番向けの `UseExceptionHandler` / `UseHsts` 側に入らない）。
+> 実例では `Container` という名前を使っている。
+
+---
+
+## 4. 環境変数で上書きする
+
+### 4-1. `__`（下線 2 つ）区切り
+
+```
+appSettings__FxXMLSPDefinition=/app/files/resource/Xml/SPDefinition.xml
+connectionStrings__ConnectionString_SQL=Data Source=db;...
+```
+
+`__` が `:`（セクション区切り）に読み替えられる。**上の 3 節のとおり、環境変数は
+`appsettings.json` にも `appsettings.{環境名}.json` にも勝つ。**
+
+`Startup` が受け取った `IConfiguration` をそのまま `InitConfiguration` へ渡しているため、
+**フレームワーク側から読む値にも効く。**
+
+> **Docker / Kubernetes の secrets も同じキー名で渡せる。**
+> `Microsoft.Extensions.Configuration.KeyPerFile` を足し、
+> `builder.Configuration.AddKeyPerFile("/run/secrets", optional: true)` とすると、
+> **ファイル名がそのまま構成キーになる**（`__` がセクション区切りとして効く）。
+> `Host.CreateDefaultBuilder` は既定では読まないので、1 行足す必要がある。
+
+### 4-2. `FxContainerization` は別の仕組み
+
+**混同しないこと。** こちらは ON のとき、**接頭辞なしのキー名**で環境変数を読む。
+
+```csharp
+// Public/Util/GetConfigParameter.cs : CheckContainerization
+if (containerization.ToUpper() == PubLiteral.ON)
+{
+    return System.Environment.GetEnvironmentVariable(key);   // 例: FxXMLSPDefinition
+}
+```
+
+| | 読むもの | 有効化 |
+|---|---|---|
+| `appSettings__` 方式 | `appSettings__FxXMLSPDefinition` | **不要**（既定で効く） |
+| `FxContainerization` | `FxXMLSPDefinition` | `FxContainerization=ON` |
+
+**net10.0 のコンテナで使っているのは前者。** `FxContainerization` は使っていない。
+
+---
+
+## 5. 設定値の中の `%変数%` はフレームワークが展開する
+
+**OS の機能ではない。Open棟梁 が自前で展開している。**
+
+```csharp
+// Public/IO/ResourceLoader.cs : ResolveFilePath
+loadfilepath = StringVariableOperator.BuiltStringIntoEnvironmentVariable(loadfilepath);
+```
+
+`%` で分割して `Environment.GetEnvironmentVariable(名前, Process)` を引くだけの実装で、
+**Windows の書式に依存しない。Linux コンテナでも効く。**
+
+```json
+"FxXMLSPDefinition": "%OT_RESOURCE_ROOT%/Xml/SPDefinition.xml"
+```
+
+### 効く範囲
+
+**`ResourceLoader` を経由してファイルを開くパスは、すべて展開される**
+（`ResolveFilePath` / `Exists` / `LoadAsString` のいずれも `ResolveFilePath` を通る）。
+
+- 定義 XML（`FxXML*Definition`）
+- log4net / NLog の定義ファイルの**場所**（`FxLog4NetConfFile`）
+- SQL ファイル（`SqlTextFilePath` ＋ ファイル名。`BaseDam.Load2` → `ResourceLoader.LoadAsString`）
+
+`TransactionControl` / `BaseController` / `*NameService` は、`BuiltStringIntoEnvironmentVariable` を
+明示的に呼んでいる。
+
+> **`ResourceLoader` を経由しない読み方をしている箇所では効かない。**
+> 新しいパス系キーを足すときは、どちらの経路かを確かめること。
+
+### 定義ファイルの「中身」は展開しない
+
+**Open棟梁 が展開するのは設定ファイルの「場所」までで、中身はライブラリへそのまま渡す。**
+したがって、ログ定義の中の変数は**ログ ライブラリの書式**で書く。
+
+```xml
+<!-- log4net : PatternString の %env{}。<param name="File"> ではなく型付きの <file> -->
+<file type="log4net.Util.PatternString" value="%env{OT_LOG_ROOT}/ACCESS" />
+```
+
+```xml
+<!-- NLog : ${...} -->
+<target xsi:type="File" name="ACCESS" fileName="${OT_LOG_ROOT}/ACCESS..." />
+```
+
+---
+
+## 6. コンテンツ ルート（＝プロセスの作業ディレクトリ）
+
+**`appsettings*.json` は、実行ファイルの場所ではなく「作業ディレクトリ」から読まれる。**
+
+作業ディレクトリが違うと、**設定ファイルが一度も読まれないまま起動する。**
+それでも画面は出るので気付きにくい。起動ログで確かめられる。
+
+```
+info: Microsoft.Hosting.Lifetime[0]
+      Content root path: C:\OpenTouryo\root\programs      ← 意図した場所か？
+```
+
+- コンテナでは `Dockerfile` に **`WORKDIR /app`** を置く
+- `dotnet <パス>\App.dll` で起動するときは、**出力フォルダを作業ディレクトリにする**
+
+---
+
+## 7. パスの落とし穴
+
+### 7-1. 大文字小文字（#550）
+
+**実フォルダは `Xml` / `Log` / `Sql` / `Test` / `X509`。**
+`XML` や `test` と書いても **Windows では通り、Linux では開けない。**
+
+### 7-2. 絶対パス
+
+サンプルは `C:/root/files/resource/...` を直書きしている（リポジトリを `C:\root\` に
+展開する前提）。**別の場所に置くならビルドは通るが実行時に落ちる。**
+環境変数（4 節）か `%変数%`（5 節）で差し替える。
+
+### 7-3. 相対パスの基準
+
+相対パスは**まず作業ディレクトリ基準**で探し、見つからなければ
+**`AppContext.BaseDirectory`（実行ファイルの場所）基準**で再探索する
+（`ResolveFilePath`）。CLI が任意の場所から起動される場合への対応。
+
+`Samples4NetCore/Legacy/*` は、この仕組みに乗って**ファイル名だけ**を書いている。
+
+```json
+"FxXMLSPDefinition": "SPDefinition.xml"
+```
+
+csproj の `CopyToOutputDirectory` で出力フォルダへ配る前提なので、
+**`%変数%` 化すると壊れる。**
+
+---
+
+## 8. HTTPS 関連 — 「検知」と「宣言」
+
+リバース プロキシで TLS を終端すると、**アプリから見た接続は HTTP になる**。
+`Request.IsHttps`（net48 は `IsSecureConnection`）は false のままで、
+**ブラウザは HTTPS なのに Cookie に `Secure` が付かない**（#549）。
+
+対処は 2 通りある。
+
+| 方針 | 手段（net10.0） | 手段（net48） | 実測 |
+|---|---|---|---|
+| **検知**（実態を知らせる） | `UseForwardedHeaders` | IIS の URL Rewrite で `HTTPS` を立てる | 4 件中 **3 件**に `secure` |
+| **宣言**（そう決め打つ） | `CookieSecurePolicy=always` | `forms` の `requireSSL="true"` | 4 件中 **4 件** |
+
+**宣言の方が依存が少なく確実。** `CookiePolicy` はすべての `Set-Cookie` を後段で
+上書きするため、個々の箇所が何を判断しているかに依存しない。
+
+### 検知を選ぶなら 3 点が要る
+
+| | 内容 | 欠けると |
+|---|---|---|
+| ① 前段が伝播する | `X-Forwarded-Proto: https` を付ける | 何も起きない |
+| ② **アプリが受け取る設定になっている** | `UseForwardedHeaders` | **付いていても捨てられる** |
+| ③ 付けられるのが前段だけ | ネットワークで閉じる／`KnownProxies` | クライアントが詐称できる |
+
+> **`KnownIPNetworks` / `KnownProxies` を設定しないと黙って無視される。**
+> 既定ではループバックからの転送しか信用しない。
+> 「on にしたのに直らない」の原因はほぼこれ。
+
+### 何を矯正でき、何ができないか
+
+**分かれ目は「リクエストごとに変わるか」。**
+
+| 情報 | 性質 | 内部パラメタで矯正できるか |
+|---|---|---|
+| スキーム（HTTPS か） | 環境ごとに固定 | **できる**（`CookieSecurePolicy` / `requireSSL`） |
+| 配置パス（サブパス） | 環境ごとに固定 | **できる**（`app.UsePathBase`） |
+| 外部から見た URL | 環境ごとに固定 | **できる**（設定に絶対 URL を書く） |
+| **クライアント IP** | リクエストごとに変わる | **できない**（伝播が必須） |
+| **クライアント証明書** | リクエストごとに変わる | **できない**（伝播が必須） |
+
+**クライアント IP は既に動く。** `GetClientIpAddress` と `MyBaseAsyncApiController` が
+`X-Forwarded-For` を**ヘッダから直読み**しており、`UseForwardedHeaders` に依存しない。
+
+### 宣言のトレードオフ
+
+**間違えるとはっきり壊れる。** 本当に平文 HTTP の環境で `always` にすると、
+Antiforgery の Cookie が返らず**ログインの POST が 400** になる（実測）。
+
+**ただしこれは利点でもある。**
+
+| | 間違えたときの現れ方 |
+|---|---|
+| 検知 | **静かに効かない。** 画面は動き、`Secure` だけが付かない |
+| 宣言 | **はっきり壊れる。** すぐ気付いて直せる |
+
+---
+
+## 9. 秘密の扱い
+
+サンプルは**パスワードを直書きしている**（すぐ動かせることを優先しているため）。
+実際の環境では、次のいずれかで渡す。
+
+| | net48 | net10.0 |
+|---|---|---|
+| 別ファイルへ逃がす | `<connectionStrings configSource="..."/>` | `appsettings.{環境名}.json` |
+| 暗号化する | `aspnet_regiis -pef connectionStrings <パス>` | — |
+| 環境変数 | — | `connectionStrings__ConnectionString_SQL=...` |
+| 開発機のみ | — | `dotnet user-secrets`（Development のみ読まれる） |
+| コンテナ | — | secrets ＋ `AddKeyPerFile`（4-1 節） |
+| そもそも持たない | `Integrated Security=SSPI` | 同左 |
+
+**証明書は「パスワードを無くす」選択肢がある。** PFX ＋ パスワードではなく
+PEM ＋ 秘密鍵ファイルにすると、管理対象が 1 つ減る。
+
+```
+dotnet dev-certs https --format Pem -ep ./https/aspnetapp.pem -np
+```
+
+---
+
+## 10. net48 / net10.0 の対応表
+
+| | net48 | net10.0 |
+|---|---|---|
+| ファイル | `app.config` / `Web.config` | `appsettings.json` |
+| 環境別 | （なし。`configSource` で分ける） | `appsettings.{環境名}.json` |
+| 初期化 | 暗黙 | **`InitConfiguration()` が必須** |
+| 環境変数での上書き | （標準では無い） | `__` 区切り |
+| Cookie の `Secure` を必ず立てる | `requireSSL="true"` | `CookieSecurePolicy=always` |
+| 転送ヘッダの取り込み | IIS の URL Rewrite | `UseForwardedHeaders` |
+| 鍵の共有（複数台） | `machineKey` | DataProtection（`DataProtectionKeyPath`） |
+| セッションの外出し | `sessionState mode="StateServer"` ほか | `AddDistributedSqlServerCache` ほか |
+
+---
+
+## 11. 実例はどこにあるか
+
+| 見たいもの | 場所 |
+|---|---|
+| net10.0 の Web（本番向けの切り替えを含む） | `CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/appsettings.json` |
+| 環境変数・`%変数%`・環境別ファイルの実運用 | `CS/Samples4NetCore/Docker/`（[`README.md`](CS/Samples4NetCore/Docker/README.md)） |
+| net48 の Web（`machineKey` / 転送ヘッダの注記） | `CS/Samples/WebApp_sample/MVC_Sample/MVC_Sample/Web.config` |
+| 相対パスで自己完結させる書き方 | `CS/Samples4NetCore/Legacy/Bat_sample/*/appsettings.json` |
+| 領域ごとの事情 | 各 `ANALYSIS.md`（[Frameworks](CS/Frameworks/ANALYSIS.md) / [Samples](CS/Samples/ANALYSIS.md) / [Samples4NetCore](CS/Samples4NetCore/ANALYSIS.md)） |
diff --git a/root/programs/SMOKETEST.md b/root/programs/SMOKETEST.md
index ee4fc43da..e7793be61 100644
--- a/root/programs/SMOKETEST.md
+++ b/root/programs/SMOKETEST.md
@@ -48,6 +48,37 @@ cd root\programs
 **実行順は `1_BuildAll.ps1` → `2_RunAllTests.ps1` → `3_SmokeTest.ps1`。**
 リリース時の作業全体は [`RELEASE.md`](RELEASE.md) を参照。
 
+### 判定は「今回の出力」だけで行う（#550 で一般化）
+
+**前回の出力が残っていると、起動に失敗しても合格になる。**
+疎通テストは期待結果ファイルを持たず、**実行して出てきたもの**を判定条件と突き合わせる。
+出力が今回のものである保証が無ければ、判定そのものが成り立たない。
+
+そこで `3_SmokeTest.ps1` は、**対象を実行する前に前回の残骸を必ず消す。**
+
+| 消すもの | 何のためか |
+|---|---|
+| `$OutputDir\<対象名>.txt` / `.err`（標準出力・標準エラー） | 起動に失敗しても前回の出力で判定してしまうのを防ぐ |
+| `$OutputDir\daogen_*`（生成物） | 「生成された」の判定が甘くなるのを防ぐ（6 節） |
+
+**対象を足すときは、出力先を対象ごとに分け、実行前に消すこと。**
+
+> **見分け方 : 所要時間が `0.0 秒` の対象は疑う。**
+> 実際に起動していれば、どれだけ速くても 0.0 秒にはならない。
+>
+> ```
+> === TestTransmission (net48) ===
+>   実行中 ...
+> Start-Process : パラメーター 'ArgumentList の引数を確認できません。…
+>      出力 : NG : 0 件
+>   OK  (0.0 秒)          ← 起動に失敗しているのに OK
+> ```
+>
+> これは実際に起きた（`#550` の検証中）。`Args` を持たない対象で
+> `-ArgumentList` に null 入りの配列が渡り、**Windows PowerShell 5.1 でだけ**
+> 起動に失敗していた（PS 7 は null を空文字に変換して通すため気付けない）。
+> 残骸を消していなかったため、前回の出力で合格していた。
+
 ---
 
 ## 3. 対象（23 件）
@@ -123,7 +154,8 @@ net48 版は `System.CommandLine` / `Sharprompt` の .NET Framework サポート
 全テーブルを回しても時間がかかるだけで、疎通としては同じことを見ているため。
 
 生成先は `%TEMP%\OpenTouryoSmokeTest\daogen_*`。
-実行前に前回の生成物を消す。残っていると「生成された」の判定が甘くなる。
+実行前に前回の生成物を消す。残っていると「生成された」の判定が甘くなる
+（全対象に共通の原則。2 節「判定は『今回の出力』だけで行う」）。
 
 > **GUI 側の確認は手作業に残る。** 引数なしで起動すると `Application.Run(new Form1())` になる。
 

From 12cea4a3eda2aeaf78f747186713e20c4463d465 Mon Sep 17 00:00:00 2001
From: nishi_74322014 <nishi_74322014@ksj.biglobe.ne.jp>
Date: Sun, 16 Aug 2026 01:45:11 +0900
Subject: [PATCH 5/5] fixed #541

---
 .../{Configuration.md => CONFIGURATION.md}    |  2 +-
 .../MVC_Sample/MVC_Sample/Web.config          | 39 ++++++----------
 .../MVC_Sample/MVC_Sample/appsettings.json    | 45 +++++--------------
 .../Docker/appsettings.Container.json         | 25 +++--------
 4 files changed, 33 insertions(+), 78 deletions(-)
 rename root/programs/{Configuration.md => CONFIGURATION.md} (99%)

diff --git a/root/programs/Configuration.md b/root/programs/CONFIGURATION.md
similarity index 99%
rename from root/programs/Configuration.md
rename to root/programs/CONFIGURATION.md
index afb93fbb0..8a260b033 100644
--- a/root/programs/Configuration.md
+++ b/root/programs/CONFIGURATION.md
@@ -1,4 +1,4 @@
-# Configuration.md — 設定ファイルの扱い
+# CONFIGURATION.md — 設定ファイルの扱い
 
 対象: `root/programs` 配下（CS / VB、net48 / net10.0）
 配置: `root/programs`
diff --git a/root/programs/CS/Samples/WebApp_sample/MVC_Sample/MVC_Sample/Web.config b/root/programs/CS/Samples/WebApp_sample/MVC_Sample/MVC_Sample/Web.config
index d4b72f7e2..618f1e5d5 100644
--- a/root/programs/CS/Samples/WebApp_sample/MVC_Sample/MVC_Sample/Web.config
+++ b/root/programs/CS/Samples/WebApp_sample/MVC_Sample/MVC_Sample/Web.config
@@ -11,12 +11,8 @@
     </sectionGroup>
   </configSections>
   <!--
-    **パスワードが直に書いてあるのは、すぐ動かせるサンプルだからである。**（#541）
-    実際の環境へ持って行くときは、ここに書かず、次のいずれかで渡すこと。
-      ・別ファイルへ逃がす　　<connectionStrings configSource="connections.config" />
-      ・暗号化する　　　　　　aspnet_regiis -pef connectionStrings <パス>
-      ・統合認証にする　　　　Integrated Security=SSPI（パスワード自体を無くす）
-    netcore 側（Samples4NetCore の appsettings.json）にも同じ注記がある。
+    **パスワードが直に書いてあるのは、すぐ動かせるサンプルだからである。**
+    実際の環境での渡し方は CONFIGURATION.md 9 節。
   -->
   <connectionStrings>
     <!-- SQL Server / SQL Client用 -->
@@ -73,36 +69,30 @@
       -->
     <sessionState cookieName="mvc_session" timeout="20" cookieless="false" mode="StateServer" stateConnectionString="tcpip=127.0.0.1:42424"/>
     <!--
-      **Web サーバを複数台にするなら machineKey も要る。**（#541）
+      **Web サーバを複数台にするなら machineKey も要る。**
 
-      セッションを StateServer や SQLServer に外出ししても、それだけでは足りない。
+      セッションを外出ししても、それだけでは足りない。
       認証 Cookie（forms）と ViewState は machineKey で保護されており、
       **指定しないとサーバごとに別の鍵が自動生成される。**
-      台数を増やした途端、片方が発行した Cookie をもう片方が復号できず、
-      ログインし直しや「ビューステートの検証に失敗しました」になる。
-
       サンプルは 1 台で動かすため、既定（自動生成）のままにしてある。
-      複数台にするときは、全台で同じ値を書くこと。
 
       <machineKey validationKey="＜同じ値＞" decryptionKey="＜同じ値＞"
                   validation="HMACSHA256" decryption="AES" />
 
-      netcore 側では DataProtection の鍵が同じ役割を持つ
-      （Samples4NetCore の appsettings.json : DataProtectionKeyPath）。
+      netcore 側の対応物は CONFIGURATION.md 10 節。
     -->
     <!--<machineKey validationKey="..." decryptionKey="..." validation="HMACSHA256" decryption="AES"/>-->
     <!--
-      **リバース プロキシで TLS を終端するなら、IIS 側の設定も要る。**（#549）
-
-      前段で TLS を終端すると、IIS から見た接続は HTTP になる。
-      Request.IsSecureConnection が false のままなので、
-      **利用者のブラウザは HTTPS で繋いでいるのに Secure 属性が付かない**
-      （#536 でフレームワークが立てるようにした分が効かない）。
+      **リバース プロキシで TLS を終端するなら、IIS 側の設定も要る。**
 
+      前段で終端すると Request.IsSecureConnection が false のままになり、
+      **ブラウザは HTTPS で繋いでいるのに Secure 属性が付かない。**
       net48 では IsSecureConnection をコードから変えられないため、
-      **IIS 側で前段の X-Forwarded-Proto を見て HTTPS サーバ変数を立てる。**
+      **IIS 側で X-Forwarded-Proto を見て HTTPS サーバ変数を立てる。**
       IIS + ARR なら URL Rewrite の受信規則で行う（要 allowedServerVariables 登録）。
 
+      **※ この設定例は未検証である。**（#549）
+
       <rewrite>
         <rules>
           <rule name="ForwardedProto">
@@ -119,11 +109,10 @@
       </rewrite>
 
       **前段だけが到達できるネットワークに閉じてから使うこと。**
-      アプリを直接叩ける状態だと、クライアントが X-Forwarded-Proto を詐称でき、
-      HTTP で来ているのに HTTPS だと判断させられる。
+      直接叩ける状態だと、クライアントが X-Forwarded-Proto を詐称できる。
 
-      netcore 側は UseForwardedHeaders で同じことを行う
-      （Samples4NetCore の appsettings.json : UseForwardedHeaders）。
+      **「検知」ではなく「宣言」（forms の requireSSL="true"）で済ませる手もある。**
+      使い分けと netcore 側の対応物は CONFIGURATION.md 8 節・10 節。
     -->
     <!--
       SQLサーバ（利用の際は、以下のスクリプトを実行する）
diff --git a/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/appsettings.json b/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/appsettings.json
index 332839849..380f2c4f2 100644
--- a/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/appsettings.json
+++ b/root/programs/CS/Samples4NetCore/Backend/MVC_Sample/MVC_Sample/appsettings.json
@@ -8,11 +8,8 @@
   "AllowedHosts": "*",
   // connectionStrings section
   //
-  // **パスワードが直に書いてあるのは、すぐ動かせるサンプルだからである。**（#541）
-  //   実際の環境へ持って行くときは、ここに書かず、次のいずれかで渡すこと。
-  //     ・環境変数            connectionStrings__ConnectionString_SQL=...
-  //     ・ユーザー シークレット（開発時） dotnet user-secrets set ...
-  //     ・シークレット ストア（本番）
+  // **パスワードが直に書いてあるのは、すぐ動かせるサンプルだからである。**
+  // 実際の環境での渡し方は CONFIGURATION.md 9 節。
   "connectionStrings": {
     "ConnectionString_SQL": "Data Source=localhost;Initial Catalog=Northwind;User ID=sa;Password=seigi@123;Encrypt=false;",
     "ConnectionString_ODBC": "Dsn=odbc_test1",
@@ -23,47 +20,27 @@
 
   // appSettings section
   //
-  // ＜環境を移すとき＞（#541）
-  //   ここの値は、環境変数で上書きできる。区切りは「__」（下線 2 つ）。
-  //
-  //     appSettings__FxXMLSPDefinition=/app/files/resource/Xml/SPDefinition.xml
-  //     connectionStrings__ConnectionString_SQL=Data Source=db;...
-  //
-  //   Host.CreateDefaultBuilder が環境変数を構成に含めるため、
-  //   **FxContainerization を on にしなくても効く**
-  //   （あちらは「接頭辞なしのキー名」で読む別の仕組み）。
-  //
-  //   下の C:/root/... は、このリポジトリを Windows に展開したときの配置である。
-  //   コンテナや別の環境へ移すときは、上記の環境変数で差し替える。
+  // 下の C:/root/... は、このリポジトリを Windows に展開したときの配置である。
+  // **別の環境へ移すときは、ここを書き換えずに環境変数で差し替える。**
+  // 上書きの仕組みとパスの落とし穴は CONFIGURATION.md 3〜7 節。
   "appSettings": {
     // Webサービス用
     //"Azure": "MVC_Sample",
 
-    // 本番向けの切り替え（既定はいずれも従来どおりの動作） - start
+    // 本番向けの切り替え - start
+    //
+    // 既定はいずれも従来どおりの動作。**どれも「on にするだけ」では済まない**ので、
+    // 有効にする前に CONFIGURATION.md 8 節を読むこと。
 
     // HTTP を HTTPS へリダイレクトするか（on / off）
-    // TLS を前段のリバース プロキシで終端する構成では off のままにする。
-    // **on にするだけでは足りない。** リダイレクト先のポートが決まらないと、
-    // 警告を出すだけで素通りする。https の URL をバインドするか、
-    // 環境変数 ASPNETCORE_HTTPS_PORT=443（単数）を併せて指定する。
     "UseHttpsRedirection": "off",
     // Cookie に Secure 属性を必ず付けるか（always / 空）
-    // **平文 HTTP の環境で always にすると、Cookie が送られずログインできない。**
     "CookieSecurePolicy": "",
-    // データ保護の鍵の置き場所（空なら既定＝プロセスの環境に依存する場所）
-    // **コンテナを作り直す／複数インスタンスで動かす場合は、共有できる場所を指定する。**
-    // 指定しないと鍵が揃わず、認証 Cookie とセッションが失効する。
+    // データ保護の鍵の置き場所（空なら既定）
     "DataProtectionKeyPath": "",
-
-    // 転送ヘッダ（X-Forwarded-Proto / -For）を取り込むか（on / off）（#549）
-    // **リバース プロキシで TLS を終端するなら on にする。**
-    // off のままだと Request.IsHttps が false になり、ブラウザが HTTPS で
-    // 繋いでいても Cookie に Secure 属性が付かない。
+    // 転送ヘッダ（X-Forwarded-Proto / -For）を取り込むか（on / off）
     "UseForwardedHeaders": "off",
     // 信用する前段のアドレス（カンマ区切り。空なら範囲を制限しない）
-    // **空にすると、どこからの転送でも信用する。**
-    // アプリを前段だけが到達できるネットワークに閉じてから使うこと
-    // （直接叩ける状態では、クライアントが X-Forwarded-Proto を詐称できる）。
     "ForwardedHeadersKnownProxies": "",
 
     // 本番向けの切り替え - end
diff --git a/root/programs/CS/Samples4NetCore/Docker/appsettings.Container.json b/root/programs/CS/Samples4NetCore/Docker/appsettings.Container.json
index d7ec04f99..1f13fdab5 100644
--- a/root/programs/CS/Samples4NetCore/Docker/appsettings.Container.json
+++ b/root/programs/CS/Samples4NetCore/Docker/appsettings.Container.json
@@ -1,26 +1,18 @@
 // コンテナで動かすときの設定（#548）
 //
-// ＜これはオーバーライドである＞
-//   ASPNETCORE_ENVIRONMENT=Container のとき、appsettings.json の *後* に読まれ、
-//   **ここに書いたキーだけ**が上書きされる（丸ごと差し替えではない）。
-//   書いていないキー（FxErrorScreenPath、FxSqlTraceLog、OAuth2 の設定など）は
-//   appsettings.json の値がそのまま生きる。
+// **ASPNETCORE_ENVIRONMENT=Container のときだけ読まれ、ここに書いたキーだけを
+// 上書きする**（丸ごと差し替えではない）。さらに環境変数の方が強い。
 //
-//   さらに後段の環境変数（docker-compose.yml の environment）が最も強い。
+//   appsettings.json → appsettings.Container.json → 環境変数
 //
-//     appsettings.json → appsettings.Container.json → 環境変数
-//
-// ＜%OT_RESOURCE_ROOT% について＞
-//   これは OS の機能ではなく、**Open棟梁が自前で展開している**
-//   （ResourceLoader.ResolveFilePath → StringVariableOperator）。
-//   したがって Linux コンテナでも効く。値は docker-compose.yml で与える。
+// 仕組みは CONFIGURATION.md 3〜5 節。%OT_RESOURCE_ROOT% の値は docker-compose.yml で与える。
+// このサンプル固有の事情は README.md。
 {
   "appSettings": {
 
     // フレームワークの使用するパラメータ - start
     //
-    // **フォルダ名は Xml（XML ではない）。**
-    // 大文字小文字を区別する Linux では、綴りが違うと開けない（#550）。
+    // **フォルダ名は Xml（XML ではない）。** Linux では綴りが違うと開けない。
     "FxXMLSPDefinition": "%OT_RESOURCE_ROOT%/Xml/SPDefinition.xml",
     "FxXMLMSGDefinition": "%OT_RESOURCE_ROOT%/Xml/MSGDefinition.xml",
     "FxXMLTCDefinition": "%OT_RESOURCE_ROOT%/Xml/TCDefinition.xml",
@@ -29,16 +21,13 @@
 
     // 共通部品の使用するパラメータ - start
     //
-    // log4net の定義はコンテナ専用のものを使う（出力先が違うため）。
-    // リポジトリの resource/Log/SampleLogConf.xml は ro でマウントしており、
-    // 中の出力先も C:\root\... のままなので、そちらは使わない。
+    // log4net の定義はコンテナ専用のものを使う（出力先が違うため。README.md 参照）。
     "FxLog4NetConfFile": "/app/conf/SampleLogConf.xml",
     // 共通部品の使用するパラメータ - end
 
     // 本番向けの切り替え - start
     //
     // HTTPS で公開するので、**本番と同じ設定のまま動かせる**。
-    // これが「開発は HTTP、本番だけ HTTPS」を避けたい理由でもある。
     "UseHttpsRedirection": "on",
     "CookieSecurePolicy": "always",
     // データ保護の鍵。docker-compose.yml でボリュームを当てている。