diff --git a/docs/getting-started/gs-normalization-encoding.md b/docs/getting-started/gs-normalization-encoding.md index bf080fb3f..642d09aad 100644 --- a/docs/getting-started/gs-normalization-encoding.md +++ b/docs/getting-started/gs-normalization-encoding.md @@ -1,15 +1,15 @@ --- -title: Normalization and encoding -description: Learn how to normalize and encode information so it's secure and can be decoded. +title: Normalization, hashing, and encoding +description: Instructions for normalizing, hashing, and encoding email addresses and phone numbers. hide_table_of_contents: false displayed_sidebar: docs --- import Link from '@docusaurus/Link'; -# Normalization and encoding +# Normalization, hashing, and encoding -This page provides information about normalizing and encoding DII. It's important that, in working with UID2, normalizing and encoding are performed correctly. +This page provides information about normalizing, hashing, and encoding DII. It's important that, in working with UID2, normalizing, hashing, and encoding are performed correctly. ## Introduction @@ -53,7 +53,7 @@ Make sure that the normalized email is UTF-8, not another encoding system such a For examples of various scenarios, see [Normalization examples for email](#normalization-examples-for-email). -## Email address hash encoding +## Email address hashing and encoding An email hash is a Base64-encoded SHA-256 hash of a normalized email address. The email address is first normalized, then hashed using the SHA-256 hashing algorithm, and then the resulting bytes of the hash value are encoded using Base64 encoding. Note that the Base64 encoding is applied to the bytes of the hash value, not the hex-encoded string representation. @@ -140,7 +140,7 @@ Here's what you need to know about phone number normalization rules: Make sure that the normalized phone number is UTF-8, not another encoding system such as UTF-16. ::: -## Phone number hash encoding +## Phone number hashing and encoding A phone number hash is a Base64-encoded SHA-256 hash of a normalized phone number. The phone number is first normalized, then hashed using the SHA-256 hashing algorithm, and then the resulting bytes of the hash value are encoded using Base64 encoding. Note that the Base64 encoding is applied to the bytes of the hash value, not the hex-encoded string representation. @@ -213,4 +213,4 @@ If you're having trouble or getting errors, or if you just want to be sure you'r - **Use the Base64-encoded value**: The process includes normalizing, then hashing, then Base64-encoding the bytes of the hash value. When generating UID2s, the input is the Base64-encoded value. Make sure you're using this 44-character string value. -- You might see the following error message: "The hashing value must be 44 characters." In this scenario, there is an error with the hashing function you're using. Use the hex to Base64 encoding of the SHA-256 hash. For details, see [Email address hash encoding](#email-address-hash-encoding) or [Phone number hash encoding](#phone-number-hash-encoding). To cross-check, test using the [UID2 hashing tool](https://hashing-tool.samples.uidapi.com/). \ No newline at end of file +- You might see the following error message: "The hashing value must be 44 characters." In this scenario, there is an error with the hashing function you're using. Use the hex to Base64 encoding of the SHA-256 hash. For details, see [Email address hashing and encoding](#email-address-hash-encoding) or [Phone number hashing and encoding](#phone-number-hash-encoding). To cross-check, test using the [UID2 hashing tool](https://hashing-tool.samples.uidapi.com/). \ No newline at end of file diff --git a/docs/ref-info/ref-preparing-emails-and-phone-numbers-for-processing.md b/docs/ref-info/ref-preparing-emails-and-phone-numbers-for-processing.md index 5d97fd481..56a1ca641 100644 --- a/docs/ref-info/ref-preparing-emails-and-phone-numbers-for-processing.md +++ b/docs/ref-info/ref-preparing-emails-and-phone-numbers-for-processing.md @@ -47,8 +47,8 @@ If you're using a UID2 SDK, or other integration solution such as the Prebid.js Phone Number - Must be one of the following: - [Phone number normalization](../getting-started/gs-normalization-encoding#phone-number-normalization)
[Phone number hash encoding](../getting-started/gs-normalization-encoding#phone-number-hash-encoding) + Must be one of the following: + [Phone number normalization](../getting-started/gs-normalization-encoding#email-address-normalization)
[Phone number hashing and encoding](../getting-started/gs-normalization-encoding#phone-number-hashing-and-encoding) diff --git a/docs/ref-info/updates-doc.md b/docs/ref-info/updates-doc.md index 76746b7ec..60c732167 100644 --- a/docs/ref-info/updates-doc.md +++ b/docs/ref-info/updates-doc.md @@ -805,8 +805,8 @@ We clarified the instructions for normalizing and encoding