README.md

metadata

title: InfoSecAI-finalProj-backend
emoji: 🌍
colorFrom: green
colorTo: pink
sdk: gradio
sdk_version: 6.9.0
app_file: app.py
pinned: false

InfoSecAI-finalProj

這是一個基於 Gradio 的資訊安全防護系統，用於模擬校園入口網站的異常行為檢測和身份驗證。系統利用 HDBSCAN 進行異常檢測，並結合環境變數來設定 SMTP 郵件通知。

專案結構

InfoSecAI-finalProj/
├── app.py                      # Gradio 應用程式主檔案
├── requirements.txt            # Python 依賴項清單
├── SimHei.ttf                  # 中文字體檔案 (用於 Matplotlib 顯示)
├── baseline_logs.csv           # 歷史日誌數據 (用於模型訓練和基準)
├── hdbscan_model.pkl           # HDBSCAN 模型檔案
├── le_action.pkl               # Label Encoder (action)
├── le_ip.pkl                   # Label Encoder (IP)
├── logger_service.py           # 日誌服務模組
└── README.md                   # 專案說明文件 (包含 Hugging Face Spaces 配置)

環境變數設定 (Hugging Face Spaces)

為了應用程式能正常運作，請在 Hugging Face Spaces 的「Settings」->「Repository secrets」中設定以下環境變數：

• SMTP_HOST：SMTP 伺服器地址
• SMTP_PORT：SMTP 伺服器端口 (通常是 587)
• SMTP_USERNAME：SMTP 登入用戶名 (發送郵件的郵箱地址)
• SMTP_PASSWORD：SMTP 登入密碼 (或應用程式專用密碼)
• SMTP_FROM：發送郵件的地址 (如果與 SMTP_USERNAME 相同則可省略)
• APP_BASE_URL：您的 Hugging Face Spaces 應用程式的 URL (例如 https://your-username-your-space-name.hf.space)
• FIXED_TEST_EMAIL：用於測試郵件發送的固定電子郵件地址
• GROQ_API_KEY：如果啟用 Groq AI 分析功能，請提供 API Key
• ENABLE_HDBSCAN：設置為 1 以啟用 HDBSCAN 異常檢測，設置為 0 則禁用。

啟動應用程式

Hugging Face Spaces 會自動安裝 requirements.txt 中的依賴並運行 app.py。您無需手動執行啟動指令。

測試與使用

1. 部署後，訪問您的 Hugging Face Spaces URL。
2. 透過模擬器輸入 IP、Cookie 等資訊，並嘗試登入或執行各項操作。
3. 觀察「即時 Log 與 AI 判定區」和「異常 Log 分析」來查看系統的檢測結果。
4. 您也可以在管理員介面調整防護強度和觸發自動測試。

如有任何問題，請隨時提出！