Files
warpbox/docs/geoip-guide.md
Daniel Legt fbeff3f6c0
All checks were successful
Build and Publish Docker Image / deploy (push) Successful in 1m44s
feat/security
Reviewed-on: #2
2026-05-04 00:00:36 +03:00

20 lines
670 B
Markdown

# GeoIP Guide (Planning)
This project intentionally does not enable GeoIP enforcement yet.
Planned integration target: `github.com/rabuchaim/geoip2fast`.
## Recommended approach
1. Load one shared GeoIP provider instance at startup.
2. Add a small in-memory cache keyed by IP with TTL.
3. Apply lookup timeout and fallback to `unknown` values on failures.
4. Use results first in the admin security detail pane.
5. Add aggregated statistics only after detail pane behavior is stable.
## Why this is safe
- No request path should fail because GeoIP lookup fails.
- Lookup cost stays bounded with caching.
- Security decisions remain independent from GeoIP quality.