安全設計文件範本（Security Design Document Template）

適用標準：OWASP SAMM 2.0、ISO/IEC 27034（應用安全）、NIST SP 800-53、ISO/IEC 27001:2022
適用階段：系統設計階段（Design Phase）
負責角色：資安架構師、系統架構師（SA）、AppSec 工程師

📑 章節目錄

1. 文件資訊
2. 安全設計目標
3. 身分驗證設計（Authentication）
4. 授權與存取控制（Authorization）
5. 資料保護設計
6. API 安全設計
7. Session 管理
8. 輸入驗證與輸出編碼
9. 日誌與稽核設計
10. 安全組態基線
11. 安全測試策略

📝 範本

1. 文件資訊

關聯文件

2. 安全設計目標

2.1 安全原則

2.2 合規需求

3. 身分驗證設計（Authentication）

3.1 驗證機制

3.2 密碼儲存

3.3 Token 設計

3.4 驗證流程圖

sequenceDiagram
    participant U as User
    participant C as Client App
    participant IDP as Identity Provider
    participant API as API Server

    U->>C: 點擊登入
    C->>IDP: Authorization Request (PKCE)
    IDP->>U: 顯示登入頁面
    U->>IDP: 輸入帳號/密碼 + MFA
    IDP->>C: Authorization Code
    C->>IDP: Token Exchange (code + code_verifier)
    IDP->>C: Access Token + Refresh Token + ID Token
    C->>API: API Request + Access Token (Bearer)
    API->>API: Validate Token (signature + claims)
    API->>C: Response

4. 授權與存取控制（Authorization）

4.1 存取控制模型

4.2 角色定義

4.3 權限矩陣

4.4 資料級權限

5. 資料保護設計

5.1 加密策略

5.2 金鑰管理

5.3 個資處理

6. API 安全設計

6.1 API 認證授權

6.2 API 防護

6.3 OWASP API Security Top 10 對策

7. Session 管理

8. 輸入驗證與輸出編碼

8.1 輸入驗證策略

8.2 常見攻擊防護

8.3 Content Security Policy

Content-Security-Policy: 
  default-src 'self';
  script-src 'self' [trusted CDN];
  style-src 'self' 'unsafe-inline';
  img-src 'self' data: [image CDN];
  connect-src 'self' [API domain];
  frame-ancestors 'none';
  base-uri 'self';
  form-action 'self';

9. 日誌與稽核設計

9.1 安全事件日誌

9.2 日誌安全

10. 安全組態基線

10.1 HTTP Security Headers

10.2 TLS 組態

11. 安全測試策略

📖 使用說明

各章節填寫指引

💡 範例（以 HRMS 人力資源管理系統為例）

範例：角色與權限矩陣

範例：API 安全設計

範例：稽核日誌設計

{
  "timestamp": "2026-04-10T08:30:15.123Z",
  "event_type": "DATA_ACCESS",
  "user_id": "EMP-001",
  "user_role": "HR",
  "action": "VIEW",
  "resource": "employee.salary",
  "resource_id": "EMP-042",
  "source_ip": "10.0.10.45",
  "user_agent": "Mozilla/5.0...",
  "result": "SUCCESS",
  "metadata": {
    "fields_accessed": ["base_salary", "bonus"],
    "reason": "Monthly payroll processing"
  }
}

📌 審閱重點

• 威脅模型中的每個威脅是否都有對應安全控制？
• 認證授權設計是否遵循 Zero Trust 原則？
• 所有 PII 欄位是否都有明確的保護措施？
• 安全測試是否已整合至 CI/CD Pipeline？
• HTTP Security Headers 是否完整設定？