IPInfo Lite (Geolocation)

IPInfo Lite provides free IP geolocation and ASN data. nano enriches every src_ip and dest_ip with country, continent, and ASN context from a bulk CSV that you download once per sync, so there is no per-lookup cost or API rate limit at ingestion.

Features

• Country and continent identification
• ASN and organization mapping
• Free bulk CSV download (the Lite dataset is free)
• Updated daily by IPinfo
• Requires a free IPinfo account to get a tokenized download URL

Prerequisites

• nano instance running and accessible
• Admin access to the web interface
• Internet connectivity for downloading enrichment data

Setting Up IPInfo Lite

Step 1: Find IPInfo Lite in the Marketplace

Open Marketplace from the left sidebar and search for "ipinfo":

If an update is available for the enrichment, click the update icon to get the latest version:

Click the IPInfo Lite card to open its configuration:

Step 2: Get Your Download URL from IPinfo

Open the IPinfo Lite dashboard and click Go to Data Downloads:

Find the IP to Country ASN database and click Download:

Right-click Download CSV and copy the link:

Step 3: Configure in nano

Back in nano, paste the copied URL into the Download URL field:

Click Save Credentials:

Step 4: Sync the Data

Click Sync Now to download and load the enrichment data. This typically takes 30-60 seconds.

Once the sync completes, the card shows the record count (~400,000+ IP ranges) and the last sync time. The enrichment is now active: incoming logs with IP addresses are enriched with geolocation and ASN data automatically.

Data Fields Added

When IPInfo Lite is enabled, the following fields are added to logs:

Example Enriched Log

{
  "timestamp": "2024-01-01T12:00:00Z",
  "src_ip": "8.8.8.8",
  "dest_ip": "192.168.1.100",
  "enriched_src_country": "United States",
  "enriched_src_country_code": "US",
  "enriched_src_continent": "North America",
  "enriched_src_continent_code": "NA",
  "enriched_src_asn": "AS15169",
  "enriched_src_as_name": "Google LLC",
  "enriched_src_as_domain": "google.com"
}

Automatic Sync Configuration

Keep your enrichment data current with automatic synchronization.

Enable Auto-Sync

1. Configure Schedule

   • Open IPInfo Lite from the Marketplace
   • Scroll to the Automatic Sync section
   • Toggle Enable Auto-Sync

2. Set Sync Interval

   • Choose from predefined intervals:
     • Every 6 hours
     • Every 12 hours
     • Daily (24 hours), recommended
     • Every 2 days
     • Weekly

3. Monitor Schedule

   • View next scheduled sync time
   • Check sync history and status
   • Receive notifications on sync failures

Custom Sync Schedules

For advanced users, configure custom sync schedules using cron expressions:

# Daily at 2 AM UTC
0 2 * * *

# Every 6 hours
0 */6 * * *

# Weekly on Sundays at 3 AM
0 3 * * 0

Best Practices

• Daily Sync: Recommended for most deployments
• Weekly Sync: Sufficient for smaller environments
• Monitor Failures: Set up alerting for sync failures
• Validate Data: Periodically test IP lookups after sync

Using Enriched Data

Search Queries

Find Traffic by Country:

enriched_src_country_code = "CN" OR enriched_dest_country_code = "CN"

Identify Cloud Providers:

enriched_src_as_name LIKE "%Amazon%" OR enriched_src_as_name LIKE "%Google%" OR enriched_src_as_name LIKE "%Microsoft%"

Detect International Traffic:

enriched_src_country_code != "US" AND enriched_dest_country_code = "US"

Find Specific ASNs:

enriched_src_asn = "AS15169"  -- Google

Detection Rules

Suspicious Geographic Activity:

name: "Traffic from High-Risk Countries"
query: |
  enriched_src_country_code IN ("CN", "RU", "KP", "IR")
  AND dest_port IN (22, 3389, 443)
severity: medium

Cloud Service Anomalies:

name: "Unusual Cloud Provider Access"
query: |
  enriched_dest_as_name LIKE "%Amazon%"
  AND enriched_src_country_code NOT IN ("US", "CA", "GB")
severity: low

Dashboard Visualizations

• World map showing traffic by country
• Bar chart of top source countries
• Pie chart of continent distribution
• Top ASNs by traffic volume
• Cloud vs. on-premises traffic ratios

API Integration

Programmatically manage IPInfo Lite:

# Trigger manual sync
curl -X POST http://nanosiem:3000/api/enrichment/ipinfo/sync \
  -H "Authorization: Bearer YOUR_API_KEY"

# Check sync status
curl http://nanosiem:3000/api/enrichment/sources \
  -H "Authorization: Bearer YOUR_API_KEY"

Performance

• Memory Usage: ~500MB in memory
• Lookup Performance: <1ms per IP
• Batch Processing: 10,000+ IPs/second
• Database Storage: ~2GB for full dataset
• Download Size: ~100MB compressed

Next Steps

• Field Reference: every geolocation field
• ThreatFox: add threat intelligence enrichment
• Troubleshooting: fix common IPInfo Lite issues