使用 Bash 建構自動化滲透測試報告生成系統

#!/bin/bash

# 定義資料庫檔案路徑
# 請根據實際環境修改此變數
DB_NAME="pentest_results.db"

# 資料庫查詢函式
# 參數：
#   $1 - SQL 查詢語句
# 回傳：
#   CSV 格式的查詢結果，包含欄位標題
query_db() {
  # 使用 sqlite3 命令列工具執行查詢
  # -header 參數：在輸出結果中包含欄位名稱
  # -csv 參數：以 CSV 格式輸出結果，便於後續處理
  # "$DB_NAME" 參數：指定資料庫檔案路徑
  # "$1" 參數：傳入的 SQL 查詢語句
  sqlite3 -header -csv "$DB_NAME" "$1"
}

# LaTeX 特殊字元轉義函式
# LaTeX 將以下字元視為控制符號，必須加上反斜線進行轉義
# 參數：
#   $1 - 需要轉義的原始字串
# 回傳：
#   轉義後的安全字串
escape_latex() {
  # 使用 sed 串流編輯器進行多重替換
  # s/PATTERN/REPLACEMENT/g 表示全域替換
  # & 字元：在 LaTeX 中用於表格欄位分隔，必須轉義為 \&
  # % 字元：在 LaTeX 中表示註解開始，必須轉義為 \%
  # $ 字元：在 LaTeX 中用於數學模式切換，必須轉義為 \$
  # # 字元：在 LaTeX 中用於參數引用，必須轉義為 \#
  # _ 字元：在 LaTeX 中用於下標符號，必須轉義為 \_
  # { 和 } 字元：在 LaTeX 中用於群組界定，必須轉義為 \{ 和 \}
  sed 's/&/\\&/g; s/%/\\%/g; s/$/\\$/g; s/#/\\#/g; s/_/\\_/g; s/{/\\{/g; s/}/\\}/g' <<< "$1"
}

# LaTeX 文件內容生成函式
# 此函式不接受參數，直接輸出完整的 LaTeX 原始碼至標準輸出
# 產生的文件包含標題、摘要與測試結果表格
create_latex_content() {
  # 文件類別宣告：使用標準的 article 類別
  echo "\\documentclass{article}"
  
  # 載入必要的套件
  # geometry 套件：設定頁面邊距為 1 英吋
  echo "\\usepackage[margin=1in]{geometry}"
  
  # longtable 套件：支援跨頁的長表格
  # 這對於包含大量測試結果的報告至關重要
  echo "\\usepackage{longtable}"
  
  # pdflscape 套件：支援橫向頁面配置
  # 測試結果表格通常欄位較多，橫向配置能提供更好的閱讀體驗
  echo "\\usepackage{pdflscape}"
  
  # 文件主體開始
  echo "\\begin{document}"
  
  # 設定文件標題
  # 在實際應用中，標題應根據測試專案動態產生
  echo "\\title{滲透測試評估報告}"
  
  # 設定作者資訊
  # 可以從環境變數或設定檔讀取，增加靈活性
  echo "\\author{資安評估團隊}"
  
  # 產生標題頁
  echo "\\maketitle"
  
  # 第一章節：執行摘要
  echo "\\section{執行摘要}"
  
  # 摘要內容
  # 這部分應該總結整體的測試發現與風險評估
  # 實際應用中可以根據資料庫中的統計資料動態產生
  echo "本次滲透測試評估針對目標網路環境進行全面性的安全檢測。測試過程中發現多個不同嚴重等級的安全漏洞，包含過時的軟體版本、不當的服務設定，以及潛在的存取控制弱點。詳細的測試結果與建議措施請參閱後續章節的完整分析。"
  
  # 第二章節：掃描結果
  echo "\\section{掃描結果}"
  
  # 查詢資料庫取得所有不重複的 IP 位址
  # DISTINCT 關鍵字確保每個 IP 只出現一次
  # 結果以換行符號分隔，便於迴圈處理
  ip_addresses=$(query_db "SELECT DISTINCT ip_address FROM nmap_scans;")
  
  # 設定內部欄位分隔符號為換行符號
  # 這確保 for 迴圈能正確處理包含空格的資料
  IFS=$'\n'
  
  # 針對每個 IP 位址產生獨立的小節
  for ip in $ip_addresses; do
    # 產生小節標題，顯示當前處理的 IP 位址
    echo "\\subsection{主機位址: $ip}"
    
    # 開始橫向頁面環境
    # 表格內容將以橫向方式呈現，提供更多的水平空間
    echo "\\begin{landscape}"
    
    # 開始長表格環境
    # 表格定義了 7 個欄位，每個欄位的寬度使用 p{寬度} 語法指定
    # | 符號表示欄位間的垂直分隔線
    echo "\\begin{longtable}{|p{2cm}|p{2cm}|p{1.5cm}|p{1.5cm}|p{3cm}|p{3cm}|p{4cm}|}"
    
    # 表格頂部水平線
    echo "\\hline"
    
    # 表格標題列
    # \\\\ 表示換行，\\hline 產生水平分隔線
    echo "主機名稱 & IP 位址 & 連接埠 & 通訊協定 & 服務名稱 & 版本資訊 & 漏洞描述 \\\\ \\hline"
    
    # 定義首頁表頭
    # 當表格跨頁時，此標題會出現在第一頁
    echo "\\endfirsthead"
    
    # 定義續頁表頭
    # 表格延續到下一頁時，會自動加上此標題
    echo "\\hline"
    echo "主機名稱 & IP 位址 & 連接埠 & 通訊協定 & 服務名稱 & 版本資訊 & 漏洞描述 \\\\ \\hline"
    echo "\\endhead"
    
    # 查詢當前 IP 的所有掃描結果
    # 使用 WHERE 子句篩選特定 IP 的記錄
    # sed 指令將 CSV 格式轉換為 LaTeX 表格格式
    # s/,/ & /g 將逗號替換為 LaTeX 的欄位分隔符號 &
    # s/$/ \\\\ \\hline/ 在每行結尾加上換行符號與水平線
    query_db "SELECT hostname, ip_address, port, protocol, service, version, vulnerability FROM nmap_scans WHERE ip_address='$ip';" | sed 's/,/ \\& /g; s/$/ \\\\\\\\ \\hline/'
    
    # 結束長表格環境
    echo "\\end{longtable}"
    
    # 結束橫向頁面環境
    echo "\\end{landscape}"
  done
  
  # 文件主體結束
  echo "\\end{document}"
}

#!/bin/bash

# 設定嚴格的錯誤處理模式
# -e 參數：任何指令執行失敗時立即終止腳本
# -u 參數：使用未定義變數時視為錯誤
# -o pipefail 參數：管線中任一指令失敗時，整個管線視為失敗
set -euo pipefail

# 定義輸出檔案名稱
# 實際應用中可以加入時間戳記，避免檔案覆蓋
OUTPUT_FILE="pentest_report"
LATEX_FILE="${OUTPUT_FILE}.tex"
PDF_FILE="${OUTPUT_FILE}.pdf"

# 主要執行流程函式
main() {
  # 顯示處理進度訊息
  echo "[資訊] 開始生成滲透測試報告..."
  
  # 檢查資料庫檔案是否存在
  if [[ ! -f "$DB_NAME" ]]; then
    echo "[錯誤] 找不到資料庫檔案: $DB_NAME" >&2
    exit 1
  fi
  
  # 生成 LaTeX 原始檔
  echo "[資訊] 正在生成 LaTeX 文件..."
  create_latex_content > "$LATEX_FILE"
  
  # 檢查 LaTeX 檔案是否成功產生
  if [[ ! -f "$LATEX_FILE" ]]; then
    echo "[錯誤] LaTeX 檔案產生失敗" >&2
    exit 1
  fi
  
  # 編譯 LaTeX 文件為 PDF
  echo "[資訊] 正在編譯 PDF 文件..."
  # -interaction=nonstopmode 參數：遇到錯誤時不停止，繼續編譯
  # -output-directory 參數：指定輸出目錄
  pdflatex -interaction=nonstopmode -output-directory=. "$LATEX_FILE" > /dev/null 2>&1
  
  # 第二次編譯以確保交叉引用正確
  # LaTeX 需要多次編譯來處理目錄、引用等動態內容
  pdflatex -interaction=nonstopmode -output-directory=. "$LATEX_FILE" > /dev/null 2>&1
  
  # 檢查 PDF 檔案是否成功產生
  if [[ -f "$PDF_FILE" ]]; then
    echo "[成功] 報告已成功產生: $PDF_FILE"
    
    # 清理暫存檔案
    # LaTeX 編譯過程會產生多個輔助檔案
    rm -f "${OUTPUT_FILE}.aux" "${OUTPUT_FILE}.log" "${OUTPUT_FILE}.out"
    
    # 詢問是否保留 LaTeX 原始檔
    read -p "是否保留 LaTeX 原始檔? (y/n): " -n 1 -r
    echo
    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
      rm -f "$LATEX_FILE"
      echo "[資訊] 已清理 LaTeX 原始檔"
    fi
  else
    echo "[錯誤] PDF 檔案產生失敗，請檢查 LaTeX 編譯日誌" >&2
    exit 1
  fi
}

# 執行主函式
main

#!/bin/bash

# 程序列舉指令碼
# 用於識別系統中可能的 AV/EDR 程序

# 列出所有程序的詳細資訊
# a 參數：顯示所有使用者的程序
# u 參數：顯示程序的擁有者資訊
# x 參數：包含沒有控制終端機的程序
echo "[資訊] 列舉所有執行中的程序..."
sudo ps aux

echo ""
echo "[資訊] 篩選可能的安全防護程序..."

# 使用 grep 配合正規表示式篩選可能的安全程序
# -E 參數：啟用延伸正規表示式
# -i 參數：忽略大小寫
# 搜尋關鍵字包含：av, edr, protect, defend, guard, security
sudo ps aux | grep -iE "(av|edr|protect|defend|guard|security|antivirus|endpoint)" | grep -v grep

# 備註：此方法可能產生誤判
# 許多合法程序的名稱也可能包含這些關鍵字
# 需要人工判讀結果以確認真正的安全軟體

# 進階篩選：查詢已知的安全產品程序名稱
echo ""
echo "[資訊] 檢查已知的安全產品..."

# 定義常見安全產品的程序名稱陣列
KNOWN_SECURITY_PROCESSES=(
  "clamav"
  "sophos"
  "crowdstrike"
  "carbonblack"
  "cylance"
  "sentinel"
  "defender"
  "mcafee"
  "symantec"
  "trendmicro"
)

# 迴圈檢查每個已知的安全產品
for process in "${KNOWN_SECURITY_PROCESSES[@]}"; do
  # 使用 pgrep 指令搜尋特定名稱的程序
  # -i 參數：忽略大小寫
  # -l 參數：顯示程序名稱
  if pgrep -il "$process" > /dev/null 2>&1; then
    echo "[發現] 偵測到 $process 相關程序"
    pgrep -il "$process"
  fi
done

#!/bin/bash

# 檔案系統分析指令碼
# 用於識別安全軟體的安裝檔案與設定檔

echo "[資訊] 檢查常見的安全軟體安裝目錄..."

# 檢查 /opt 目錄
# 許多第三方軟體會安裝在此目錄下
if [[ -d /opt ]]; then
  echo "[資訊] 分析 /opt 目錄內容..."
  ls -la /opt | grep -iE "(av|antivirus|edr|protect|security|defend)"
fi

# 檢查 /etc 目錄
# 安全軟體的設定檔通常存放於此
if [[ -d /etc ]]; then
  echo "[資訊] 分析 /etc 目錄內容..."
  ls -la /etc | grep -iE "(av|antivirus|edr|protect|security|defend)"
fi

echo ""
echo "[資訊] 搜尋特定名稱的安全軟體檔案..."

# 使用 find 指令搜尋整個檔案系統
# -name 參數：依檔案名稱搜尋
# -o 參數：邏輯 OR 運算子
# 2>/dev/null：將錯誤訊息重導向到 /dev/null，避免權限錯誤干擾輸出
find / \( -name "*antivirus*" -o -name "*edr*" -o -name "*defend*" \) 2>/dev/null | head -n 20

echo ""
echo "[資訊] 檢查已知安全產品的安裝路徑..."

# 定義常見安全產品的安裝路徑
KNOWN_PATHS=(
  "/opt/sophos"
  "/opt/CrowdStrike"
  "/opt/carbonblack"
  "/opt/cylance"
  "/opt/sentinelone"
  "/etc/clamav"
  "/etc/defender"
)

# 檢查每個已知路徑是否存在
for path in "${KNOWN_PATHS[@]}"; do
  if [[ -e "$path" ]]; then
    echo "[發現] 偵測到安全產品目錄: $path"
    # 顯示目錄內容
    ls -la "$path" | head -n 10
  fi
done

echo ""
echo "[資訊] 檢查可疑的設定檔..."

# 搜尋可能的安全軟體設定檔
CONF_DIRS=("/etc" "/opt")
for dir in "${CONF_DIRS[@]}"; do
  if [[ -d "$dir" ]]; then
    # 搜尋 .conf 結尾的設定檔
    find "$dir" -maxdepth 3 -type f -name "*.conf" 2>/dev/null | \
    while read -r conf_file; do
      # 檢查設定檔內容是否包含安全相關關鍵字
      if grep -qiE "(antivirus|malware|threat|protection)" "$conf_file" 2>/dev/null; then
        echo "[發現] 可疑的設定檔: $conf_file"
      fi
    done
  fi
done

#!/bin/bash

# 網路連線分析指令碼
# 用於識別與安全管理伺服器的通訊

echo "[資訊] 列出所有活躍的網路連線..."

# 使用 netstat 指令顯示網路連線
# -t 參數：顯示 TCP 連線
# -u 參數：顯示 UDP 連線
# -l 參數：顯示監聽中的通訊埠
# -n 參數：以數字格式顯示位址與埠號
# 備註：netstat 在某些新版系統中被 ss 指令取代
if command -v netstat &> /dev/null; then
  netstat -tuln
else
  # 使用 ss 作為替代方案
  # ss 是較新的網路統計工具，效能更佳
  ss -tuln
fi

echo ""
echo "[資訊] 檢查對外的已建立連線..."

# 篩選 ESTABLISHED 狀態的連線
# 這些是目前活躍的通訊連結
if command -v netstat &> /dev/null; then
  netstat -tnp | grep ESTABLISHED
else
  ss -tnp state established
fi

echo ""
echo "[資訊] 分析常見的管理伺服器通訊埠..."

# 定義常見的管理協定通訊埠
MGMT_PORTS=(
  "443"   # HTTPS
  "8080"  # HTTP 替代埠
  "8443"  # HTTPS 替代埠
  "22"    # SSH
  "3389"  # RDP
  "5985"  # WinRM HTTP
  "5986"  # WinRM HTTPS
)

for port in "${MGMT_PORTS[@]}"; do
  echo "[檢查] 通訊埠 $port 的連線狀態..."
  if command -v netstat &> /dev/null; then
    netstat -tnp | grep ":$port" | grep ESTABLISHED
  else
    ss -tnp state established "( sport = :$port or dport = :$port )"
  fi
done

echo ""
echo "[資訊] 檢查 DNS 查詢記錄..."

# 分析 /etc/resolv.conf 取得 DNS 伺服器資訊
if [[ -f /etc/resolv.conf ]]; then
  echo "[資訊] 設定的 DNS 伺服器:"
  grep nameserver /etc/resolv.conf
fi

# 檢查最近的 DNS 快取
# 某些系統會執行本地 DNS 快取服務
if command -v systemd-resolve &> /dev/null; then
  echo "[資訊] 查詢 systemd-resolved 統計資訊..."
  systemd-resolve --statistics 2>/dev/null
fi