回滾計畫範本(Rollback Plan Template)

回滾計畫範本(Rollback Plan) 參照標準:ITIL 4(Release and Deployment Management)/ ISO/IEC 20000-1:2018 文件用途:定義版本上線後若出現嚴重問題時的回復策略與操作步驟 適用階段:部署上線階段(Deployment Phase)— Change Enablement 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 8.3 節 📋 章節目錄 文件資訊 回滾觸發條件 回滾決策流程 回滾策略 回滾前準備 回滾執行步驟 資料庫回滾 回滾驗證 通知與溝通 回滾後行動 審查與驗證 1. 文件資訊 📝 範本 項目 內容 文件編號 RP-{專案代碼}-{版本}-{序號} 文件名稱 {系統名稱} v{x.x.x} 回滾計畫 版本 v{主版本}.{次版本} 對應發佈版本 v{x.x.x} 建立日期 {YYYY-MM-DD} 撰寫者 {DevOps/SRE 姓名} 審核者 {Tech Lead / SM} 回滾時間窗口 上線後 {N} 小時內 最大容許停機 {N} 分鐘 回滾方式 Blue-Green / Canary Rollback / 全量回滾 📖 使用說明 回滾計畫是部署計畫的必要附件,每次上線都需準備 回滾時間窗口:超過此時間,資料可能已累積,回滾成本大幅增加 回滾方式取決於部署架構: Blue-Green:切換流量至舊版(秒級) Canary Rollback:停止灰度,流量回到舊版(秒級) 全量回滾:重新部署舊版 Image(分鐘級) 💡 範例 項目 內容 文件編號 RP-HRM-v2.1.0-001 對應發佈版本 v2.1.0 回滾時間窗口 上線後 4 小時內 最大容許停機 5 分鐘 回滾方式 Blue-Green(K8s Service 切換) 2. 回滾觸發條件 📝 範本 2.1 自動觸發(需設定監控告警) 條件 ID 觸發條件 監控指標 閾值 RT-AUTO-{xxx} {條件描述} {指標} {閾值} 2.2 人工判斷觸發 條件 ID 觸發條件 判斷依據 決策者 RT-MANUAL-{xxx} {條件描述} {判斷依據} {角色} 📖 使用說明 自動觸發:由監控系統偵測到異常時自動發起(或告警後快速決策) 人工判斷:需要人為判斷的複雜情境 觸發條件需事先定義並經團隊共識,避免上線時臨時爭論 💡 範例 2.1 自動觸發 條件 ID 觸發條件 監控指標 閾值 RT-AUTO-001 API 錯誤率飆升 HTTP 5xx Rate > 5% 持續 3 分鐘 RT-AUTO-002 回應時間嚴重惡化 P95 Latency > 5s 持續 5 分鐘 RT-AUTO-003 核心服務健康檢查失敗 Health Check 連續 3 次失敗 RT-AUTO-004 資料庫連線耗盡 DB Connection Pool > 95% 使用率持續 2 分鐘 2.2 人工判斷觸發 條件 ID 觸發條件 判斷依據 決策者 RT-MANUAL-001 核心業務流程異常(薪資計算錯誤) 使用者回報 + 日誌確認 Tech Lead RT-MANUAL-002 資安事件(疑似資料洩露) 資安告警 + SOC 確認 資安主管 RT-MANUAL-003 資料損壞(不一致/遺失) DB 檢查確認 DBA + Tech Lead 3. 回滾決策流程 📝 範本 偵測異常 → 通知值班人員 → 初步評估(5 分鐘內) │ ├── 可快速修復(Hotfix) → 修復並部署 → 持續觀察 │ └── 無法快速修復 → 啟動回滾決策 │ ├── 決策者確認回滾 → 執行回滾 │ └── 暫時降級(Feature Flag) → 持續觀察 決策權限矩陣 情境 決策者 升級時機 {情境} {角色} {超過 N 分鐘未解決時升級} 📖 使用說明 決策流程需在 5-15 分鐘內完成,避免長時間討論 權限矩陣確保深夜/假日也有人可做決策 Feature Flag 降級是比全量回滾更輕量的選項(如果有準備的話) 💡 範例 決策權限矩陣 情境 決策者 升級時機 上班時間(09-18) Tech Lead → PM 10 分鐘未決定 → VP Engineering 下班/假日 值班 SRE → On-call Tech Lead 15 分鐘未回應 → VP Engineering 資安事件 資安主管(不論時段) 立即通知 CTO 4. 回滾策略 📝 範本 4.1 回滾方式比較 方式 停機時間 適用場景 風險 {方式} {時間} {場景} {風險} 4.2 本次採用策略 項目 說明 回滾方式 {Blue-Green / Canary / Rolling / 全量} 回滾目標版本 v{x.x.x} 預計停機時間 {N} 分鐘 資料庫回滾 是/否(需要/不需要) Feature Flag 是/否(可局部降級) 📖 使用說明 選擇回滾策略需考量:停機影響、資料安全、回復速度 Blue-Green 最快(秒級切換)但需雙倍資源 有 DB Schema 變更時回滾最複雜,需額外評估 若有 Feature Flag,優先考慮關閉新功能而非全量回滾 💡 範例 4.1 回滾方式比較 方式 停機時間 適用場景 風險 Blue-Green 切換 < 30s K8s Service selector 切換 新舊版 DB Schema 需相容 Canary 回滾 < 30s 灰度比例回 0% 僅灰度階段可用 K8s Rolling Rollback 2-5 min kubectl rollout undo 過程中有混合版本 全量回滾 + DB Restore 15-30 min DB Schema 不相容時 停機長、可能丟失資料 4.2 本次採用策略 項目 說明 回滾方式 Blue-Green(K8s 保留舊版 Deployment) 回滾目標版本 v2.0.3 預計停機時間 < 1 分鐘 資料庫回滾 否(DB Migration 向後相容) Feature Flag 是(可先關閉 WebSocket 推播功能) 5. 回滾前準備 📝 範本 5.1 準備清單(部署前完成) # 準備事項 負責人 狀態 1 {準備事項} {人員} ☐ 2 {準備事項} {人員} ☐ 5.2 環境快照 項目 備份位置 備份時間 保留期限 {項目} {位置} {時間} {期限} 📖 使用說明 回滾準備必須在部署「前」完成,而非出問題才做 資料庫快照是最重要的準備(資料不可逆) 確認舊版 Image 仍可取得、舊版設定仍可存取 💡 範例 5.1 準備清單 # 準備事項 負責人 狀態 1 資料庫全量備份(pg_dump) DBA ☑ 2 保留舊版 Deployment(hrms-blue, replicas=0) DevOps ☑ 3 確認舊版 Image 可拉取:hrms:v2.0.3 DevOps ☑ 4 備份 Kong 路由設定 DevOps ☑ 5 確認 Feature Flag 可遠端關閉 後端組 ☑ 6 值班人員確認聯絡方式 SM ☑ 5.2 環境快照 項目 備份位置 備份時間 保留期限 PostgreSQL Full Backup Azure Blob / hrm-backup/ 部署前 30 分鐘 7 天 Redis RDB Snapshot Azure Blob / redis-backup/ 部署前 30 分鐘 3 天 Kong Config Export Git repo / infra/kong/ 部署前 commit 永久 K8s Manifest (old) Git repo / k8s/ 部署前 Tag 永久 6. 回滾執行步驟 📝 範本 6.1 執行步驟(依序執行) 步驟 動作 命令/操作 預期結果 執行者 1 {動作} {命令} {預期} {人員} 2 {動作} {命令} {預期} {人員} 6.2 回滾腳本 #!/bin/bash # Rollback Script - {系統名稱} v{x.x.x} → v{x.x.x} # 使用方式:./rollback.sh {腳本內容} 📖 使用說明 步驟需足夠詳細,讓非撰寫者也能執行 回滾腳本需事前測試(在 Staging 環境驗證) 每個步驟標明預期結果,便於判斷是否正確執行 腳本優先於手動操作(減少人為失誤) 💡 範例 6.1 執行步驟 步驟 動作 命令/操作 預期結果 執行者 1 確認決策 Slack 記錄回滾決策 決策者確認 SM 2 關閉新功能 Feature Flag LaunchDarkly: payroll-scheduler=OFF, ws-notification=OFF Flag 生效 後端組 3 切換流量至舊版 kubectl patch svc hrms -p '{"spec":{"selector":{"version":"v2.0.3"}}}' 流量轉到 Blue DevOps 4 Scale up 舊版 kubectl scale deploy hrms-blue --replicas=3 3 Pod Running DevOps 5 驗證舊版健康 curl https://hrms.internal/health HTTP 200 + version=v2.0.3 DevOps 6 Scale down 新版 kubectl scale deploy hrms-green --replicas=0 0 Pod DevOps 7 更新 Kong 路由 移除 /ws 路由 WebSocket 端點移除 DevOps 8 驗證完整功能 執行冒煙測試腳本 All Pass QA 6.2 回滾腳本 #!/bin/bash # Rollback Script - HRMS v2.1.0 → v2.0.3 # 使用方式:./rollback-hrms-v2.1.0.sh set -euo pipefail echo "=== HRMS Rollback: v2.1.0 → v2.0.3 ===" echo "開始時間: $(date -Iseconds)" # Step 1: Scale up old version echo "[1/5] Scaling up v2.0.3 (Blue)..." kubectl scale deploy hrms-blue --replicas=3 -n hrms kubectl rollout status deploy/hrms-blue -n hrms --timeout=120s # Step 2: Switch traffic echo "[2/5] Switching Service to v2.0.3..." kubectl patch svc hrms-api -n hrms \ -p '{"spec":{"selector":{"version":"v2.0.3"}}}' # Step 3: Verify health echo "[3/5] Verifying health..." sleep 5 HEALTH=$(curl -s -o /dev/null -w "%{http_code}" https://hrms.internal/health) if [ "$HEALTH" != "200" ]; then echo "ERROR: Health check failed! Manual intervention required." exit 1 fi # Step 4: Scale down new version echo "[4/5] Scaling down v2.1.0 (Green)..." kubectl scale deploy hrms-green --replicas=0 -n hrms # Step 5: Remove WebSocket route echo "[5/5] Removing WebSocket route from Kong..." curl -s -X DELETE http://kong-admin:8001/routes/hrms-websocket echo "=== Rollback Complete: $(date -Iseconds) ===" echo "請執行冒煙測試驗證: ./smoke-test.sh" 7. 資料庫回滾 📝 範本 7.1 DB Migration 相容性評估 Migration 描述 向後相容 回滾方式 {Migration 名稱} {描述} 是/否 {回滾方式} 7.2 資料庫回滾步驟(若需要) 步驟 動作 命令 風險 1 {動作} {命令} {風險} 📖 使用說明 向後相容的 Migration:新增欄位/表 → 不需回滾(舊版忽略新欄位即可) 不相容的 Migration:刪除/重命名欄位 → 必須回滾 資料庫回滾最危險,可能造成資料遺失,需事先做好備份 原則:盡量設計向後相容的 Migration(Expand-Contract Pattern) 💡 範例 7.1 DB Migration 相容性評估 Migration 描述 向後相容 回滾方式 AddNotificationLogs 新增 notification_logs 表 ✅ 是 不需回滾(舊版不使用此表) AddSchedulerColumns payroll 表新增 3 個 nullable 欄位 ✅ 是 不需回滾(舊版忽略) ✅ 本版所有 Migration 均為向後相容,無需資料庫回滾 ...

May 18, 2026 · 6 min · 1266 words · Eric Cheng

威脅模型範本(Threat Model Template)

威脅模型範本(Threat Model Document) 參照標準:Microsoft STRIDE / OWASP Threat Modeling / ISO/IEC 27005:2022 文件用途:系統性識別、分析、評估與處置系統面臨的安全威脅 適用階段:系統設計階段(Design Phase)— Security by Design 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 9.1 節 📋 章節目錄 文件資訊 系統概述 資料流程圖(DFD) 信任邊界識別 STRIDE 威脅分析 威脅風險評估 緩解措施 殘餘風險 威脅追溯矩陣 附錄 審查與驗證 1. 文件資訊 📝 範本 項目 內容 文件編號 TM-{專案代碼}-{序號} 文件名稱 {系統名稱} 威脅模型 版本 v{主版本}.{次版本} 狀態 草稿 / 審核中 / 核定 建立日期 {YYYY-MM-DD} 撰寫者 {姓名/角色} 資安審核者 {資安人員姓名} 威脅建模方法 STRIDE / PASTA / LINDDUN 分析範圍 {描述分析涵蓋的系統邊界} 📖 使用說明 威脅模型在架構設計完成後、開發實作前進行 建議組成跨功能團隊:架構師 + 資安人員 + 開發者 + QA STRIDE 是微軟提出的分類法,覆蓋六大威脅類型 本文件需與安全需求清單(SecurityRequirements)互相參照 💡 範例 項目 內容 文件編號 TM-HRM-001 系統名稱 人力資源管理系統(HRMS) 威脅建模方法 STRIDE 分析範圍 Web 前端、API Gateway、微服務層、資料庫層、外部整合(AD/Email) 2. 系統概述 📝 範本 2.1 系統架構摘要 元件 技術 角色描述 {元件名稱} {技術/框架} {職責說明} 2.2 資產識別 資產 ID 資產名稱 資產類型 敏感等級 擁有者 ASSET-{xxx} {名稱} 資料/服務/基礎設施 高/中/低 {團隊} 📖 使用說明 系統架構摘要提供技術棧全貌,協助識別攻擊面 資產識別需列出需保護的有價值目標(攻擊者感興趣的) 資產敏感等級決定威脅分析的優先順序 💡 範例 2.1 系統架構摘要 元件 技術 角色描述 Web SPA React 18 + TypeScript 使用者介面 API Gateway Kong 3.x 請求路由、速率限制、認證 Auth Service .NET 8 + IdentityServer 身分認證與 Token 核發 HR Core Service .NET 8 Web API 員工/薪資/假勤核心邏輯 PostgreSQL v16 關聯式資料儲存 Redis v7 Session/Cache 快取 Active Directory Windows Server 2022 企業帳號整合 2.2 資產識別 資產 ID 資產名稱 資產類型 敏感等級 擁有者 ASSET-001 員工個資(身分證/地址/緊急聯絡人) 資料 高 HR 部門 ASSET-002 薪資明細(薪資/獎金/扣款) 資料 高 財務部 ASSET-003 認證 Token / Session 資料 高 系統 ASSET-004 API Gateway 服務 中 IT 維運 ASSET-005 資料庫加密金鑰 基礎設施 高 資安團隊 3. 資料流程圖(DFD) 📝 範本 Level 0 - 系統環境圖 外部實體 → [系統邊界] → 外部實體 Level 1 - 子系統分解 DFD 元素 符號 說明 外部實體 矩形 系統範圍外的使用者/系統 處理程序 圓形 系統內部邏輯處理 資料儲存 平行線 資料庫/檔案 資料流 箭頭 資料移動方向 信任邊界 虛線框 安全等級分界 📖 使用說明 DFD 是威脅建模的核心輸入,透過視覺化理解資料流向 Level 0 呈現系統與外部互動全貌 Level 1 展開各子系統,識別每個資料流的信任邊界 建議使用工具:Microsoft Threat Modeling Tool、OWASP Threat Dragon 💡 範例 Level 1 - HRMS 子系統分解 ┌─────────────────── 信任邊界:Internet ───────────────────┐ │ │ │ [員工/主管] ────→ Web SPA (React) │ │ │ └─────────────────────────────────────────────────────────┘ │ HTTPS (JWT) ┌────────────────── 信任邊界:DMZ ────────────────────────┐ │ ▼ │ │ (API Gateway - Kong) │ │ │ │ └───────────────────────────┼──────────────────────────────┘ │ mTLS ┌────────────────── 信任邊界:Internal ───────────────────┐ │ ▼ │ │ (Auth Service) ←── (HR Core Service) │ │ │ │ │ │ ▼ ▼ │ │ [Redis Cache] [PostgreSQL DB] │ │ │ └─────────────────────────────────────────────────────────┘ │ LDAPS ┌────────────────── 信任邊界:Enterprise ─────────────────┐ │ ▼ │ │ [Active Directory] │ │ │ └─────────────────────────────────────────────────────────┘ 4. 信任邊界識別 📝 範本 邊界 ID 邊界名稱 起點 終點 跨越邊界的資料 保護機制 TB-{xxx} {邊界名稱} {元件} {元件} {資料描述} {保護} 📖 使用說明 信任邊界是安全等級不同的兩個區域之間的分界線 跨越信任邊界的資料流是威脅分析的重點(攻擊最可能發生處) 每條跨邊界的資料流都需要相應的保護機制 💡 範例 邊界 ID 邊界名稱 起點 終點 跨越邊界的資料 保護機制 TB-001 Internet → DMZ Web SPA API Gateway HTTP 請求 + JWT TLS 1.2+(優先 1.3)、WAF、Rate Limit TB-002 DMZ → Internal API Gateway HR Core Service API 呼叫 + 使用者上下文 mTLS、服務網格 TB-003 Internal → DB HR Core Service PostgreSQL SQL 查詢 + 個資 連線加密、最小權限 TB-004 Internal → Enterprise Auth Service Active Directory LDAP 認證請求 LDAPS (636 port) 5. STRIDE 威脅分析 📝 範本 STRIDE 分類說明 類型 英文 說明 違反的安全屬性 S Spoofing 身份冒充 認證(Authentication) T Tampering 資料竄改 完整性(Integrity) R Repudiation 否認行為 不可否認性(Non-Repudiation) I Information Disclosure 資訊洩露 機密性(Confidentiality) D Denial of Service 阻斷服務 可用性(Availability) E Elevation of Privilege 權限提升 授權(Authorization) 威脅列表 威脅 ID STRIDE 目標元件 威脅描述 攻擊場景 THR-{xxx} S/T/R/I/D/E {元件} {威脅描述} {攻擊者如何利用} 📖 使用說明 逐一對每個 DFD 元素(處理程序、資料儲存、資料流)套用 STRIDE 外部實體通常只分析 S(Spoofing)和 R(Repudiation) 資料儲存通常分析 T、I、D 處理程序所有 STRIDE 類型都適用 每個威脅需具體描述攻擊場景(非泛泛而談) 💡 範例 威脅 ID STRIDE 目標元件 威脅描述 攻擊場景 THR-001 S API Gateway 偽造 JWT Token 冒充合法使用者 攻擊者取得 JWT Secret 或使用弱演算法偽造 Token THR-002 T HR Core Service 竄改薪資計算邏輯 內部人員修改薪資計算 API 參數,增加自己薪資 THR-003 R HR Core Service 管理員否認執行薪資調整操作 管理員調整薪資後聲稱未進行此操作 THR-004 I PostgreSQL 員工個資大量外洩 SQL Injection 或未加密備份遭竊 THR-005 D API Gateway DDoS 癱瘓打卡/請假功能 攻擊者以大量請求衝擊 API Gateway THR-006 E Auth Service 一般員工提升至 Admin 權限 利用 IDOR 漏洞修改角色欄位 THR-007 I Redis Cache Session 資料從快取洩露 未加密的 Redis 連線被中間人竊聽 THR-008 S Active Directory 暴力破解 AD 帳號密碼 對 LDAP 認證端點進行字典攻擊 6. 威脅風險評估 📝 範本 風險評分標準(DREAD 或自訂) 評分維度 1(低) 2(中) 3(高) 影響程度(Impact) 非敏感資料 部分敏感資料 核心/大量敏感資料 發生可能性(Likelihood) 需高階技術+內部存取 中等技術+外部存取 低門檻+自動化工具 可利用性(Exploitability) 無公開漏洞 有概念驗證 有公開利用工具 風險評估結果 威脅 ID 影響 可能性 可利用性 總分 風險等級 THR-{xxx} {1-3} {1-3} {1-3} {N} 高/中/低 📖 使用說明 風險等級 = 影響 × 可能性 × 可利用性(或加總取平均) 高風險(7-9分):必須在上線前處置 中風險(4-6分):計畫性處理,可接受短期風險 低風險(1-3分):記錄並持續監控 風險評估結果決定緩解措施的優先順序 💡 範例 威脅 ID 影響 可能性 可利用性 總分 風險等級 THR-001 3 2 2 7 高 THR-002 3 1 1 5 中 THR-003 2 2 3 7 高 THR-004 3 2 3 8 高 THR-005 2 3 3 8 高 THR-006 3 2 2 7 高 THR-007 2 1 2 5 中 THR-008 3 2 3 8 高 7. 緩解措施 📝 範本 威脅 ID 緩解措施 對應安全需求 實作方式 負責人 狀態 THR-{xxx} {緩解描述} SEC-{xxx} {技術/流程手段} {人員} 未開始/進行中/完成 📖 使用說明 每個高/中風險威脅都需要對應的緩解措施 緩解策略分為四種: 消除:重新設計,完全移除威脅(最佳) 緩解:降低影響或可能性(最常見) 轉移:轉移風險給第三方(保險/外包) 接受:記錄風險,不處理(需管理層核准) 緩解措施需連結到安全需求清單(SecurityRequirements)中的具體需求 💡 範例 威脅 ID 緩解措施 對應安全需求 實作方式 負責人 狀態 THR-001 使用 RS256 非對稱簽章 + 短效 Token SEC-AUTH-006 JWT RS256 + 15min Expiry 後端組 完成 THR-003 所有薪資操作記錄不可竄改稽核日誌 SEC-LOG-001, SEC-LOG-004 Append-only audit log + 時間戳簽章 後端組 進行中 THR-004 個資欄位加密 + 參數化查詢 + WAF SEC-DATA-001, SEC-INPUT-002 AES-256 + EF Core parameterized + ModSecurity 全端 完成 THR-005 API Rate Limiting + CDN + Auto-scaling SEC-INPUT-005 Kong rate-limit plugin (100 req/min) + Azure CDN DevOps 完成 THR-006 伺服器端角色驗證 + 單元測試覆蓋 SEC-AUTHZ-001, SEC-AUTHZ-003 [Authorize(Roles=“Admin”)] + IDOR 防護 後端組 完成 THR-008 帳號鎖定 + MFA + IP 白名單 SEC-AUTH-002, SEC-AUTH-003 AD 帳號鎖定策略 + Azure MFA IT 維運 進行中 8. 殘餘風險 📝 範本 威脅 ID 殘餘風險描述 緩解後風險等級 接受理由 核准者 核准日期 THR-{xxx} {緩解後仍存在的風險} 高/中/低 {為何可接受} {管理層} {日期} 📖 使用說明 殘餘風險 = 實施緩解措施後仍無法完全消除的風險 所有殘餘風險需經管理層正式核准(Risk Acceptance) 殘餘風險需定期重新評估(至少每季度) 高殘餘風險應有補償性控制措施 💡 範例 威脅 ID 殘餘風險描述 緩解後風險等級 接受理由 核准者 核准日期 THR-005 DDoS 超過 CDN 容量時仍可能影響可用性 低 CDN 已可承受 99% 場景,剩餘機率極低 CTO 2026-05-15 THR-007 Redis 若被直接存取仍可讀取 Session 低 Redis 位於 VPC 內網,無外部可達性 資安主管 2026-05-15 9. 威脅追溯矩陣 📝 範本 威脅 ID DFD 元素 信任邊界 安全需求 緩解措施 測試案例 THR-{xxx} {元件} TB-{xxx} SEC-{xxx} {緩解} TC-{xxx} 📖 使用說明 追溯矩陣確保每個威脅都能向前追溯到架構元素、向後追溯到測試案例 完整鏈路:DFD 元素 → 信任邊界 → 威脅 → 安全需求 → 緩解措施 → 測試驗證 若某威脅沒有對應的測試案例,代表測試覆蓋不足 💡 範例 威脅 ID DFD 元素 信任邊界 安全需求 緩解措施 測試案例 THR-001 API Gateway TB-001 SEC-AUTH-006 RS256 + 短效 Token TC-SEC-001: Token 偽造測試 THR-004 PostgreSQL TB-003 SEC-DATA-001, SEC-INPUT-002 加密 + 參數化查詢 TC-SEC-004: SQL Injection Pen Test THR-005 API Gateway TB-001 SEC-INPUT-005 Rate Limiting TC-SEC-005: 壓力測試 + DDoS 模擬 THR-006 Auth Service TB-002 SEC-AUTHZ-001 伺服器端授權 TC-SEC-006: IDOR 測試 10. 附錄 📝 範本 10.1 威脅建模會議記錄 日期 參與者 討論主題 決議 {日期} {姓名,角色} {主題} {決議} 10.2 參考資料 資源 用途 OWASP Threat Modeling Cheat Sheet 威脅建模方法論參考 Microsoft STRIDE per Element 每元素類型適用的 STRIDE 分析 OWASP ASVS 5.0.0 安全需求對照標準(威脅對策轉成需求時引用 5.0 編號) OWASP Top 10:2025 威脅分類與常見弱點對照 《軟體開發標準程序教學手冊》9.1 威脅建模四個問題與轉換為需求/測試的作法 ISO/IEC 27005:2022 風險評估方法論 📖 使用說明 會議記錄保留威脅建模決策的可追溯性 建議威脅模型每個 Sprint 或重大架構變更時更新 工具推薦:Microsoft Threat Modeling Tool (免費)、OWASP Threat Dragon (開源) 💡 範例 10.1 威脅建模會議記錄 日期 參與者 討論主題 決議 2026-04-10 張架構師, 李資安, 王開發 Level 1 DFD 繪製與邊界確認 TB-001~TB-004 確認 2026-04-12 張架構師, 李資安, 陳 QA STRIDE 分析(THR-001~008) 8 個威脅確認,6 個為高風險 2026-04-15 CTO, 資安主管, 張架構師 殘餘風險接受 THR-005, THR-007 殘餘風險核准接受 11. 審查與驗證 本節供審查者使用,也用來檢查 AI 依本範本產出的文件是否正確;對應《軟體開發標準程序教學手冊》v2.0 各章的「審查與驗證」。 ...

May 18, 2026 · 6 min · 1117 words · Eric Cheng

安全需求清單範本(Security Requirements Checklist Template)

安全需求清單範本(Security Requirements Checklist) 參照標準:OWASP ASVS 5.0.0(Application Security Verification Standard)/ ISO/IEC 27001:2022 Annex A 文件用途:定義系統應滿足的安全需求,確保設計與開發階段納入安全考量 適用階段:需求分析階段(Requirements Phase)— Security by Design 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 3.2、5.4、9.1 節 📋 章節目錄 文件資訊 安全需求概述 認證需求 授權與存取控制 資料保護需求 輸入驗證與輸出編碼 Session 管理 日誌與監控需求 通訊安全 組態安全 合規性需求 附錄 審查與驗證 1. 文件資訊 📝 範本 項目 內容 文件編號 SR-{專案代碼}-{序號} 文件名稱 {系統名稱} 安全需求清單 版本 v{主版本}.{次版本} 狀態 草稿 / 審核中 / 核定 建立日期 {YYYY-MM-DD} 撰寫者 {姓名/角色} 資安審核者 {資安人員姓名} ASVS 版本/等級 ASVS 5.0.0 / Level 1 / Level 2 / Level 3 📖 使用說明 依據 OWASP ASVS 5.0.0,安全需求分為三個驗證等級: Level 1:所有應用程式的最低標準,大部分可用自動化工具驗證 Level 2:處理個資、金流等敏感資料的應用程式(大多數企業系統) Level 3:最高安全等級(金流核心、身分驗證中心、關鍵基礎設施) 等級依專案風險分級選用(手冊 2.5、5.4):風險 L1 高 → ASVS L2(關鍵元件 L3);風險 L2 中 → ASVS L2;風險 L3 低 → ASVS L1 本清單在需求階段制定,貫穿整個 SDLC(設計需遵循、開發需實作、測試需驗證) ⚠️ ASVS 5.0 的章節與需求編號已與 4.0.3 不同(例如 4.0.3 的 V2 身分驗證在 5.0 為 V6)。引用時必須寫出版本,格式為 v5.0.0-{章}.{節}.{條},例如 v5.0.0-6.2.1 💡 範例 項目 內容 文件編號 SR-HRM-001 系統名稱 人力資源管理系統 ASVS 版本/等級 ASVS 5.0.0 / Level 2(處理員工個資與薪資資料) 2. 安全需求概述 📝 範本 2.1 系統安全分類 項目 評估 資料敏感度 一般 / 敏感 / 高度敏感 系統曝露面 內部 / 外部 / 混合 使用者類型 內部員工 / 外部客戶 / 合作夥伴 法規要求 {適用法規} 專案風險等級(手冊 2.5) L1 高 / L2 中 / L3 低 安全等級 ASVS 5.0.0 Level {1/2/3} 2.2 安全需求追溯矩陣 安全需求 ID 需求描述 ASVS 5.0 參照 對應 FRD 對應威脅(威脅模型) 驗證方式 優先級 SEC-{xxx} {描述} {章}.{節}.{條} FR-{xxx} T-{xx} {自動化測試/SAST/DAST/人工} 高/中/低 📖 使用說明 安全分類決定應套用的 ASVS Level 追溯矩陣確保每個安全需求可連結到 FRD 需求、威脅模型與 ASVS 條文,並寫出如何驗證 優先級考量:法規強制 > 高風險 > 一般防護 💡 範例 2.1 系統安全分類 項目 評估 資料敏感度 高度敏感(身分證字號、薪資、銀行帳號) 系統曝露面 混合(內部網路 + VPN 遠端存取) 使用者類型 內部員工(全體) + HR 管理人員 法規要求 個人資料保護法、勞動基準法 專案風險等級(手冊 2.5) L1 高(處理個資與薪資) 安全等級 ASVS 5.0.0 Level 2 2.2 安全需求追溯矩陣(節錄) 安全需求 ID 需求描述 ASVS 5.0 參照 對應 FRD 對應威脅 驗證方式 優先級 SEC-AUTHZ-002 員工僅能查詢自己的薪資資料 8.2.2 FR-021 T-03 整合測試:以 A 員工 Token 查 B 員工薪資 → 403 高 SEC-AUTH-005 密碼以 Argon2id 雜湊儲存 11.4.2 FR-001 T-07 程式碼審查 + 檢查資料庫雜湊格式 {argon2} 高 3. 認證需求(Authentication) 📝 範本 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 實作狀態 SEC-AUTH-001 {認證需求描述} 6.{x}.{x} L{N} 必須/建議 ☐ SEC-AUTH-002 {認證需求描述} 6.{x}.{x} L{N} 必須/建議 ☐ 📖 使用說明 對應 OWASP ASVS 5.0 V6(Authentication);密碼雜湊對應 V11.4;聯合身分(SSO)對應 V6.8 與 V10(OAuth/OIDC) Level 1:基本密碼安全;Level 2:多因子認證(MFA)或等效組合;Level 3:密碼學認證機制 認證需求需涵蓋:密碼策略、防暴力破解、MFA、密碼重設、SSO ⚠️ ASVS 5.0 的密碼政策與傳統作法不同:不得要求大小寫/數字/特殊字元等組成規則(6.2.5),不得強制定期更換密碼(6.2.10),改以長度、常見密碼與外洩密碼比對來提升強度 💡 範例 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 實作狀態 SEC-AUTH-001 密碼長度至少 12 字元(ASVS 下限 8、強烈建議 15);允許至少 64 字元 6.2.1、6.2.9 L1/L2 必須 ☑ SEC-AUTH-002 不設密碼組成規則,不強制定期更換;註冊與變更密碼時比對常見密碼清單與外洩密碼 6.2.5、6.2.10、6.2.4、6.2.12 L1/L2 必須 ☐ SEC-AUTH-003 依文件定義的機制防禦帳密填充與暴力破解(每帳號連續失敗 5 次後延遲 15 分鐘,並對來源 IP 限流),不得造成惡意鎖定他人帳號 6.1.1、6.3.1 L1 必須 ☑ SEC-AUTH-004 全體使用者啟用 MFA(或等效的多重單因子組合) 6.3.3 L2 必須 ☑ SEC-AUTH-005 密碼以 Argon2id 雜湊儲存(m=19 MiB、t=2、p=1 以上) 11.4.2 L2 必須 ☑ SEC-AUTH-006 整合企業 IdP 實現 SSO,並驗證斷言(JWT/SAML)的數位簽章 6.8.2 L2 必須 ☑ SEC-AUTH-007 停用或移除預設帳號(admin、root、sa) 6.3.2 L1 必須 ☑ SEC-AUTH-008 密碼重設流程不得繞過已啟用的 MFA 6.4.3 L2 必須 ☐ 4. 授權與存取控制(Authorization) 📝 範本 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 實作狀態 SEC-AUTHZ-001 {授權需求描述} 8.{x}.{x} L{N} 必須/建議 ☐ 📖 使用說明 對應 OWASP ASVS 5.0 V8(Authorization) 遵循最小權限原則(Principle of Least Privilege) 需求涵蓋:功能層級(Function-level)、資料層級(Data-specific,防 IDOR/BOLA)、欄位層級(Field-level)授權 授權規則必須先寫成文件(8.1.1),測試才有判定依據 💡 範例 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 實作狀態 SEC-AUTHZ-001 授權文件定義各角色(Admin/Manager/Employee)可使用的功能與可存取的資料範圍 8.1.1 L1 必須 ☑ SEC-AUTHZ-002 使用者僅能存取自己的薪資/假勤資料(資料層級授權,防 IDOR) 8.2.2 L1 必須 ☑ SEC-AUTHZ-003 每個 API 端點於伺服器端檢查功能權限,拒絕未授權請求回傳 403 8.2.1 L1 必須 ☑ SEC-AUTHZ-004 主管只能讀取部屬薪資的「總額」欄位,不能讀取銀行帳號欄位 8.2.3 L2 必須 ☐ SEC-AUTHZ-005 授權失敗事件需記錄於安全日誌 16.3.2 L2 必須 ☐ 5. 資料保護需求(Data Protection) 📝 範本 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 實作狀態 SEC-DATA-001 {資料保護需求描述} 14.{x}.{x} / 11.{x}.{x} L{N} 必須/建議 ☐ 敏感資料識別 資料欄位 敏感等級 加密方式 遮罩方式 保留期限 {欄位} 高/中/低 {加密} {遮罩} {期限} 📖 使用說明 對應 OWASP ASVS 5.0 V14(Data Protection) 與 V11(Cryptography) 敏感資料需先識別並分級(14.1.1),再為每個等級定義保護要求(14.1.2);完整的資料分級對照表可使用《資料分級對照表範本》 保護措施包含:傳輸加密、靜態加密(經認證的加密模式,例如 AES-GCM)、資料遮罩、存取控制、保留/銷毀策略 💡 範例 敏感資料識別 資料欄位 敏感等級 加密方式 遮罩方式 保留期限 身分證字號 高 AES-256-GCM(靜態,金鑰存放於 KMS) A1234****9 離職後 5 年 銀行帳號 高 AES-256-GCM(靜態,金鑰存放於 KMS) --1234 離職後 5 年 薪資金額 高 資料庫 TDE + 欄位權限控制 不遮罩(權限控制) 依勞動法規 手機號碼 中 無(權限控制) 09xx-xxx-789 離職後 2 年 Email 低 無 無 離職後 2 年 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 SEC-DATA-001 完成敏感資料盤點與分級,並定義各等級保護要求 14.1.1、14.1.2 L2 必須 SEC-DATA-002 加密只使用經核准的演算法與模式(例如 AES-GCM) 11.3.2 L1 必須 SEC-DATA-003 依資料保護等級控制日誌內容,禁止記錄密碼、Token、完整身分證字號 16.2.5 L2 必須 SEC-DATA-004 敏感資料不得出現在 URL 或查詢字串 14.2.1 L1 必須 SEC-DATA-005 含敏感資料的回應設定 Cache-Control: no-store 14.3.2 L2 必須 6. 輸入驗證與輸出編碼 📝 範本 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 實作狀態 SEC-INPUT-001 {輸入驗證需求} 1.{x}.{x} / 2.{x}.{x} / 5.{x}.{x} L{N} 必須/建議 ☐ 📖 使用說明 對應 OWASP ASVS 5.0 V1(Encoding and Sanitization)、V2(Validation and Business Logic)、V5(File Handling) 防禦 OWASP Top 10:2025 的 A05 Injection(SQL Injection、XSS、Command Injection) 原則:永不信任使用者輸入,驗證必須在伺服器端(受信任的服務層)執行 💡 範例 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 SEC-INPUT-001 所有輸入於伺服器端以允許清單(白名單)驗證 2.2.1、2.2.2 L1 必須 SEC-INPUT-002 資料庫查詢使用參數化查詢或 ORM,禁止字串拼接 1.2.4 L1 必須 SEC-INPUT-003 HTML 輸出依上下文編碼(Context-Aware Encoding)防止 XSS 1.2.1 L1 必須 SEC-INPUT-004 檔案上傳檢查副檔名與內容是否相符,並限制檔案大小 5.2.2、5.2.1 L1 必須 SEC-INPUT-005 文件定義每個上傳功能允許的檔案類型與大小上限(含解壓縮後大小) 5.1.1 L2 必須 7. Session 管理 📝 範本 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 實作狀態 SEC-SESS-001 {Session 管理需求} 7.{x}.{x} / 3.3.{x} L{N} 必須/建議 ☐ 📖 使用說明 對應 OWASP ASVS 5.0 V7(Session Management);Cookie 屬性對應 V3.3(Cookie Setup) Session 管理攸關身分劫持風險 需求涵蓋:Token 產生方式、閒置與絕對逾時、登出後失效、Cookie 安全屬性 💡 範例 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 SEC-SESS-001 Session Token 以 CSPRNG 產生且至少 128 bits 熵 7.2.3 L1 必須 SEC-SESS-002 Cookie 設定 Secure 並使用 __Host- 前綴;Session Cookie 設定 HttpOnly;SameSite 依用途設定 3.3.1、3.3.3、3.3.4、3.3.2 L1/L2 必須 SEC-SESS-003 閒置 30 分鐘、絕對 8 小時後需重新認證,並寫入設計文件 7.1.1、7.3.1、7.3.2 L2 必須 SEC-SESS-004 登入(含重新認證)後產生新的 Session Token,並使舊 Token 失效 7.2.4 L1 必須 SEC-SESS-005 使用者可檢視並終止其他裝置的 Session 7.5.2 L2 建議 SEC-SESS-006 帳號停用(如員工離職)時終止其所有 Session 7.4.2 L1 必須 8. 日誌與監控需求 📝 範本 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 實作狀態 SEC-LOG-001 {日誌監控需求} 16.{x}.{x} L{N} 必須/建議 ☐ 稽核事件定義 事件類型 記錄內容 保留期限 {事件} {需記錄的欄位} {期限} 📖 使用說明 對應 OWASP ASVS 5.0 V16(Security Logging and Error Handling) 日誌是事後追查與即時偵測的基礎;對應 OWASP Top 10:2025 A09(安全日誌與告警失效)——只記錄不告警,等於沒有偵測能力 重點:記什麼、不記什麼(禁止記錄密碼/Token)、保存多久、如何防竄改、時間是否含時區 💡 範例 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 SEC-LOG-001 記錄所有認證操作(成功與失敗) 16.3.1 L2 必須 SEC-LOG-002 記錄所有授權失敗事件 16.3.2 L2 必須 SEC-LOG-003 每筆日誌含時間(UTC 或含時區)、來源、使用者、事件 16.2.1、16.2.2 L2 必須 SEC-LOG-004 日誌防止未授權存取與竄改,並傳送至獨立的日誌系統 16.4.2、16.4.3 L2 必須 SEC-LOG-005 日誌元件對寫入資料編碼,防止日誌注入 16.4.1 L2 必須 SEC-LOG-006 同一帳號 10 分鐘內認證失敗 ≥ 20 次觸發告警並通知值班 16.4.3 L2 必須 稽核事件定義 事件類型 記錄內容 保留期限 登入成功 時間、帳號、IP、User-Agent、認證方式(密碼/MFA) 180 天 登入失敗 時間、帳號、IP、失敗原因(不含輸入的密碼) 180 天 權限變更 時間、操作者、變更內容 365 天 個資存取 時間、帳號、存取的個資類型(不含個資內容) 365 天 資料匯出 時間、帳號、匯出範圍、筆數 365 天 9. 通訊安全 📝 範本 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 實作狀態 SEC-COMM-001 {通訊安全需求} 12.{x}.{x} L{N} 必須/建議 ☐ 📖 使用說明 對應 OWASP ASVS 5.0 V12(Secure Communication);HSTS 標頭對應 V3.4 保護傳輸中資料不被竊聽或竄改 涵蓋:TLS 版本、憑證管理、HSTS、內部服務間通訊加密 💡 範例 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 SEC-COMM-001 只啟用 TLS 1.2 與 TLS 1.3,並優先使用 TLS 1.3;停用 SSL 3.0、TLS 1.0/1.1 12.1.1 L1 必須 SEC-COMM-002 啟用 HSTS(max-age ≥ 1 年) 3.4.1 L1 必須 SEC-COMM-003 對外服務使用公開受信任 CA 簽發的憑證 12.2.2 L1 必須 SEC-COMM-004 內部服務間(含資料庫、監控系統)通訊皆使用 TLS 12.3.1、12.3.3 L2 必須 SEC-COMM-005 使用 mTLS 時,先驗證用戶端憑證可信,才以憑證身分做認證或授權 12.1.3 L2 建議 10. 組態安全 📝 範本 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 實作狀態 SEC-CFG-001 {組態安全需求} 13.{x}.{x} / 3.4.{x} / 15.{x}.{x} L{N} 必須/建議 ☐ 📖 使用說明 對應 OWASP ASVS 5.0 V13(Configuration);HTTP 安全標頭對應 V3.4;第三方元件與 SBOM 對應 V15.1/V15.2 安全組態確保系統不因錯誤設定而暴露弱點(OWASP Top 10:2025 A02 Security Misconfiguration) 涵蓋:預設帳號、除錯模式、HTTP 安全標頭、依賴管理、機密管理 💡 範例 需求 ID 需求描述 ASVS 5.0 參照 Level 必須/建議 SEC-CFG-001 正式環境停用所有元件的除錯模式;錯誤只回傳一般性訊息 13.4.2、16.5.1 L2 必須 SEC-CFG-002 服務間認證不得使用預設帳密 13.2.3 L2 必須 SEC-CFG-003 設定 CSP(含 frame-ancestors)與 X-Content-Type-Options: nosniff 3.4.3、3.4.6、3.4.4 L2 必須 SEC-CFG-004 文件定義第三方元件弱點的修補時限,且所有元件皆在時限內 15.1.1、15.2.1 L1 必須 SEC-CFG-005 維護 SBOM(每次建置自動產生) 15.1.2 L2 必須 SEC-CFG-006 後端機密(DB 連線字串、API Key)存放於 Secret Manager/Key Vault 13.3.1 L2 必須 11. 合規性需求 📝 範本 法規/標準 適用條款 系統需求對應 實作狀態 {法規名稱} {條款} {系統需滿足的具體需求} ☐ 📖 使用說明 列出系統需遵循的法規、產業標準、企業政策 每條法規要求需轉化為可驗證的技術需求 常見法規:個人資料保護法、資通安全管理法(2025-12-01 施行修正條文)、GDPR、PCI DSS、ISO/IEC 27001:2022 法規版本與施行日期以全國法規資料庫為準,並由法遵單位確認(例:個人資料保護法 2025-11-11 修正條文的施行日期由行政院另定) 💡 範例 法規/標準 適用條款 系統需求對應 實作狀態 個人資料保護法 第 27 條(非公務機關安全維護措施;2025-11-11 修正條文刪除本條、改由新增條文規範,施行後需更新引用) 個資加密儲存、存取控制、稽核日誌 ☑ 個人資料保護法 第 3 條、第 10 條、第 11 條(當事人權利) 提供個資查詢、更正、停止處理及刪除功能 ☑ ISO/IEC 27001:2022 A.8.3(資訊存取限制) RBAC 與資料層級授權 ☑ ISO/IEC 27001:2022 A.8.24(密碼學之使用) TLS 1.2+、AES-256-GCM 加密 ☑ 公司資安政策 密碼政策 v4.0(依 ASVS 5.0 修訂) 最少 12 字元、比對外洩密碼、不強制定期更換 ☐ 12. 附錄 📝 範本 12.1 安全需求完成度統計 類別 總需求數 已實作 未實作 完成率 認證(AUTH) {N} {N} {N} {%} 授權(AUTHZ) {N} {N} {N} {%} 資料保護(DATA) {N} {N} {N} {%} 輸入驗證(INPUT) {N} {N} {N} {%} Session(SESS) {N} {N} {N} {%} 日誌監控(LOG) {N} {N} {N} {%} 通訊安全(COMM) {N} {N} {N} {%} 組態安全(CFG) {N} {N} {N} {%} 合計 {N} {N} {N} {%} 12.2 OWASP ASVS 5.0 對照表 ASVS 5.0 章節 主題 ASVS 4.0.3 對應章節 本文件對應章節 V1 Encoding and Sanitization V5 第 6 章 V2 Validation and Business Logic V5、V11 第 6 章 V3 Web Frontend Security V14、V3(Cookie) 第 7、9、10 章 V4 API and Web Service V13 第 6 章 V5 File Handling V12 第 6 章 V6 Authentication V2 第 3 章 V7 Session Management V3 第 7 章 V8 Authorization V4 第 4 章 V9 Self-contained Tokens V3.5 第 7 章 V10 OAuth and OIDC (新增) 第 3 章 V11 Cryptography V6 第 3、5 章 V12 Secure Communication V9 第 9 章 V13 Configuration V14 第 10 章 V14 Data Protection V8 第 5 章 V15 Secure Coding and Architecture V1、V10、V14.2 第 10 章 V16 Security Logging and Error Handling V7 第 8 章 V17 WebRTC (新增) 不適用時標示 N/A 📖 使用說明 完成度統計用於追蹤安全需求落實進度 所有「必須」等級的需求需在上線前 100% 實作;無法實作者需提出風險接受單(見《風險接受單範本》) ASVS 對照表協助資安審核人員快速定位驗證範圍,也協助把舊版(4.0.3)文件轉換到 5.0 「ASVS 4.0.3 對應章節」為主題層級的對應,個別需求請以 ASVS 5.0 原文逐條確認 💡 範例 12.1 安全需求完成度統計 類別 總需求數 已實作 未實作 完成率 認證(AUTH) 8 6 2 75% 授權(AUTHZ) 5 3 2 60% 資料保護(DATA) 5 5 0 100% 輸入驗證(INPUT) 5 5 0 100% Session(SESS) 6 5 1 83% 日誌監控(LOG) 6 4 2 67% 通訊安全(COMM) 5 5 0 100% 組態安全(CFG) 6 5 1 83% 合計 46 38 8 83% 13. 審查與驗證 自動檢查 檢查項目 方法 ASVS 編號存在且為 5.0 以 OWASP ASVS GitHub 的 5.0/en 章節檔比對每個 {章}.{節}.{條} 是否存在(gh api repos/OWASP/ASVS/contents/5.0/en) 每條需求都有驗證方式 追溯矩陣「驗證方式」欄不得為空 輸入驗證、注入、日誌敏感資訊 SAST(Semgrep p/owasp-top-ten)、Secrets 掃描(gitleaks) TLS、HSTS、安全標頭 testssl.sh、ZAP baseline 掃描 授權需求 每條授權需求至少一個「權限不足」與「存取他人資料」的整合測試 人工審查問題 ASVS 等級是否依專案風險等級選用?有沒有因為「做不完」而降級? 每條需求的 ASVS 參照,內容真的與需求描述一致嗎?(抽查 5 條對照原文) 密碼政策是否仍要求組成規則或定期更換(違反 ASVS 5.0 6.2.5、6.2.10)? 威脅模型中的每個高風險威脅,都能在本清單找到對應的需求嗎? 法規條款引用的是現行條文嗎?施行日期是否確認? AI 常見錯誤 沿用 ASVS 4.0.3 的章節與編號(例如把身分驗證寫成 V2.x),或捏造不存在的需求編號。 產生「90 天強制更換密碼」「必須包含大小寫與特殊字元」等已不符 ASVS 5.0 的密碼政策。 只列出需求,沒有寫驗證方式,導致測試階段無從驗證。 引用 OWASP Top 10:2021 的分類名稱(例如把注入寫成 A03)。 📌 範本使用注意事項 ...

May 18, 2026 · 8 min · 1519 words · Eric Cheng

標準作業程序範本(SOP Template)

標準作業程序範本(Standard Operating Procedure, SOP) 參照標準:ISO 9001:2015(Quality Management)/ ISO/IEC 20000-1:2018 / ITIL 4 文件用途:標準化維運操作流程,確保操作一致性、降低人為錯誤、加速新人上手 適用階段:維運監控階段(Operations Phase)— Operational Excellence 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 10.1、11.2 節 📋 章節目錄 文件資訊 目的與範圍 角色與職責 前置條件 操作步驟 驗證與確認 異常處理 安全注意事項 相關文件 變更歷史 審查與驗證 1. 文件資訊 📝 範本 項目 內容 文件編號 SOP-{類別代碼}-{序號} 文件名稱 {操作名稱} 標準作業程序 版本 v{主版本}.{次版本} 狀態 草稿 / 審核中 / 核定 / 作廢 建立日期 {YYYY-MM-DD} 生效日期 {YYYY-MM-DD} 下次審核日期 {YYYY-MM-DD}(至少每年) 撰寫者 {姓名/角色} 審核者 {姓名/角色} 核准者 {姓名/角色} 適用系統 {系統/服務名稱} 機密等級 一般 / 限閱 / 機密 📖 使用說明 SOP 編號慣例:SOP-{類別}-{流水號} 類別代碼範例:DEP(部署)、INC(事件處理)、BAK(備份)、MON(監控) 每份 SOP 需定期審核(ISO 9001 要求),避免過時 狀態管理:草稿 → 審核中 → 核定(可執行)→ 作廢(新版取代) 機密等級決定誰可以存取此 SOP 💡 範例 項目 內容 文件編號 SOP-BAK-001 文件名稱 HRMS 資料庫每日備份標準作業程序 版本 v2.0 生效日期 2026-05-01 下次審核日期 2027-05-01 適用系統 HRMS PostgreSQL 16 (Azure Database) 2. 目的與範圍 📝 範本 2.1 目的 {說明此 SOP 為何存在、解決什麼問題} ...

May 18, 2026 · 5 min · 977 words · Eric Cheng

測試報告範本(Test Report Template)

測試報告範本(Test Report) 參照標準:ISO/IEC/IEEE 29119-3:2021(Test Completion Report) 文件用途:彙整測試執行結果,評估軟體品質,提供上線/不上線的決策依據 適用階段:測試驗證階段(Testing Phase)— Test Completion 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 6.4、6.5 節 📋 章節目錄 文件資訊 執行摘要 測試範圍 測試環境 測試執行結果 缺陷分析 覆蓋率分析 風險與未解決項目 品質評估與建議 附錄 審查與驗證 1. 文件資訊 📝 範本 項目 內容 文件編號 TR-{專案代碼}-{迭代/版本}-{序號} 文件名稱 {系統名稱} 測試報告 版本 v{主版本}.{次版本} 測試版本 {受測軟體版本號} 測試類型 單元/整合/系統/UAT/回歸/效能/安全 測試週期 {YYYY-MM-DD} ~ {YYYY-MM-DD} 撰寫者 {QA 負責人} 審核者 {PM/Tech Lead} 發佈日期 {YYYY-MM-DD} 📖 使用說明 每個重要測試里程碑(Sprint 結束、版本發佈前)產出測試報告 測試類型依實際執行的測試活動填寫,可為複合型(如「系統 + 效能」) 測試版本需明確對應 Git Tag / Build Number,確保可追溯 💡 範例 項目 內容 文件編號 TR-HRM-v2.1-001 系統名稱 人力資源管理系統 測試版本 v2.1.0-rc.1 (Build #487) 測試類型 系統測試 + 回歸測試 + 效能測試 測試週期 2026-05-01 ~ 2026-05-15 2. 執行摘要 📝 範本 2.1 整體結論 項目 結果 上線建議 ✅ 建議上線 / ⚠️ 有條件上線 / ❌ 不建議上線 品質等級 優良 / 合格 / 不合格 主要風險 {簡述主要殘餘風險} 2.2 關鍵指標概覽 指標 數值 目標 達標 測試案例通過率 {%} ≥ {%} ✅/❌ 缺陷密度(Defect/KLOC) {N} ≤ {N} ✅/❌ 嚴重缺陷(Critical/High)未解決 {N} 0 ✅/❌ 需求覆蓋率 {%} ≥ {%} ✅/❌ 程式碼覆蓋率 {%} ≥ {%} ✅/❌ 效能指標達標率 {%} 100% ✅/❌ 📖 使用說明 執行摘要是最重要的章節,決策者可能只看這部分 上線建議需有客觀數據支持,非主觀判斷 「有條件上線」需明確列出條件(如:特定功能暫不開放、需加監控) 關鍵指標的目標值應在測試計畫中事先定義 💡 範例 2.1 整體結論 項目 結果 上線建議 ⚠️ 有條件上線 品質等級 合格 主要風險 2 個 Medium 缺陷待修、大量匯出效能未達標 2.2 關鍵指標概覽 指標 數值 目標 達標 測試案例通過率 96.8% ≥ 95% ✅ 缺陷密度 2.3/KLOC ≤ 5/KLOC ✅ 嚴重缺陷未解決 0 0 ✅ 需求覆蓋率 98% ≥ 95% ✅ 程式碼覆蓋率 82% ≥ 80% ✅ 效能指標達標率 90% 100% ❌ 3. 測試範圍 📝 範本 3.1 測試項目(In Scope) 模組/功能 測試類型 優先級 執行狀態 {模組名稱} {測試類型} 高/中/低 完成/部分/未執行 3.2 排除項目(Out of Scope) 模組/功能 排除原因 {模組名稱} {原因} 📖 使用說明 明確列出本次測試涵蓋與不涵蓋的範圍 排除原因需合理(如:未修改的模組、下一版本範圍) 執行狀態若為「部分」或「未執行」,需在風險章節說明影響 💡 範例 3.1 測試項目 模組/功能 測試類型 優先級 執行狀態 員工資料管理(CRUD) 系統測試 + 回歸 高 完成 薪資計算引擎 系統測試 + 回歸 高 完成 請假/加班申請流程 系統測試 + 回歸 高 完成 報表匯出(PDF/Excel) 系統測試 + 效能 中 完成 SSO 登入整合 整合測試 高 完成 API 效能(並發) 效能測試 中 完成 3.2 排除項目 模組/功能 排除原因 行動 App v2.2 規劃範圍,本版未開發 第三方薪轉介接(銀行 API) 銀行端 UAT 環境未就緒 4. 測試環境 📝 範本 項目 規格 環境名稱 {SIT/UAT/Staging/Performance} 作業系統 {OS 版本} 應用伺服器 {Server + 版本} 資料庫 {DB + 版本} 測試資料 {描述:模擬資料量/來源} 測試工具 {工具清單} 與正式環境差異 {列出差異} 📖 使用說明 測試環境資訊確保結果可重現 必須列出與正式環境的差異(差異可能影響結果有效性) 效能測試環境應盡量接近正式規格 💡 範例 項目 規格 環境名稱 Staging (Azure AKS) 作業系統 Ubuntu 22.04 (K8s Node) 應用伺服器 .NET 8 Kestrel + Kong 3.5 資料庫 PostgreSQL 16.2 (Azure Database) 測試資料 模擬 10,000 員工、3 年歷史資料 測試工具 xUnit, Playwright, JMeter 5.6, SonarQube 與正式環境差異 節點數 3(正式 6)、資料量為正式 20% 5. 測試執行結果 📝 範本 5.1 測試案例執行統計 狀態 數量 百分比 通過(Pass) {N} {%} 失敗(Fail) {N} {%} 阻塞(Blocked) {N} {%} 未執行(Not Run) {N} {%} 總計 {N} 100% 5.2 按模組分佈 模組 總案例 通過 失敗 阻塞 通過率 {模組} {N} {N} {N} {N} {%} 5.3 效能測試結果(如適用) 場景 指標 目標 實際 達標 {場景} {指標} {目標值} {實際值} ✅/❌ 📖 使用說明 統計數據需與測試管理工具(如 Azure DevOps Test Plan)數據一致 失敗案例需逐一追蹤到缺陷 ID 阻塞案例需說明阻塞原因(環境問題?依賴未就緒?) 效能測試報告重點指標:回應時間、吞吐量、錯誤率 💡 範例 5.1 測試案例執行統計 狀態 數量 百分比 通過(Pass) 242 96.8% 失敗(Fail) 5 2.0% 阻塞(Blocked) 2 0.8% 未執行(Not Run) 1 0.4% 總計 250 100% 5.2 按模組分佈 模組 總案例 通過 失敗 阻塞 通過率 員工資料管理 65 64 1 0 98.5% 薪資計算 80 78 2 0 97.5% 請假/加班 55 54 0 1 98.2% 報表匯出 30 28 2 0 93.3% SSO 登入 20 18 0 1 90.0%* 5.3 效能測試結果 場景 指標 目標 實際 達標 登入(100 concurrent) P95 回應時間 ≤ 500ms 320ms ✅ 員工查詢(200 concurrent) P95 回應時間 ≤ 1000ms 780ms ✅ 薪資計算批次(10,000筆) 總處理時間 ≤ 5min 3.2min ✅ 報表匯出(5,000筆 Excel) 回應時間 ≤ 30s 45s ❌ API 持續壓力(1hr, 500 TPS) 錯誤率 ≤ 0.1% 0.05% ✅ 6. 缺陷分析 📝 範本 6.1 缺陷統計 嚴重度 發現 已修復 未修復 已驗證 Critical {N} {N} {N} {N} High {N} {N} {N} {N} Medium {N} {N} {N} {N} Low {N} {N} {N} {N} 總計 {N} {N} {N} {N} 6.2 缺陷明細(未解決) 缺陷 ID 嚴重度 模組 描述 狀態 處置方式 {ID} {等級} {模組} {描述} {狀態} 下版修復/暫時方案/接受 6.3 缺陷趨勢 累計發現 vs 累計解決 趨勢圖(收斂曲線) 📖 使用說明 Critical/High 未解決 = 不建議上線(除非有合理的暫時方案) 缺陷趨勢圖需呈現「收斂」趨勢(發現率下降、解決追上發現) 缺陷明細只列未解決的,已解決的在附錄提供完整清單 處置方式需經 PM/Tech Lead 核准 💡 範例 6.1 缺陷統計 嚴重度 發現 已修復 未修復 已驗證 Critical 1 1 0 1 High 3 3 0 3 Medium 8 6 2 6 Low 5 3 2 3 總計 17 13 4 13 6.2 缺陷明細(未解決) 缺陷 ID 嚴重度 模組 描述 狀態 處置方式 BUG-142 Medium 報表匯出 Excel 匯出超過 5000 筆時超時 (45s > 30s) Open v2.2 修復(分頁匯出) BUG-145 Medium 報表匯出 PDF 頁首日期格式錯誤 Open v2.1.1 Hotfix BUG-148 Low 員工管理 姓名超過 50 字元時 UI 顯示截斷 Open v2.2 修復 BUG-150 Low 薪資計算 計算說明欄位未支援多語系 Open v2.2 修復 7. 覆蓋率分析 📝 範本 7.1 需求覆蓋率 需求類型 總需求數 已覆蓋 未覆蓋 覆蓋率 功能需求(FR) {N} {N} {N} {%} 非功能需求(NFR) {N} {N} {N} {%} 安全需求(SEC) {N} {N} {N} {%} 7.2 程式碼覆蓋率 模組 行覆蓋率 分支覆蓋率 方法覆蓋率 {模組} {%} {%} {%} 📖 使用說明 需求覆蓋率:確保每個需求至少有一個測試案例覆蓋 程式碼覆蓋率:通常由 CI/CD 工具(SonarQube、Istanbul)自動產出 目標值:需求覆蓋率 ≥ 95%、行覆蓋率 ≥ 80%、分支覆蓋率 ≥ 70% 未覆蓋的需求需說明原因 💡 範例 7.1 需求覆蓋率 需求類型 總需求數 已覆蓋 未覆蓋 覆蓋率 功能需求(FR) 45 44 1* 97.8% 非功能需求(NFR) 12 12 0 100% 安全需求(SEC) 40 38 2** 95% *FR-032(行動 App 推播)排除於本版 ...

May 18, 2026 · 6 min · 1156 words · Eric Cheng

測試案例範本(Test Case Template)

測試案例範本(Test Case Template) 參照標準:ISO/IEC/IEEE 29119-3:2021(取代 IEEE 829-2008)/ ISO/IEC/IEEE 29119-4:2021(Test Techniques) 文件用途:定義測試案例的標準格式,確保測試設計完整、可追溯、可重複執行 適用階段:測試設計與執行階段 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 6.1、3.7 節 📋 章節目錄 文件資訊 測試案例識別規範 測試案例格式定義 測試案例撰寫規範 測試案例分類 測試案例清單範本 測試案例詳細格式 測試資料規劃 測試執行紀錄 缺陷報告格式 附錄 審查與驗證 1. 文件資訊 📝 範本 項目 內容 文件編號 TC-{專案代碼}-{模組}-{序號} 文件名稱 {系統名稱} {模組名稱} 測試案例 版本 v{主版本}.{次版本} 對應測試計畫 {TP 文件編號} 對應需求 {FRD 文件編號} 撰寫者 {姓名} 審核者 {姓名} 建立日期 {YYYY-MM-DD} 📖 使用說明 測試案例文件承接測試計畫(Test Plan),為各測試項目設計具體的驗證步驟 每個功能模組可獨立一份測試案例文件,或匯整於單一文件中 文件需經 QA Lead 或測試經理審核後方可執行 💡 範例 項目 內容 文件編號 TC-HRM-LV-001 文件名稱 HRMS 假勤管理模組 測試案例 對應測試計畫 TP-HRM-001 對應需求 FRD-HRM-001 v2.1 2. 測試案例識別規範 📝 範本 2.1 編號規則 TC-{專案}-{模組}-{序號} 欄位 說明 範例 TC 固定前綴(Test Case) TC {專案} 專案代碼(2-5 字元) HRM {模組} 模組縮寫(2-5 字元) LV(Leave) {序號} 三位數流水號 001 2.2 命名規範 測試案例名稱格式:[測試類型] {功能描述} - {情境描述} ...

May 18, 2026 · 6 min · 1187 words · Eric Cheng

測試計畫範本(Test Plan Template)

測試計畫範本(Test Plan) 參照標準:ISO/IEC/IEEE 29119-3:2021(取代 IEEE 829-2008) 文件用途:定義測試範圍、策略、資源、時程與風險,指導整體測試活動 適用階段:測試準備階段(Test Planning Phase) 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 6.1、6.2、6.5 節 📋 章節目錄 文件資訊 測試計畫識別 引言 測試項目 測試策略與方法 通過與失敗標準 暫停與恢復準則 測試交付物 測試環境需求 職責分工 時程與里程碑 風險與緩解措施 附錄 審查與驗證 1. 文件資訊 📝 範本 項目 內容 文件編號 TP-{專案代碼}-{序號} 文件名稱 {系統名稱} 測試計畫 版本 v{主版本}.{次版本} 狀態 草稿 / 審核中 / 核定 建立日期 {YYYY-MM-DD} 最後更新 {YYYY-MM-DD} 撰寫者 {姓名/角色} 審核者 {姓名/角色} 對應 FRD {FRD 文件編號} 測試層級 {Unit / Integration / System / UAT} 版本歷程 ...

May 18, 2026 · 7 min · 1284 words · Eric Cheng

版本發行說明範本(Release Notes Template)

版本發行說明範本(Release Notes) 參照標準:Keep a Changelog 1.1.0 / SemVer 2.0.0 / ISO/IEC/IEEE 12207:2026(Release Management) 文件用途:正式記錄每個版本的變更內容,供開發、維運、使用者了解版本差異 適用階段:部署上線階段(Deployment Phase)— Release Management 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 7.2、8.1 節 📋 章節目錄 文件資訊 版本摘要 新增功能(Added) 變更項目(Changed) 修復項目(Fixed) 棄用項目(Deprecated) 移除項目(Removed) 安全性修復(Security) 已知問題(Known Issues) 升級指南 相容性說明 審查與驗證 1. 文件資訊 📝 範本 項目 內容 產品名稱 {系統名稱} 版本號 v{MAJOR}.{MINOR}.{PATCH} 發佈日期 {YYYY-MM-DD} 版本類型 Major / Minor / Patch / Hotfix 發佈人 {Release Manager 姓名} Git Tag {tag name} Build Number #{build} 對應里程碑 {Sprint/Milestone 名稱} 📖 使用說明 版本號遵循 SemVer 2.0.0: MAJOR:不相容的 API 變更 MINOR:向後相容的新功能 PATCH:向後相容的 Bug 修復 每次正式發佈(含 Hotfix)都需要 Release Notes Git Tag 與 Build Number 確保可從 Release Notes 追溯到原始碼 💡 範例 項目 內容 產品名稱 人力資源管理系統(HRMS) 版本號 v2.1.0 發佈日期 2026-05-20 版本類型 Minor 發佈人 林 DevOps Git Tag v2.1.0 Build Number #489 對應里程碑 Sprint 12 2. 版本摘要 📝 範本 概述 {用 2-3 句話描述本版本的核心主題與重要變更} ...

May 18, 2026 · 5 min · 868 words · Eric Cheng

系統需求規格書範本(System Requirements Document Template)

系統需求規格書範本(System Requirements Document, SRD) 參照標準:ISO/IEC/IEEE 29148:2018(Systems and Software Engineering — Requirements Engineering) 文件用途:定義系統層級的完整需求(功能、效能、安全、介面),作為設計與驗證的基準 適用階段:需求分析階段(Requirements Phase)— System-Level Requirements 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 3.2、3.3、5.4 節 📋 章節目錄 文件資訊 系統概述 系統功能需求 系統介面需求 效能需求 安全需求摘要 可靠性與可用性 限制條件 需求追溯矩陣 附錄 審查與驗證 1. 文件資訊 📝 範本 項目 內容 文件編號 SRD-{專案代碼}-{版本} 文件名稱 {系統名稱} 系統需求規格書 版本 v{主版本}.{次版本} 狀態 草稿 / 審核中 / 基線化 建立日期 {YYYY-MM-DD} 撰寫者 {系統分析師} 審核者 {Tech Lead / 架構師} 核准者 {PM / 產品負責人} 基線版本 {基線化日期,變更需走 CR 流程} 📖 使用說明 SRD 位於需求文件階層的中間層: BRD(商業需求)→ SRD(系統需求) → FRD(功能需求) SRD 將商業需求轉化為系統可實作的技術需求 「基線化」後的變更需經正式變更控制流程(Change Request) 依 ISO/IEC/IEEE 29148:2018 Section 6.2(System Requirements Specification) 💡 範例 項目 內容 文件編號 SRD-HRM-v1.0 系統名稱 人力資源管理系統(HRMS) 版本 v1.0 基線版本 2026-04-01(Sprint 10 結束) 2. 系統概述 📝 範本 2.1 系統目的 {描述系統存在的理由與欲解決的核心問題} ...

May 18, 2026 · 5 min · 1033 words · Eric Cheng

變更日誌範本(CHANGELOG Template)

變更日誌範本(CHANGELOG Template) 參照標準:Keep a Changelog 1.1.0 / Semantic Versioning 2.0.0 文件用途:記錄專案每個版本的顯著變更,讓使用者與開發者了解版本間的差異 適用階段:專案全生命週期(每次發版皆需更新) 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 7.1、7.2 節 📋 章節目錄 文件資訊 格式規範 變更類別定義 版本編號規則 撰寫規範 CHANGELOG 完整範本 自動化產生 附錄 審查與驗證 1. 文件資訊 📝 範本 項目 內容 文件名稱 CHANGELOG.md 位置 專案根目錄 格式 Markdown(Keep a Changelog 格式) 維護者 {Release Manager / 開發團隊} 更新時機 每次版本發布(Release) 📖 使用說明 CHANGELOG.md 置於專案根目錄,與 README.md 並列 每次 Release 前更新,不是每個 Commit 都記錄 記錄「對使用者有意義的變更」,非所有技術細節 💡 範例 CHANGELOG.md 通常長這樣的開頭: # Changelog All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). 2. 格式規範 📝 範本 # Changelog All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [Unreleased] ### Added - {新功能描述} ## [{版本號}] - {YYYY-MM-DD} ### Added - {新增功能} ### Changed - {變更項目} ### Deprecated - {即將移除的功能} ### Removed - {已移除的功能} ### Fixed - {修復的問題} ### Security - {安全性修復} [Unreleased]: {repo-url}/compare/v{版本}...HEAD [{版本號}]: {repo-url}/compare/v{前版本}...v{版本} 📖 使用說明 [Unreleased] 區塊永遠在最上方,收集尚未發布的變更 發版時將 [Unreleased] 內容移至新版本區塊 版本由新到舊排列(最新在最上面) 底部的連結區塊提供版本間的 diff 比較連結 💡 範例 見第 6 節完整範本。 ...

May 18, 2026 · 5 min · 1024 words · Eric Cheng