Skip to content

Secure Search Guide

Privacy-focused search capabilities powered by SearXNG integration in Local AI Cyber Lab

Overview

The Secure Search feature provides a privacy-respecting search engine integration that allows users to perform web searches without compromising data security or privacy. Built on SearXNG, it offers enterprise-grade search capabilities while maintaining complete control over search data.

Features

  • Privacy-First Search: No tracking, no logging of personal data
  • Multiple Search Engine Support: Aggregates results from various sources
  • Customizable Results: Filter and sort based on your preferences
  • API Integration: RESTful API for programmatic access
  • Enterprise Controls: Rate limiting and access management

Configuration

Basic Setup

  1. Access the search interface at http://home-lab.cyber-ai-agents.com/search
  2. Configure your preferred search engines in the settings
  3. Set up authentication if required
# Example configuration in your .env file
SEARXNG_SAFE_SEARCH=1
SEARXNG_AUTOCOMPLETE=1
SEARXNG_RATE_LIMIT=50

Advanced Settings

Search Engine Selection

engines:
  - name: google
    enabled: true
    tokens: ['YOUR_API_KEY']
  - name: bing
    enabled: true
    tokens: ['YOUR_API_KEY']

Rate Limiting

limits:
  daily: 1000
  hourly: 100
  minute: 10

Security Features

1. Request Anonymization

  • Removes identifying information from search requests
  • Rotates IP addresses for external queries
  • Strips tracking parameters from URLs

2. Result Filtering

  • Content security policy enforcement
  • Malicious site filtering
  • Safe search options

3. Access Control

  • Role-based access control
  • API key authentication
  • Usage quotas

API Usage

Search Endpoint

curl -X GET "http://home-lab.cyber-ai-agents.com/api/search" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d "q=your search query" \
     -d "format=json"

Response Format

{
    "query": "your search query",
    "results": [
        {
            "title": "Result Title",
            "url": "https://example.com",
            "content": "Result snippet...",
            "score": 0.95
        }
    ],
    "total": 100,
    "time": 0.234
}

Best Practices

  1. Use Specific Queries
  2. Be precise with search terms
  3. Utilize advanced search operators

  4. Filter results appropriately

  5. Security Considerations

  6. Regularly rotate API keys
  7. Monitor usage patterns

  8. Set appropriate rate limits

  9. Performance Optimization

  10. Cache common searches
  11. Use batch requests when possible
  12. Implement client-side result caching

Monitoring & Maintenance

Usage Metrics

  • Track search volumes
  • Monitor response times
  • Analyze query patterns

Health Checks

  • Regular engine availability tests
  • Result quality assessment
  • Performance benchmarking

Troubleshooting

Common Issues

  1. Slow Response Times
  2. Check network connectivity
  3. Verify engine availability

  4. Review rate limiting settings

  5. Missing Results

  6. Verify search engine configurations
  7. Check content filtering settings

  8. Validate API keys

  9. Access Denied

  10. Confirm authentication
  11. Check rate limits
  12. Verify IP allowlist

Support

For technical support or questions: - Email: support@cyber-ai-agents.com - Documentation: http://home-lab.cyber-ai-agents.com/docs - Issue Tracking: GitHub Issues