#### Configuring IP City Plug-In

The IP City anti-fraud plug-in defines the distance between a city specified in a customer account profile as a billing contact and a city where a customer computer is actually located. A customer computer location is approximately defined by a customer host IP address using the MaxMind database.

Important:

- The IP City plug-in, works only with MaxMind database. To configure the plug-in, it is necessary to upload the database. You can start and go live with the free GeoLite City database, and, in course of time, replace it with a more accurate commercial GeoIP City.
- The plug-in uses the GeoLite City database in a binary form to define a city by IP address and in a csv form - to get the coordinates of the city specified in a customer account profile billing contact. This file allows defining a customer city by IP address, i.e. defining a customer host approximate location by the moment of placing an order. Having been uploaded, both files allow the plug-in to define the coordinates of the city specified in a customer account profile billing contact and then the distance between the city an order has been placed from and the city specified in a customer billing contact.
- Both files are to be uploaded for the plug-in to work!
- Please make sure that a new database is unpacked before uploading it into Parallels Business Automation - Standard.
- Do not forget to update the database regularly to keep the proper accuracy level for the plug-in.

Note: The plug-in configuration is available from Provider Control Center only. The Reseller Control Center allows only viewing the plug-in settings.

To update or replace the database used by the IP City anti-fraud plug-in:

1. Select Anti-Fraud Manager from the Commerce Director submenu.
2. Click Anti-Fraud Plug-ins on the Anti-Fraud Manager submenu.
3. From the list of anti-fraud plug-ins that appears, select the IP City plug-in.
4. Select the Plug-In Configuration tab at the plug-in configuration screen.

   The IP Country plug-in IP Country screen displays the following:

   - Size of file. The total size of the database currently used by the plug-in.
   - Last modified. The date of the last database modification (update or replacement).
   - GeoIP info. Short description of the database, which is currently in use.
   - Geo City Location file has been uploaded. Whether the csv file that allows defining a city location is uploaded or not. - Yes, uploaded, - No, not uploaded, for the plug-in to work, click the Edit button and upload this file.
   - Units of measurement. Units to measure the distance between a customer host location and customer billing contact city.
5. Click the Edit button. You can update the database in one of the following ways:
   - If you use the MaxMind free database and want to update it, click on the Update MaxMind GeoIP City Database link or the Update MaxMind GeoCity Location File link. You will be taken to the MaxMind website, where you can download the database files to your local computer. After this, you can unpack the database files and upload them from your local computer to the Management Node. To this effect, click the Browse button next to each field and locate files. Upload the .dat file for GeoIP City database and the .csv file for Geo City database.
   - If you have a replacement for the current database, and want to use a new one, then either enter the path to the database file into the relevant field, or click the Browse button and locate the file.
   - You can also re-define the units used to measure the distance between a customer host location and the city specified in his/her account profile billing contact. Select the unit from the Units of measurement drop-down menu.
6. To save changes, click the Update button.

Please send us your feedback on this help page