IP address hashing

Last updated Tuesday, December 5, 2017 in Sitecore Experience Platform for Administrator, Developer
Keywords: Configuration, Contacts, xDB

All contact IP addresses are hashed when they are saved to the xDB database. There are two settings in the Sitecore.Analytics.config file that specify how the IP addresses are stored:

Setting

Description

Analytics.RedactIpAddress

If true, all IP addresses are stored as 0.0.0.0 in xDB and all IP address identification is lost. Therefore, it is not possible to connect a contact record in the database with a real, physical person by using the IP address. Contact identification still works.

The default setting is false.

Sitecore.Analytics.Lookups.IpHashProvider

This provider is always used. It hashes IP addresses using the MD5 hash algorithm. The setting contains the salt parameter used by the hashing provider. For security reasons, it is best practice that you specify at least six characters for the salt parameter. When you have specified a value, do not change this value again. If you do, visits from an IP address that is already stored as a hash will not be recognized and will be stored with a different hashed value.

Note

Sitecore provides a tool called Hash Stored IPs. You use this tool when upgrading from a version earlier than Sitecore 8.1, where IP addresses were not hashed.

 

 

Send feedback about the documentation to docsite@sitecore.net.