識別子フィールドレベルの暗号化
メールアドレスを暗号化して、Brazeで共有される個人を特定できる情報（PII）を最小限に抑えます。
識別子フィールドレベル暗号化を使用すると、AWS Key Management Service（KMS）でメールアドレスをシームレスに暗号化し、Brazeで共有される個人識別情報（PII）を最小限に抑えることができます。暗号化により、機密データは暗号文（読み取ることができない暗号化された情報）に置き換えられます。
識別子フィールドレベルの暗号化は、アドオン機能として利用できます。識別子フィールドレベルの暗号化を始めるには、Brazeアカウントマネージャーにお問い合わせください。
仕組み
メールアドレスは、Brazeに追加される前にハッシュ化および暗号化される必要があります。メッセージが送信されると、復号化されたメールアドレスを取得するためにAWS KMSへの呼び出しが行われます。次に、ハッシュ化されたメールアドレスが配信およびエンゲージメントイベントのメタデータに挿入され、元のユーザーに紐付けられます。これにより、Brazeはメール分析を追跡できます。Brazeは、含まれているプレーンテキストのメールアドレスを除去し、ユーザーのプレーンテキストのメールアドレスを保存しません。
前提条件
識別子フィールドレベル暗号化を使用するには、AWS KMSにアクセスして、Brazeに送信する前にメールアドレスを暗号化およびハッシュ化する必要があります。
以下の手順に従って、AWSシークレットキー認証方法を設定してください。
- アクセスキーIDとシークレットアクセスキーを取得するには、AWS Key Management Serviceの権限ポリシーを持つIAMユーザーと管理者グループを作成します。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 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フィールドには、メールのハッシュ化された値を指定する必要があります。email_encryptedフィールドには、メールの暗号化された値を指定する必要があります。
よくある質問
暗号化とハッシュ化の違いは何ですか？
暗号化はデータの暗号化と復号が可能な双方向の機能です。同じ平文の値を複数回暗号化した場合、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メソッドをサポートしています。また、メール本文にワンクリック購読解除リンクを含めることをお勧めします。
識別子フィールドレベル暗号化は電話番号など他の識別子をサポートしていますか？
いいえ。現在、識別子フィールドレベル暗号化はメールアドレスのみでサポートされています。