Skip to content

Geolocation

philrz edited this page Mar 6, 2023 · 4 revisions

Geolocation

Summary

Brimcap provides limited geolocation support by adding fields to the conn records of Zeek logs that are generated from imported pcaps. As Zui uses a bundled Brimcap to create Zeek logs from pcaps, this geolocation data is available in the app for your imported captures.

Examples

The following screenshot shows where the geolocation fields may be found in the Log Detail view for a Zeek conn record generated from a pcap.

Geolocation in Log Detail

This screenshot shows an example aggregation that uses geolocation data.

Geolocation Aggregation

Origin

When added to Zeek conn records for imported pcaps, this data is provided by the geoip-conn Zeek package. For details on the origin and accuracy of the geolocation data, see the README.

Future Functionality

There are additional geolocation features in Zui that may be added in the future, depending on demand from the community. The following issues are currently being held open to gather interest:

Issue Description
zui/936 Geolocation map visualization
zui/954 Look up Geolocation data on-demand
zui/955 Allow user to replace the Geolocation database
geoip-conn/39 Include autonomous system info

If you're interested in additional geolocation features, please follow the links to review these issues and click 👍 below the description on any of these features you'd like to see added. If you have additional feedback or ideas on this functionality, feel free to add a comment to the issues, or join our public Slack and talk to us. Thanks!

Support Resources

User Documentation

Clone this wiki locally