jim800121chen
22f0837ba8
從 edge-ai-platform POC 轉為正式產品的雲端後端，含以下整合階段：
- Phase 0：雛形骨架 — `cmd/api-server` (REST :3721) + `cmd/remote-proxy`
(tunnel :3800 / internal :3801) 雙 binary 共用 internal/，沿用 POC 的
WebSocket+yamux tunnel 協定但解耦 relay 與 API
- Phase 0.6：OIDC BFF 接 Innovedus Member Center
- internal/oidc package（coreos/go-oidc + PKCE S256 + state + nonce）
- internal/usersession package（HMAC-SHA256 cookie + RotateSessionID
防 session fixation, OWASP ASVS V3.2.1）
- 4 個 OIDC handler（/api/auth/login｜callback｜me｜logout）+ AuthMiddleware
- 完全拔除 StaticAuthProvider，OIDC 是唯一認證路徑
- 9 個 ADR（含 ADR-010 BFF / ADR-011 取代 static auth /
ADR-012 pending session shared cookie / ADR-013 PKCE-only public client）
- Phase 0.7：A1 改造 + security audit 修復
- OIDC ClientSecret 變選填，支援 stage MC 的 public PKCE-only client
（AuthStyleInParams 強制 token endpoint 不送 client_secret）
- 預留 ServiceClient* 欄位給未來 client_credentials grant
- 移除 13+ 處 resolveUserID(uc, StaticUserID) fallback 改 strict mode
（Audit C1：multi-tenant 隔離破口）
- Pairing exchange MarkUsed 失敗 abort + revoke session token（Audit M3）
- 新增 all_endpoints_require_auth_test 整合測試（51 endpoint × 401）
驗證：go test -race -count=3 ./... 17 packages 全綠 / go vet 0 warning
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
40 lines
1.2 KiB
Go
40 lines
1.2 KiB
Go
// Package logger 提供最小化的結構化 JSON logger，建構於 Go 1.21+ 的 log/slog。
|
||
//
|
||
// 設計原則：
|
||
// - 所有日誌為 JSON line，便於雲端 log aggregator 解析（CloudWatch / Loki / Datadog）。
|
||
// - 不包太多層 — 直接回傳 *slog.Logger，由呼叫端自由使用 slog 的 API。
|
||
// - 輸出到 stdout（12-Factor App 第 11 條：logs as event streams）。
|
||
package logger
|
||
|
||
import (
|
||
"log/slog"
|
||
"os"
|
||
"strings"
|
||
)
|
||
|
||
// New 建立一個輸出為 JSON 的結構化 logger。
|
||
//
|
||
// level 接受 "debug" / "info" / "warn" / "error"（大小寫不敏感）；
|
||
// 無法解析時預設為 info。
|
||
func New(level string) *slog.Logger {
|
||
handler := slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{
|
||
Level: parseLevel(level),
|
||
AddSource: false, // 需要時再開；預設關閉以降低額外成本
|
||
})
|
||
return slog.New(handler)
|
||
}
|
||
|
||
// parseLevel 將字串解析為 slog.Level，無法解析時回傳 LevelInfo。
|
||
func parseLevel(s string) slog.Level {
|
||
switch strings.ToLower(strings.TrimSpace(s)) {
|
||
case "debug":
|
||
return slog.LevelDebug
|
||
case "warn", "warning":
|
||
return slog.LevelWarn
|
||
case "error", "err":
|
||
return slog.LevelError
|
||
default:
|
||
return slog.LevelInfo
|
||
}
|
||
}
|