This search command is packaged with the following external libraries:
+ GeoNames city database: http://download.geonames.org/export/dump/cities1000.zip
+ GeoNames Admin Code database: http://download.geonames.org/export/dump/admin1CodesASCII.txt
+ GeoNames Country database: http://download.geonames.org/export/dump/countryInfo.txt
The city list is maintained via a scripted input that uses the following OS utilities:
+ rm
+ wget
+ unzip
+ cat
+ cut
+ echo
+ date
+ grep
Follow standard Splunk installation procedures to install this app.
Reference: https://docs.splunk.com/Documentation/AddOns/released/Overview/Singleserverinstall
Reference: https://docs.splunk.com/Documentation/AddOns/released/Overview/Distributedinstall
There are two scripted inputs:
updatecountry.sh
updatecities.sh
These are written for Linux systems and are disabled by default. The expected libraries are included with this app and this is only important if you want to maintain updated versions of the external databases.
The purpose of this app is to provide an external lookup method for converting city information into the nearest known lat/long combination primarily for the generation of identity and asset information for Splunk Enterprise Security.
If a city/country/region is provided, we try to return the lat/lon
If a city/country was provided,
Note: if a region is not provided, a partial match using just the City and Country is attempted.
Do the lookup
This app leverages the admin codes database (http://download.geonames.org/export/dump/admin1CodesASCII.txt) for region normalization. When the lookup is initialized a dictionary is created converting entries in this database from:
CA.08 Ontario Ontario 6093943
To:
[CA.08] = Ontario
When a region is provided during the lookup, the app attempts to find the first matching value and return the key. If a key is found, then we use the region portion (i.e. 08) as the region for our lookup:
region = matched_key[len(result[args.country])+1::]
The result is the ability to match database entries formated like this:
* Amherstburg 42.11679 -83.04985 CA 08 America/Toronto
(City / Lat / Lon / Country Code / Region Code / Timezone)
The external lookup cannot be distributed at this time. Ensure the lookup command is set to "local=true".
| lookup local=true geolocate city,region,country OUTPUT lat,lon
Additionally, the lookup can output the matched time zone:
| lookup local=true geolocate city,region,country OUTPUT lat,lon,timezone
If support is required or you would like to contribute to this project, please reference: https://gitlab.com/johnfromthefuture/TA-geolocate. This app is supported by the developer as time allows.
1.1.4
Confirmed compatibility with Splunk 8 / py3.
## 1.1.3
+ Tested compatibility with 7.3
+ Minor code change for future py3 compatibility
+ Updated included external library text files
## 1.1.2
+ Tested compat with 7.2
+ Added readme note that the command must be run with "local=true"
Disabled inputs by default as it was expected per app documentation
Splunk AppInspect evaluates Splunk apps against a set of Splunk-defined criteria to assess the validity and security of an app package and components.
As a Splunkbase app developer, you will have access to all Splunk development resources and receive a 10GB license to build an app that will help solve use cases for customers all over the world. Splunkbase has 1000+ apps and add-ons from Splunk, our partners and our community. Find an app or add-on for most any data source and user need, or simply create your own with help from our developer portal.