Module Name: FreeGeoIP
Module path: recon/hosts-hosts/freegeoip


SERVERURL:
SOURCE:


Name: FreeGeoIP
Path: modules/recon/hosts-hosts/freegeoip.py
Author: Gerrit Helm (G) and Tim Tomes (@LaNMaSteR53)

Description:
Leverages the freegeoip.net API to geolocate a host by IP address. Updates the 'hosts' table with the results.

Options:
Name Current Value Required Description
SERVERURL http://freegeoip.net yes overwrite server url (e.g. for local installations)
SOURCE default yes source of input (see 'show info' for details)

Source Options:
default SELECT DISTINCT ip_address FROM hosts WHERE ip_address IS NOT NULL
<string> string representing a single input
<path> path to a file containing a list of inputs
query <sql> database query returning one column of inputs

Comments:
* Allows up to 10,000 queries per hour by default. Once this limit is reached, all requests will result in HTTP 403, forbidden, until the quota is cleared.