Troubleshooting & FAQ
Solutions to common problems and answers to frequently asked questions.Common Issues
API Key Not Working
Symptoms:- 401 Unauthorized errors
- “Invalid API key” messages
High Latency
Symptoms:- Slow API responses (>500ms)
- Timeouts
False Positives
Symptoms:- Legitimate content flagged as threats
- Over-sensitive detection
Rate Limiting
Symptoms:- 429 Too Many Requests errors
- Throttled responses
Rate limits vary by plan. Check your dashboard for current limits and consider upgrading if you need higher throughput.
Memory Leaks
Symptoms:- Increasing memory usage over time
- Application crashes
Debugging Tips
Enable Debug Logging
Inspect Scan Results
Network Debugging
Performance Profiling
Frequently Asked Questions
How accurate is threat detection?
How accurate is threat detection?
KoreShield achieves 95%+ accuracy across 10+ attack types:
- Prompt injection: 97%
- Jailbreak attempts: 96%
- PII leakage: 98%
- Toxic content: 94%
What is the API rate limit?
What is the API rate limit?
Rate limits vary by plan:
- Free tier: 1,000 requests/month (~33/day)
- Pro tier: 100,000 requests/month (~3,300/day)
- Enterprise: Unlimited with dedicated infrastructure
Does scanning work offline?
Does scanning work offline?
No, KoreShield requires internet connectivity to access our cloud-based detection models. For air-gapped environments, contact sales about on-premises deployment options.
Can I self-host KoreShield?
Can I self-host KoreShield?
Yes, enterprise customers can deploy on-premises using:
- Docker containers
- Kubernetes (Helm charts provided)
- AWS/GCP/Azure private deployments
What data is stored?
What data is stored?
By default, we store:
- Scan results (threat type, confidence)
- Metadata (user ID, timestamps)
- Aggregated analytics
Is my data encrypted?
Is my data encrypted?
Yes, all data is encrypted:
- In transit: TLS 1.3
- At rest: AES-256
- Keys: Managed via AWS KMS or your own key management
What compliance certifications do you have?
What compliance certifications do you have?
- SOC 2 Type II ✓
- GDPR compliant ✓
- HIPAA compliant (enterprise with BAA) ✓
- PCI-DSS Level 1 (in progress)
- FedRAMP (GovCloud available)
How do I migrate from another solution?
How do I migrate from another solution?
Can I use KoreShield with streaming responses?
Can I use KoreShield with streaming responses?
Yes! See our Streaming Guide for implementation details. Security checks occur before streaming begins.
What happens if KoreShield is down?
What happens if KoreShield is down?
Implement graceful degradation:Enterprise plans include 99.9% uptime SLA. Check status.koreshield.com for real-time status.
How do I handle multi-language content?
How do I handle multi-language content?
KoreShield supports 50+ languages automatically:Language detection is automatic. The optional
language parameter improves accuracy for ambiguous text.Can I customize detection rules?
Can I customize detection rules?
Yes, enterprise customers can create custom rules:Contact support to configure custom rule sets in your account.
How do I test in development?
How do I test in development?
Use test API keys:Test keys have lower rate limits but don’t affect production quotas.
What is the average response time?
What is the average response time?
Performance metrics:
- P50: 50ms
- P95: 150ms
- P99: 300ms
Can I use KoreShield with serverless functions?
Can I use KoreShield with serverless functions?
Yes, works great with Lambda, Vercel, Netlify:Use connection pooling and caching to avoid cold start penalties.
How do I monitor usage?
How do I monitor usage?
Check the dashboard or use the API:
Error Codes
| Code | Meaning | Solution |
|---|---|---|
| 401 | Invalid API key | Check your API key and ensure it starts with ks_ |
| 429 | Rate limit exceeded | Implement backoff or upgrade your plan |
| 500 | Server error | Retry with exponential backoff |
| 503 | Service unavailable | Check status.koreshield.com |
Getting Help
Documentation
Comprehensive guides and API reference
Discord Community
Join our community for support and discussions
Email Support
Direct support from our team
Status Page
Real-time system status and incident updates