nano SIEM
Enrichments

IPinfo Lite

Supported in:Self-hosted

Country, continent and autonomous system for public IPs, written to OCSF endpoint attributes at ingest.

Use IPinfo Lite to add country, continent, and autonomous-system context to public IPs in your events. ClickHouse looks up src_endpoint.ip and dst_endpoint.ip at ingest in a local copy of IPinfo's free IP-to-country-and-ASN dataset.

Lookups fill standard OCSF location and autonomous-system attributes. They make no per-lookup API call and have no rate limit.

What it writes

For a public IP that's in the database, nano fills these attributes on the matching endpoint. It only fills an attribute the event doesn't already have, so values from the source log win.

PathExample
src_endpoint.location.countryUS (ISO 3166-1 alpha-2)
src_endpoint.location.continentNorth America
src_endpoint.autonomous_system.number15169
src_endpoint.autonomous_system.nameGoogle LLC

The same paths exist under dst_endpoint. Private, loopback and other non-public addresses aren't enriched.

Search examples

Top source countries:

src_endpoint.location.country=* | stats count by src_endpoint.location.country | sort -count | head 10

Successful logins from outside your usual countries:

class_uid=3002 status_id=1 src_endpoint.location.country=* src_endpoint.location.country!="US" | stats count, dc(src_endpoint.ip) as ips by user.name, src_endpoint.location.country

Outbound traffic by destination network owner:

class_uid=4001 dst_endpoint.autonomous_system.name=* | stats sum(traffic.bytes_out) as bytes by dst_endpoint.autonomous_system.name | sort -bytes | head 20

How it's delivered

IPinfo Lite is part of nano's signed platform feed bundle, on open core and Self-run alike. You don't need an IPinfo account or token: nano fetches the dataset, signs it into the bundle, and your install loads it into ClickHouse's IP dictionary.

Marketplace shows the feed's state (fresh, stale or expired) and when the bundle was installed. A feed older than 7 days is shown as stale but still used; an expired feed no longer stamps new events.

To look up a single IP, call GET /api/enrichment/lookup/{ip}.

Troubleshoot

Need help with these checks? Contact support with the request ID and time with timezone.

A public IP has no location

Check that the event has src_endpoint.ip or dst_endpoint.ip and that the IP is in the database. nano does not replace attributes already set by the parser. Then check the feed state and ClickHouse memory; see the IPinfo checks.

What's next

On this page