MaxMind Geolocation DXL Service 0.2.0

MaxMind Host/IP Geolocation service for use with the OpenDXL Python Client

Overview

The MaxMind DXL Python service exposes IP geo-location lookups in a MaxMind GeoLite2 or GeoIP2 database via the Data Exchange Layer (DXL) fabric.

Documentation

See the Wiki for an overview of the MaxMind DXL Python service and usage examples.


See the MaxMind API DXL Python service documentation for installation instructions, API documentation, and usage examples.


Icon made by Freepik from www.flaticon.com

  • Version 0.2.0

    Release notes:

    • Updated to support both Python 2 and 3
  • Version 0.1.3

    Release notes:

    • Updated to be consistent with bootstrap 0.1.4
  • Version 0.1.2

    Release notes:

    • Updated Dockerfile to use slim vs. alpine (glibc issues)
  • Version 0.1.1

    Release notes:

    • Updated Dockerfile to include VOLUME definition
  • Version 0.1.0

Bootprint

MaxMind Geolocation DXL Service

Version: 0.1.0

The MaxMind DXL Python service exposes Host/IP Geolocation lookups in a MaxMind GeoLite2 or GeoIP2 database via the Data Exchange Layer (DXL) fabric.

Solutions

MaxMind Geolocation DXL Service

The MaxMind DXL Service.

MaxMind API Reference

Version:

0.2.0

MaxMind DXL Service

Services

MaxMind Geolocation DXL Service

The MaxMind DXL Python service exposes Host/IP Geolocation lookups in a MaxMind GeoLite2 or GeoIP2 database via the Data Exchange Layer (DXL) fabric.

MaxMind DXL Python Service (GitHub)

Version:

0.2.0

/opendxl-maxmind/service/geolocation/host_lookup

Requests

/opendxl-maxmind/service/geolocation/host_lookup

Invokes a MaxMind Host/IP geolocation lookup and returns the results.

payload: object

{
"host": "8.8.8.8"
}
host: string

Hostname or IP address for which to retrieve Geolocation information.

A JSON structure representing the Geolocation information for the specified host/IP. See the MaxMind GeoIP2 Precision Web Services API for more information.

payload: object

{
"continent": {
"code": "NA",
"geoname_id": 6255149,
"names": {
"de": "Nordamerika",
"en": "North America",
"es": "Norteamérica",
"fr": "Amérique du Nord",
"ja": "北アメリカ",
"pt-BR": "América do Norte",
"ru": "Северная Америка",
"zh-CN": "北美洲"
}
}
,
"country": {
"geoname_id": 6252001,
"iso_code": "US",
"names": {
"de": "USA",
"en": "United States",
"es": "Estados Unidos",
"fr": "États-Unis",
"ja": "アメリカ合衆国",
"pt-BR": "Estados Unidos",
"ru": "США",
"zh-CN": "美国"
}
}
,
"location": {
"accuracy_radius": 1000,
"latitude": 37.751,
"longitude": -97.822
}
,
"registered_country": {
"geoname_id": 6252001,
"iso_code": "US",
"names": {
"de": "USA",
"en": "United States",
"es": "Estados Unidos",
"fr": "États-Unis",
"ja": "アメリカ合衆国",
"pt-BR": "Estados Unidos",
"ru": "США",
"zh-CN": "美国"
}
}
}
Error Code: 0

payload: object

"Error invoking service with topic '/opendxl-maxmind/service/geolocation/host_lookup': argument 1 must be string, not int"
                                                                            
errorMessage: string

Message string containing error information.

Definitions

Error Response Object: object

"Error invoking service with topic '/opendxl-maxmind/service/geolocation/host_lookup': argument 1 must be string, not int"
                            
errorMessage: string

Message string containing error information.