The Sitecore IP Geolocation service provides information about the location and owner of an IP address beyond that provided by a reverse DNS lookup. IP Geolocation information includes the country, state, city, and the registered company name of every visitor.
You can use IP Geolocation lookups to create conditional renderings or personalization rules that show different content, based on the visitor's location.
This topic describes:
- System requirements
- Activate the Sitecore IP Geolocation service
- Subscribe to the Sitecore IP Geolocation Service
- Configure a firewall
- Using a proxy server
The Sitecore IP Geolocation module is fully compatible with Sitecore Experience Management (CMS-only mode).
Activate the Sitecore IP Geolocation service
To activate the Sitecore IP Geolocation Service on Sitecore XP
Your IP Geolocation service subscription is connected to your unique Sitecore License ID. This means that if you update your license ID (for example, when you use a new license.xml), you must reactivate your IP Geolocation subscription.
Subscribe to the Sitecore IP Geolocation Service
- On the Sitecore Launchpad, click App Center and log in.
- Click Sitecore IP Geolocation Service.
- Click Continue to proceed with your sign-up and see the summary of your subscription.
- Click Confirm to view the Sitecore IP Geolocation Terms of Service.
- Select I accept the terms and conditions checkbox and confirm your subscription.
Now your subscription is complete and you can view your subscription details.
After you have activated your subscription, it may take some time for the system to update the license information. When the system has updated, the Sitecore IP Geolocation service will automatically conduct geolocation lookups.
Configure a firewall
It is common to have a firewall set up between your content management and content delivery servers. To ensure that the Sitecore IP Geolocation service works correctly in all scenarios, you must configure your firewall settings to allow requests to the service.
Add a firewall rule to allow HTTPS protocol for:
Using a proxy server
For requests coming from a reverse proxy server to your Sitecore instance, that should be tracked as the valid IP addresses of a client, and not as the IP addresses of a proxy, use the following setting:
Analytics.ForwardedRequestHttpHeadersetting to the value: X-Forwarded-For