識別子フィールドレベルの暗号化
メールアドレスを暗号化して、Brazeで共有される個人を特定できる情報（PII）を最小限に抑えます。
識別子フィールドレベル暗号化を使用すると、AWS Key Management Service（KMS）でメールアドレスをシームレスに暗号化し、Brazeで共有される個人識別情報（PII）を最小限に抑えることができます。暗号化により、機密データは暗号文（読み取ることができない暗号化された情報）に置き換えられます。
識別子フィールドレベルの暗号化は、アドオン機能として利用できます。識別子フィールドレベルの暗号化を始めるには、Brazeアカウントマネージャーにお問い合わせください。
仕組み
メールアドレスは、Braze に追加する前にハッシュ化と暗号化を行う必要があります。メッセージが送信されると、復号化されたメールアドレスを取得するために AWS KMS が呼び出されます。次に、ハッシュ化されたメールアドレスが配信イベントとエンゲージメントイベントのメタデータに挿入され、元のユーザーに紐付けられます。この仕組みにより、Braze はメール分析をトラッキングできます。Braze は含まれている平文のメールアドレスをすべて編集して削除し、ユーザーの平文のメールアドレスを保存することはありません。
前提条件
識別子フィールドレベルの暗号化を使用するには、メールアドレスをBrazeに送信する前に、AWS KMSにアクセスしてメールアドレスを暗号化およびハッシュ化できる必要があります。
AWSシークレットキー認証方法を設定するには、次のステップに従います。
- アクセスキーIDとシークレットアクセスキーを取得するには、AWS Key Management Serviceの権限ポリシーを持つIAMユーザーと管理者グループをAWSで作成します。IAMユーザーにはkms:Decryptおよびkms:GenerateMacの権限が必要です。詳細については、AWS KMSの権限を参照してください。
- Show User Security Credentialsを選択して、アクセスキーIDとシークレットアクセスキーを表示します。AWS KMSキーを接続する際にこれらの認証情報を入力する必要があるため、どこかに書き留めておくか、Download Credentialsボタンを選択してください。
- 次のAWSリージョンでKMSを設定する必要があります。
- Braze USクラスター:
us-east-1 - Braze EUクラスター:
eu-central-1 - Braze AUクラスター:
ap-southeast-2 - Braze IDクラスター:
ap-southeast-3 - Braze JPクラスター:
ap-northeast-1 - Braze KRクラスター:
ap-northeast-2
- Braze USクラスター:
- AWS Key Management Serviceで2つのキーを作成し、キーの使用権限にIAMユーザーが追加されていることを確認します。
ステップ1:AWS KMSキーを接続する
Brazeダッシュボードで、データ設定 > フィールドレベルの暗号化に移動します。AWS KMSの設定で、以下を入力します。
- アクセスキーID
- シークレットアクセスキー
- HMACキー識別子(キーIDまたはキーARN。保存後は更新できません)
ステップ 2: 暗号化するフィールドを選択する
次に、メールアドレスを選択してフィールドを暗号化します。
フィールドの暗号化をオンにすると、そのフィールドを復号化された状態に戻すことはできません。つまり、暗号化は永続的な設定です。メールアドレスの暗号化を設定する際は、ワークスペース内にメールアドレスを持つユーザーがいないことを確認してください。これにより、ワークスペースでこの機能をオンにしたときに、平文のメールアドレスが Braze に保存されないようになります。
ステップ 3: ユーザーのインポートと更新
識別子のフィールドレベル暗号化を有効にしている場合は、Braze に追加する前にメールアドレスをハッシュ化して暗号化する必要があります。ハッシュ化する前に、必ずメールアドレスを小文字に変換してください。詳細については、ユーザー属性オブジェクトを参照してください。
Braze でメールアドレスを更新する際は、email が含まれるすべての箇所でハッシュ化されたメールの値を使用してください。対象は次のとおりです。
- REST エンドポイント:
/users/track/campaigns/trigger/send/canvas/trigger/send/transactional/v1/campaigns/{campaign_id}/send
- CSV によるユーザーの追加または更新
メールアドレスを持つ新規ユーザーを作成する場合は、ユーザーの暗号化されたメールの値とともに email_encrypted を追加する必要があります。追加しないと、ユーザーは作成されません。同様に、メールアドレスを持たない既存ユーザーにメールアドレスを追加する場合も、email_encrypted を追加する必要があります。追加しないと、ユーザーは更新されません。
考慮事項
以下の機能は、識別子フィールドレベルの暗号化ではサポートされていません。
- SDK によるメールアドレスの識別と取得
- アプリ内メッセージのメール取得フォーム
- 受信者ドメインに関するレポート (メールインサイトのメールボックスプロバイダーチャートを含む)
- 正規表現によるメールアドレスのフィルター
- オーディエンス同期
- Shopify 統合
ユーザー属性オブジェクト
/users/track エンドポイントで識別子フィールドレベルの暗号化を使用する場合は、ユーザー属性オブジェクトの以下のフィールドの詳細に注意してください。
emailフィールドには、メールアドレスのハッシュ値を Base64 エンコードした値を指定する必要があります。email_encryptedフィールドには、メールアドレスの暗号化された値を Base64 エンコードした値を指定する必要があります。
よくある質問
暗号化とハッシュ化の違いは何ですか？
暗号化は双方向の関数で、データの暗号化と復号の両方が可能です。同じプレーンテキストの値を複数回暗号化すると、AWS の暗号化アルゴリズム (AES-256-GCM) は毎回異なる暗号化値を生成します。ハッシュ化は一方向の関数で、プレーンテキストを復号できない形にスクランブルします。ハッシュ化は毎回同じ値を生成します。これにより、同じメールアドレスを共有する複数のユーザー間で購読状態を維持できます。
テスト送信にはどのメールアドレスを使用すればよいですか？
テスト送信ではプレーンテキストのメールアドレスがサポートされています。特定のユーザーに対してメールがどのように表示されるかを確認するには、次の手順を実行します。
- ユーザーとしてメッセージをプレビューを選択します。
- テスト送信で、受信者の属性を現在のプレビューユーザーの属性で上書きするを選択します。
HMAC キーに ARN を使用できますか？
はい。データ設定 > フィールドレベルの暗号化で、HMAC キー識別子にはキー ID またはキー ARN のいずれかを指定できます。
HMAC キーを削除またはリセットするにはどうすればよいですか？
HMAC キーを保存した後は、ダッシュボードで削除またはリセットすることはできません。HMAC キーのリセット、または識別子フィールドレベルの暗号化設定の削除をリクエストするには、Braze のアカウントマネージャーに連絡するか、サポートチケットを作成してください。
Braze でメールアドレスの Liquid {{${email_address}}} を追加するとどうなりますか？
Braze はメールの送信時にプレーンテキストのメールアドレスをレンダリングします。プレビューでは、暗号化されたバージョンのメールアドレスが表示されます。カスタムのワンクリック URL でユーザーを参照する場合は、ユーザーの external ID を使用することをお勧めします。
{{${email_address}}} は現在、ユーザー設定センターおよび購読解除ページではサポートされていません。
Currents ではどのメールアドレスが表示されますか？
メールの配信イベントおよびエンゲージメントイベントには、ハッシュ化されたメールアドレスが含まれます。
メッセージアーカイブではどのメールアドレスが表示されますか？
メッセージアーカイブにはプレーンテキストのメールアドレスが含まれます。これらは顧客のクラウドストレージプロバイダーに直接送信され、メール本文にはその他の個人データが含まれている場合があります。
識別子フィールドレベルの暗号化を使用している場合、購読管理に mail-to の list-unsubscribe を使用できますか？
いいえ。mail-to の list-unsubscribe を使用すると、復号されたプレーンテキストのメールアドレスが Braze に送信されます。識別子フィールドレベルの暗号化を有効にしている場合は、ワンクリックを含む URL ベースの HTTP: メソッドがサポートされます。また、メール本文にワンクリックの購読解除リンクを含めることもお勧めします。
識別子フィールドレベルの暗号化は、電話番号などの他の識別子をサポートしていますか？
いいえ。現在、識別子フィールドレベルの暗号化はメールアドレスのみをサポートしています。