How moostanger794/llm-security-gateway works
AI Security Gateway is a local FastAPI service for heuristic prompt, text, and email security analysis; it does not call an LLM or enforce the returned action. The main request path validates input at the API boundary, dispatches through the orchestrator to detectors, then combines findings into a risk decision and explanation. Email analysis adds sender and URL checks. A separate local evaluation workflow loads labeled datasets, runs analysis, and reports metrics. Source excerpts show the request and detector calls; evaluation links are documented in the README.
Main entry points: orchestrator.py Security Orchestrator · email_guard.py Email Guard · main.py Application · routes.py Analysis Routes
Components 22
HTTP API
- Application
src/ai_security_gateway/main.py - Body Limits
src/ai_security_gateway/api/body_limit.py - Analysis Routes
src/ai_security_gateway/api/routes.py - Request Schemas
src/ai_security_gateway/api/schemas.py
Security Analysis
- Security Orchestrator
src/ai_security_gateway/orchestration/orchestrator.py - Prompt Guard
src/ai_security_gateway/security/prompt_guard.py - Detection Rules
src/ai_security_gateway/security/rules.py - Email Guard
src/ai_security_gateway/security/email_guard.py - URL Guard
src/ai_security_gateway/security/url_guard.py - Text Normalization
src/ai_security_gateway/security/normalization.py - Email Normalization
src/ai_security_gateway/security/email_normalization.py
Decision and Runtime
- Settings
src/ai_security_gateway/core/config.py - Safe Logging
src/ai_security_gateway/core/logging.py - Risk Engine
src/ai_security_gateway/security/risk_engine.py - Security Advisor
src/ai_security_gateway/orchestration/advisor.py - Security Result
src/ai_security_gateway/models/security.py
Local Evaluation
- Evaluation Datasets
datasets - Benchmark Runner
src/ai_security_gateway/evaluation/benchmark.py - Dataset Loader
src/ai_security_gateway/evaluation/dataset.py - Evaluation Metrics
src/ai_security_gateway/evaluation/metrics.py - Benchmark Report
src/ai_security_gateway/evaluation/benchmark.py
Other components
- API Client
Connections 32
- API Client → Application: sends requests
README.md - Application → Analysis Routes: registers routes
src/ai_security_gateway/main.py - Application → Body Limits: adds middleware
src/ai_security_gateway/main.py - Application → Settings: loads settings
src/ai_security_gateway/main.py - Application → Safe Logging: configures logging
src/ai_security_gateway/main.py - Analysis Routes → Request Schemas: validates requests
src/ai_security_gateway/api/routes.py - Analysis Routes → Security Orchestrator: dispatches analysis
src/ai_security_gateway/api/routes.py - Analysis Routes → Security Result: returns result
src/ai_security_gateway/api/routes.py - Analysis Routes → Safe Logging: logs decisions
src/ai_security_gateway/api/routes.py - Request Schemas → Text Normalization: validates text
src/ai_security_gateway/api/schemas.py - Request Schemas → Email Normalization: validates email
src/ai_security_gateway/api/schemas.py - Security Orchestrator → Prompt Guard: detects prompt threats
src/ai_security_gateway/orchestration/orchestrator.py - Security Orchestrator → Email Guard: detects email threats
src/ai_security_gateway/orchestration/orchestrator.py - Security Orchestrator → Text Normalization: normalizes text
src/ai_security_gateway/orchestration/orchestrator.py - Security Orchestrator → Email Normalization: validates email fields
src/ai_security_gateway/orchestration/orchestrator.py - Security Orchestrator → Risk Engine: scores findings
src/ai_security_gateway/orchestration/orchestrator.py - Security Orchestrator → Security Advisor: builds explanation
src/ai_security_gateway/orchestration/orchestrator.py - Security Orchestrator → Security Result: constructs result
src/ai_security_gateway/orchestration/orchestrator.py - Prompt Guard → Text Normalization: normalizes input
src/ai_security_gateway/security/prompt_guard.py - Prompt Guard → Detection Rules: applies rules
src/ai_security_gateway/security/prompt_guard.py - Email Guard → Email Normalization: normalizes email
src/ai_security_gateway/security/email_guard.py - Email Guard → Text Normalization: normalizes content
src/ai_security_gateway/security/email_guard.py - Email Guard → Prompt Guard: checks embedded prompts
src/ai_security_gateway/security/email_guard.py - Email Guard → URL Guard: checks extracted URLs
src/ai_security_gateway/security/email_guard.py - Email Guard → Risk Engine: scores findings
src/ai_security_gateway/security/email_guard.py - Risk Engine → Security Result: uses result types
src/ai_security_gateway/security/risk_engine.py - Security Advisor → Risk Engine: uses risk policy
src/ai_security_gateway/orchestration/advisor.py - Evaluation Datasets → Dataset Loader: provides records
README.md - Benchmark Runner → Dataset Loader: loads datasets
README.md - Benchmark Runner → Security Orchestrator: runs analysis
README.md - Benchmark Runner → Evaluation Metrics: computes metrics
README.md - Benchmark Runner → Benchmark Report: writes report
README.md