kjh2064/KArtSell.Aegis
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Fix Host startup guidance - DEVELOPMENT mode required for DevelopmentHeaderAuthenticationHandler

Browse Source
This commit is contained in:
김재현
2026-08-02 23:08:16 +09:00
parent 804de9d5a4
commit 77b05e17f7
1 changed files with 43 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CLAUDE.md
+43 -10
View File
@@ -45,21 +45,54 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
⏳ Step 3: Host restart required (to apply changes) ⏳ Step 3: Host restart required (to apply changes)
⏳ Step 4: Retry Gate 3-4 with auth headers ⏳ Step 4: Retry Gate 3-4 with auth headers
**Next Action:** User must restart Host after code change **Next Action: Host Startup (DEVELOPMENT MODE - Critical!)**
⚠️ **IMPORTANT: Host must run in DEVELOPMENT mode for authentication to work**
```bash ```bash
# Terminal (after killing current Host process) # Terminal 1: SSH Tunnel (keep open)
ssh -L 5432:127.0.0.1:5432 kjh2064@178.104.200.7
# Terminal 2: Start Host in DEVELOPMENT MODE (NOT Release)
cd D:\JobRoomz\KArtSell.Aegis cd D:\JobRoomz\KArtSell.Aegis
$env:KRX_API_KEY = "local-dev-test-key"
$env:OPENDART_API_KEY = "local-dev-test-key" # Set actual API keys from Gitea Secrets (not test keys!)
$env:KIS_API_KEY = "local-dev-test-key" $env:KRX_API_KEY = "<actual-krx-api-key>"
dotnet run --project src/KArtSell.Host -c Release $env:OPENDART_API_KEY = "<actual-opendart-api-key>"
$env:KIS_API_KEY = "<actual-kis-api-key>"
$env:ASPNETCORE_ENVIRONMENT = "Development"
# Run in DEBUG mode (Development environment)
dotnet run --project src/KArtSell.Host
# Expected output:
# Now listening on: http://127.0.0.1:5002
# Application started. Press Ctrl+C to shut down.
``` ```
**Then test with Auth headers:** **Why DEVELOPMENT mode?**
- **Release mode (-c Release):** Uses `FailClosedAuthenticationHandler` → all requests denied (403/404)
- **Debug mode (default):** Uses `DevelopmentHeaderAuthenticationHandler` → accepts `X-KArtSell-User` / `X-KArtSell-Role` headers
**Gate 3 Request (after Host ready):**
```powershell ```powershell
$headers = @{"X-KArtSell-User"="admin"; "X-KArtSell-Role"="Admin"} $headers = @{
$body = @{"modelId"="00000000-0000-0000-0000-000000000001"; ...} | ConvertTo-Json "X-KArtSell-User" = "gate3-rehearsal"
Invoke-WebRequest -Uri "http://127.0.0.1:5002/api/shadow-runs" -Method POST -Headers $headers -Body $body "X-KArtSell-Role" = "researcher"
"Content-Type" = "application/json"
}
$body = @{
modelId = "00000000-0000-0000-0000-000000000001"
windowStartDate = "2024-01-02"
windowEndDate = "2024-08-31"
} | ConvertTo-Json
Invoke-WebRequest -Uri "http://127.0.0.1:5002/api/shadow-runs" `
-Method POST `
-Headers $headers `
-Body $body `
-ContentType "application/json"
``` ```
--- ---