Set up Sitecore IP Geolocation

Version: 10.2

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.

Set up system requirements

The Sitecore IP Geolocation module is fully compatible with Sitecore Experience Manager (CMS-only mode).

Activate the Sitecore IP Geolocation service

To activate the Sitecore IP Geolocation Service on Sitecore XP, you must subscribe to the Sitecore IP Geolocation service through the Sitecore Support portal. The Sitecore IP Geolocation service is free of charge and with unlimited lookups per month.

In the \App_Config\Sitecore\ DetectionServices.Location\ Sitecore.CES.GeoIp.configfile, set the the GeoIp.PerformLookup property to true on every CD instance.

Subscribe to the Sitecore IP Geolocation Service

After activating the Sitecore IP Geolocation service, you must go to the Sitecore Support & Self Service portal and sign up for a subscription.

  1. Go to the Sitecore Support & Self-Service Portal, and click Create Service Requests.

    Note

    The number of widgets that you see in the portal depends on your permission level.

    The Self-Service portal
  2. In the Catalogs field, select the IP Geolocation catalog and then in the Categories field, select the Operational Services category.

    Select an agreement
  3. In the IP Geolocation Agreement dialog, enter your account and contract details.

    Enter account and contract
  4. To confirm your subscription, accept the Sitecore® IP Geolocation Terms of Service.

    Read Terms of Service

Now your subscription is complete.

Note

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.

To configure a firewall:

  • Add a firewall rule to allow HTTPS protocol for:

    • geoIp-ces.cloud.sitecore.net

    • Discovery-ces.cloud.sitecore.net

Use a proxy server

When requests come from a reverse proxy server to your Sitecore instance that you want to track as the valid IP addresses of a client (not as the IP addresses of a proxy), in the \App_Config\Sitecore\DetectionServices.Location\Sitecore.CES.GeoIp.config file, change the value of the CES.GeoIp.ForwardedRequestHttpHeader setting to X-Forwarded-For.

Do you have some feedback for us?

If you have suggestions for improving this article,