部署 ASP.NET 應用程式時,web.config 中的資料庫連線字串若以明文儲存,極易洩露帳號密碼。.NET 內建 RSA 保護組態提供者 可加密指定區段(connectionStrings、system.web/identity 等),本文提供完整步驟與腳本自動化指南。
# 以系統管理員身分執行
aspnet_regiis -pc "MyAppKeys" -exp
-pc:建立可匯出的 RSA 金鑰容器(-exp 允許匯出備份)。MyAppKeys 自訂,後續步驟需一致。<configuration>
<configProtectedData>
<providers>
<add name="MyAppProvider"
type="System.Configuration.RsaProtectedConfigurationProvider"
keyContainerName="MyAppKeys"
useMachineContainer="true" />
</providers>
</configProtectedData>
<!-- 其它區段 -->
</configuration>
建立批次檔 encrypt_webconfig.bat 放在網站根目錄:
@echo off
set FRAMEWORK=%windir%\Microsoft.NET\Framework\v4.0.30319
set SITE_PATH=%~dp0
%FRAMEWORK%\aspnet_regiis -pef "connectionStrings" "%SITE_PATH%" -prov "MyAppProvider"
%FRAMEWORK%\aspnet_regiis -pef "system.web/identity" "%SITE_PATH%" -prov "MyAppProvider"
echo 加密完成,請檢查 web.config
pause
-pef:加密實體路徑下的區段(適用 IIS 部署)。-prov:指定步驟 2 註冊的提供者名稱。加密後,金鑰儲存在 C:\ProgramData\Microsoft\Crypto\RSA\MachineKeys\。需給 IIS_IUSRS 或應用程式集區身分(如 IIS APPPOOL\MyAppPool)讀取權限,否則啟動時拋出 The RSA key container could not be opened。
icacls "C:\ProgramData\Microsoft\Crypto\RSA\MachineKeys\*" /grant "IIS_IUSRS:R"
# 或針對特定金鑰檔(依建立時間找最新)
@echo off
set FRAMEWORK=%windir%\Microsoft.NET\Framework\v4.0.30319
set SITE_PATH=%~dp0
%FRAMEWORK%\aspnet_regiis -pdf "connectionStrings" "%SITE_PATH%"
%FRAMEWORK%\aspnet_regiis -pdf "system.web/identity" "%SITE_PATH%"
pause
# 來源機器匯出含私鑰的 XML
aspnet_regiis -px "MyAppKeys" "C:\Keys\MyAppKeys.xml" -pri
# 目標機器匯入
aspnet_regiis -pi "MyAppKeys" "C:\Keys\MyAppKeys.xml" -exp
# 同樣需授權 MachineKeys 讀取權限
| 錯誤現象 | 原因 | 解決 |
|---|---|---|
| RSA key container could not be opened | 應用程式集區身分無 MachineKeys 讀取權限 | icacls 授權 IIS_IUSRS 或特定 AppPool 身分 |
| 加密後本機開發機無法除錯 | 開發機無相同金鑰容器 | 開發機同樣匯入金鑰,或開發環境不加密 |
| 共享主機無法存取 MachineKeys | 無系統管理員權限 | 改用 DpapiProtectedConfigurationProvider(用戶層級)或 Azure Key Vault |
善用 aspnet_regiis 與 RSA 提供者,幾分鐘即可將敏感設定加密落地。關鍵在於金鑰容器建立、提供者註冊、區段加密、權限授予四步驟缺一不可。配合 CI/CD 流程自動化,讓安全性成為部署常態而非事後補丁。