ip address geolocation lookup

[aptxx]

Support ip to geo location #2350

Looking for reviews

MaxMind is implemented. The MaxMind reader returns a 3166-1 Alpha2 country code. We've added a mapping for countrycode that converts the parsed Alpha2 code to Alpha3. To align with prebid-server-java and make it easier for non-developers to configure, the mapping data is stored in the country-codes.csv file within the code repository. This file is will be packaged into the binary at compile time.

The configuration files are mostly ported from the Java version to maintain consistency, so the default configurations are identical. The URL https://geolite.maxmind.com/download/geoip/database/GeoLite2-City.tar.gz is no longer valid. You now need to register a MaxMind account and get download link.

However, you can anonymously download the MMDB file from here: https://github.com/P3TERX/GeoLite.mmdb. But please remember, you will need to package it yourself into a .tar.gz format.

Configs

New section example:

geolocation:
    enabled: false
    type: maxmind
    maxmind:
        remote_file_syncer:
            http_client:
                max_connections_per_host: 0
                max_idle_connections: 40
                max_idle_connections_per_host: 2
                idle_connection_timeout_seconds: 60
            download_url: "https://geolite.maxmind.com/download/geoip/database/GeoLite2-City.tar.gz"
            save_filepath: "/var/tmp/prebid/GeoLite2-City.tar.gz"
            tmp_filepath: "/var/tmp/prebid/tmp/GeoLite2-City.tar.gz"
            retry_count: 3
            retry_interval_ms: 3000
            timeout_ms: 300000
            update_interval_ms: 0

GeoLocation feature need actived at account side. For example, actived in default account

account_defaults:
    geolocation:
        enabled: true

Privacy

Considering that the IP needs to be checked for privacy status before use, and to avoid unnecessary processing of private information, we've extracted a more general method to determine the privacy status.

Additionally, following the traffic diagram from Prebid Server and GDPR, we've also implemented the consent_string_means_in_scope configuration option, which can be configured in both account GDPR and global GDPR settings