@@ -56,7 +56,7 @@ UID2 <Link href="../ref-info/glossary-uid#gl-operator-service">Operator Service<
5656
5757## Email address hash encoding
5858
59- メールアドレスのハッシュは、正規化されたメールアドレスの Base64 エンコードされた <Link href =" ../ref-info/glossary-uid#gl-sha-256 " >SHA-256</Link > ハッシュです。メールアドレスは最初に正規化され、次に SHA-256 ハッシュアルゴリズムを使用してハッシュ化され、最後にハッシュ値のバイトを Base64 エンコードします。Base64 エンコードは、ハッシュ値のバイトに適用され、16進数でエンコードされた文字列表現ではないことに注意してください 。
59+ メールアドレスのハッシュは、正規化されたメールアドレスの Base64 エンコードされた <Link href =" ../ref-info/glossary-uid#gl-sha-256 " >SHA-256</Link > ハッシュです。メールアドレスは最初に正規化され、次に SHA-256 ハッシュアルゴリズムを使用してハッシュ化され、最後にハッシュ値のバイトを Base64 エンコードします。Base64 エンコードは、ハッシュ値のバイトに適用され、16 進数でエンコードされた文字列表現ではないことに注意してください 。
6060
6161以下の表は、シンプルな入力メールアドレスと、各手順を適用して安全で不透明な値に到達する結果を示しています。
6262
@@ -70,8 +70,8 @@ Base64 エンコーディングを適用する際は、ハッシュの生のバ
7070| :--- | :--- | :--- |
7171| 元のメールアドレス | ` USER@example.com ` | N/A |
7272| 正規化されたメールアドレス | ` user@example.com ` | 正規化は常に最初のステップです。 |
73- | 正規化されたメールアドレスの SHA-256 ハッシュ| ` b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514 ` | これは、32 バイトの SHA-256 の16進数エンコードされた表現です 。 |
74- | SHA-256 ハッシュの16進数から Base64 へのエンコード | ` tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ= ` | この 44 文字の文字列は、32 バイトの SHA-256 の Base64 エンコードされた表現です。<br />SHA-256 ハッシュの文字列は、ハッシュ値の 16 進数エンコードされた表現であることに注意してください。ハッシュの生のバイトを Base64 エンコードするか、16 進数エンコードされた値を入力として受け取る Base64 エンコーダーを使用する必要があります。<br />このエンコードをリクエストボディで送信される ` email_hash ` 値に使用します。 |
73+ | 正規化されたメールアドレスの SHA-256 ハッシュ| ` b4c9a289323b21a01c3e940f150eb9b8c542587f1abfd8f0e1cc1ffc5e475514 ` | これは、32 バイトの SHA-256 の 16 進数エンコードされた表現です 。 |
74+ | SHA-256 ハッシュの 16 進数から Base64 へのエンコード | ` tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ= ` | この 44 文字の文字列は、32 バイトの SHA-256 の Base64 エンコードされた表現です。<br />SHA-256 ハッシュの文字列は、ハッシュ値の 16 進数エンコードされた表現であることに注意してください。ハッシュの生のバイトを Base64 エンコードするか、16 進数エンコードされた値を入力として受け取る Base64 エンコーダーを使用する必要があります。<br />このエンコードをリクエストボディで送信される ` email_hash ` 値に使用します。 |
7575
7676その他の例は、[ Normalization examples for email] ( #normalization-examples-for-email ) を参照してください。
7777
@@ -143,22 +143,22 @@ UID2 Operator Service へのリクエストで電話番号を送信する前に
143143
144144## Phone number hash encoding
145145
146- 電話番号のハッシュは、正規化された電話番号の Base64 エンコードされた SHA-256 ハッシュです。電話番号は最初に正規化し、次に SHA-256 ハッシュアルゴリズムを使用してハッシュ化し、最後にハッシュ値のバイトを Base64 エンコードします。Base64 エンコードは、ハッシュ値のバイトに適用され、16進数でエンコードされた文字列表現ではないことに注意してください 。
146+ 電話番号のハッシュは、正規化された電話番号の Base64 エンコードされた SHA-256 ハッシュです。電話番号は最初に正規化し、次に SHA-256 ハッシュアルゴリズムを使用してハッシュ化し、最後にハッシュ値のバイトを Base64 エンコードします。Base64 エンコードは、ハッシュ値のバイトに適用され、16 進数でエンコードされた文字列表現ではないことに注意してください 。
147147
148148以下の表は、単純な入力電話番号の例と、各ステップを適用して安全で不透明な URL-safe な値にする結果を示しています。
149149
150- 最終値、すなわち SHA-256 ハッシュの 16進数から Base64 エンコードされた表現は、UID2 Operator endpoint に提供する値となります。
150+ 最終値、すなわち SHA-256 ハッシュの 16 進数から Base64 エンコードされた表現は、UID2 Operator endpoint に提供する値となります。
151151
152152::: warning
153- Base64 エンコーディングを適用する際は、ハッシュの生のバイト列を Base64 エンコードするか、16進数エンコードされた値を入力として受け取る Base64 エンコーダーを使用してください。テキストを入力として受け取る関数を使用すると、結果として得られる文字列が長くなり、UID2 の目的では無効となります。
153+ Base64 エンコーディングを適用する際は、ハッシュの生のバイト列を Base64 エンコードするか、16 進数エンコードされた値を入力として受け取る Base64 エンコーダーを使用してください。テキストを入力として受け取る関数を使用すると、結果として得られる文字列が長くなり、UID2 の目的では無効となります。
154154:::
155155
156156| Type | Example | Comments and Usage |
157157| :--- | :--- | :--- |
158158| 元の電話番号 | ` 1 (234) 567-8901 ` | N/A |
159159| 正規化された電話番号 | ` +12345678901 ` | 正規化は常に最初のステップです。 |
160- | 正規化された電話番号の SHA-256 ハッシュ | ` 10e6f0b47054a83359477dcb35231db6de5c69fb1816e1a6b98e192de9e5b9ee ` | この 64 文字の文字列は、32 バイト SHA-256 の16進数エンコードされた表現です 。 |
161- | SHA-256 ハッシュの 16進数から Base64 へのエンコード | ` EObwtHBUqDNZR33LNSMdtt5cafsYFuGmuY4ZLenlue4= ` | この 44 文字の文字列は、32 バイト SHA-256 の Base64 エンコードされた表現です。<br />注: SHA-256 ハッシュは16進数の値です。16進数の値を入力として受け取る Base64 エンコーダーを使用する必要があります。このエンコードは、リクエストボディに送信される ` phone_hash ` 値に使用します。 |
160+ | 正規化された電話番号の SHA-256 ハッシュ | ` 10e6f0b47054a83359477dcb35231db6de5c69fb1816e1a6b98e192de9e5b9ee ` | この 64 文字の文字列は、32 バイト SHA-256 の 16 進数エンコードされた表現です 。 |
161+ | SHA-256 ハッシュの 16 進数から Base64 へのエンコード | ` EObwtHBUqDNZR33LNSMdtt5cafsYFuGmuY4ZLenlue4= ` | この 44 文字の文字列は、32 バイト SHA-256 の Base64 エンコードされた表現です。<br />注: SHA-256 ハッシュは 16 進数の値です。16 進数の値を入力として受け取る Base64 エンコーダーを使用する必要があります。このエンコードは、リクエストボディに送信される ` phone_hash ` 値に使用します。 |
162162
163163## Example code
164164
@@ -214,4 +214,4 @@ Email または Phone Number を選択し、値を入力または貼り付けて
214214
215215- ** Use the Base64-encoded value** : このプロセスには、ハッシュ値のバイト列を正規化、ハッシュ化、Base64 エンコードする手順が含まれます。UID2 を生成する際の入力は、この Base64 エンコードされた値です。必ずこの 44 文字の文字列値を使用してください。
216216
217- - 以下のエラーメッセージが表示される場合があります:「The hashing value must be 44 characters. (ハッシュ値は44文字でなければなりません )」。この場合、使用しているハッシュ関数に問題があります。SHA-256 ハッシュの 16 進数から Base64 へのエンコードを使用してください。詳細は[ Email address hash encoding] ( #email-address-hash-encoding ) または[ Phone number hash encoding] ( #phone-number-hash-encoding ) を参照してください。確認のため、[ UID2 hashing tool] ( https://hashing-tool.samples.uidapi.com/ ) でテストしてください。
217+ - 以下のエラーメッセージが表示される場合があります:「The hashing value must be 44 characters. (ハッシュ値は 44 文字でなければなりません )」。この場合、使用しているハッシュ関数に問題があります。SHA-256 ハッシュの 16 進数から Base64 へのエンコードを使用してください。詳細は[ Email address hash encoding] ( #email-address-hash-encoding ) または[ Phone number hash encoding] ( #phone-number-hash-encoding ) を参照してください。確認のため、[ UID2 hashing tool] ( https://hashing-tool.samples.uidapi.com/ ) でテストしてください。
0 commit comments