Chiffrement au niveau du champ de l’identifiant

Chiffrez les adresses e-mail afin de minimiser les informations personnelles identifiables (PII) partagées dans Braze.

Grâce au chiffrement au niveau du champ d’identifiant, vous pouvez chiffrer de façon fluide les adresses e-mail avec AWS Key Management Service (KMS) afin de minimiser les informations personnelles identifiables (PII) partagées dans Braze. Le chiffrement remplace les données sensibles par du texte chiffré, c’est-à-dire des informations chiffrées illisibles.

Important

Le chiffrement au niveau du champ de l’identifiant est disponible en tant que fonctionnalité supplémentaire. Pour commencer à utiliser le chiffrement au niveau du champ de l’identifiant, contactez votre gestionnaire de compte Braze.

Fonctionnement

Les adresses e-mail doivent être hachées et chiffrées avant d’être ajoutées à Braze. Lors de l’envoi d’un message, un appel est effectué vers AWS KMS pour obtenir l’adresse e-mail déchiffrée. L’adresse e-mail hachée est ensuite insérée dans les métadonnées afin que les événements de réception et d’engagement soient associés à l’utilisateur d’origine. C’est ainsi que Braze peut suivre l’analyse des e-mails. Braze masque toute adresse e-mail en texte brut incluse et ne stocke pas l’adresse e-mail en texte brut de l’utilisateur.

Conditions préalables

Pour utiliser le chiffrement au niveau des champs d’identifiant, vous devez avoir accès à AWS KMS afin de chiffrer et de hacher les adresses e-mail avant de les envoyer à Braze.

Suivez ces étapes pour configurer votre méthode d’authentification par clé secrète AWS.

1. Pour récupérer votre ID de clé d’accès et votre clé d’accès secrète, créez un utilisateur IAM et un groupe d’administrateurs dans AWS avec une politique d’autorisations pour AWS Key Management Service. L’utilisateur IAM doit disposer des autorisations kms:Decrypt et kms:GenerateMac. Pour plus de détails, consultez Autorisations AWS KMS.
2. Sélectionnez Afficher les informations d’identification de sécurité de l’utilisateur pour faire apparaître votre ID de clé d’accès et votre clé d’accès secrète. Notez ces informations d’identification quelque part ou sélectionnez le bouton Télécharger les informations d’identification, car vous devrez les saisir lors de la connexion de vos clés AWS KMS.
3. Vous devez configurer KMS dans les régions AWS suivantes :
   • Clusters américains de Braze : us-east-1
   • Clusters européens de Braze : eu-central-1
   • Cluster australien de Braze : ap-southeast-2
   • Cluster indonésien de Braze : ap-southeast-3
   • Cluster japonais de Braze : ap-northeast-1
   • Cluster coréen de Braze : ap-northeast-2
4. Dans AWS Key Management Service, créez deux clés et assurez-vous que l’utilisateur IAM est ajouté dans les autorisations d’utilisation des clés :
   • Chiffrement/déchiffrement : Sélectionnez le type de clé Symétrique et l’utilisation de clé Chiffrer et déchiffrer.
   • Hachage : Sélectionnez le type de clé Symétrique et l’utilisation de clé Générer et vérifier un MAC. La spécification de clé doit être HMAC_256. Après avoir créé la clé, notez l’ID de la clé HMAC quelque part, car vous devrez le saisir dans Braze.

Étape 1 : Connectez vos clés AWS KMS

Dans le tableau de bord de Braze, accédez à Paramètres des données > Chiffrement au niveau du champ. Pour vos paramètres AWS KMS, saisissez les informations suivantes :

• ID de la clé d’accès
• Clé d’accès secrète
• Identifiant de la clé HMAC (ID de clé ou ARN de clé ; il ne peut plus être modifié après l’enregistrement)

Étape 2 : Sélectionnez vos champs chiffrés

Ensuite, sélectionnez Adresse e-mail pour chiffrer ce champ.

Une fois le chiffrement activé pour un champ, il est impossible de revenir à un champ non chiffré : le chiffrement est un paramètre définitif. Lorsque vous configurez le chiffrement de l’adresse e-mail, vérifiez qu’aucun utilisateur ne possède d’adresse e-mail dans l’espace de travail. Vous vous assurez ainsi qu’aucune adresse e-mail en clair n’est stockée dans Braze lorsque vous activez la fonctionnalité pour l’espace de travail.

Étape 3 : Importer et mettre à jour les utilisateurs

Lorsque le chiffrement au niveau des champs d’identifiant est activé, vous devez hacher et chiffrer l’adresse e-mail avant de l’ajouter à Braze. Veillez à convertir l’adresse e-mail en minuscules avant de la hacher. Pour plus de détails, consultez la section Objet des attributs utilisateur.

Lorsque vous mettez à jour une adresse e-mail dans Braze, utilisez la valeur hachée de l’e-mail partout où email est inclus. Cela concerne :

• Les endpoints REST :
  • /users/track
  • /campaigns/trigger/send
  • /canvas/trigger/send
  • /transactional/v1/campaigns/{campaign_id}/send
• L’ajout ou la mise à jour d’utilisateurs par CSV

Remarque

Lorsque vous créez un nouvel utilisateur avec une adresse e-mail, vous devez ajouter email_encrypted avec la valeur chiffrée de l’e-mail de l’utilisateur. Sinon, l’utilisateur ne sera pas créé. De même, si vous ajoutez une adresse e-mail à un utilisateur existant qui n’en possède pas, vous devez ajouter email_encrypted. Sinon, l’utilisateur ne sera pas mis à jour.

Considérations

Ces fonctionnalités ne sont pas prises en charge avec le chiffrement des identifiants au niveau des champs :

• Identification et capture de l’adresse e-mail via le SDK
• Formulaires de capture d’e-mail dans les messages in-app
• Rapports sur le domaine du destinataire, y compris les graphiques des fournisseurs de messagerie dans Email Insights
• Filtre d’adresse e-mail par expression régulière
• Synchronisation des audiences
• Intégration Shopify

Objet des attributs utilisateur

Lorsque vous utilisez le chiffrement des identifiants au niveau des champs avec l’endpoint /users/track, tenez compte des précisions suivantes sur les champs de l’objet des attributs utilisateur :

• Le champ email doit contenir la valeur hachée de l’e-mail, encodée en Base64.
• Le champ email_encrypted doit contenir la valeur chiffrée de l’e-mail, encodée en Base64.

Foire aux questions

Quelle est la différence entre le chiffrement et le hachage ?

Le chiffrement est une fonction bidirectionnelle qui permet de chiffrer et de déchiffrer des données. Si la même valeur en texte clair est chiffrée plusieurs fois, l’algorithme de chiffrement d’AWS (AES-256-GCM) produit des valeurs chiffrées différentes. Le hachage est une fonction unidirectionnelle : le texte clair est brouillé de façon à ne pas pouvoir être déchiffré. Le hachage produit la même valeur à chaque fois. Cela nous permet de conserver les états d’abonnement de plusieurs utilisateurs qui partagent la même adresse e-mail.

Quelle adresse e-mail dois-je utiliser pour mon envoi de test ?

Les adresses e-mail en texte clair sont prises en charge pour les envois de test. Pour voir à quoi ressemble un e-mail pour un utilisateur spécifique, procédez comme suit :

1. Sélectionnez Prévisualiser le message en tant qu’utilisateur.
2. Dans Envoi de test, sélectionnez Remplacer les attributs des destinataires par les attributs de l’utilisateur actuellement prévisualisé.

Puis-je utiliser un ARN pour la clé HMAC ?

Oui. Dans Paramètres des données > Chiffrement au niveau du champ, l’identifiant de la clé HMAC accepte soit un ID de clé, soit un ARN de clé.

Comment supprimer ou réinitialiser une clé HMAC ?

Vous ne pouvez pas supprimer ni réinitialiser une clé HMAC dans le tableau de bord après l’avoir enregistrée. Pour demander la réinitialisation d’une clé HMAC, ou la suppression de la configuration du chiffrement au niveau du champ de l’identifiant, contactez votre gestionnaire de compte Braze ou ouvrez un ticket d’assistance.

Que se passe-t-il si j’ajoute le Liquid d’adresse e-mail {{${email_address}}} dans Braze ?

Braze affichera l’adresse e-mail en texte clair lors de l’envoi de l’e-mail. Dans les aperçus, nous afficherons la version chiffrée de l’e-mail. Nous vous recommandons d’utiliser l’ID externe de l’utilisateur si vous faites référence à un utilisateur dans une URL personnalisée en un clic.

{{${email_address}}} n’est actuellement pas pris en charge dans le centre de préférences ni dans les pages de désabonnement.

Quelle adresse e-mail dois-je m’attendre à voir dans Currents ?

L’adresse e-mail hachée est incluse dans les événements de distribution et d’engagement des e-mails.

Quelle adresse e-mail dois-je m’attendre à voir dans l’archivage des messages ?

L’adresse e-mail en texte clair est incluse dans l’archivage des messages. Ces messages sont envoyés directement au fournisseur de stockage cloud du client, et le corps des e-mails peut contenir d’autres données personnelles.

Puis-je utiliser le list-unsubscribe par mailto pour la gestion des abonnements avec le chiffrement au niveau du champ de l’identifiant ?

Non. Le list-unsubscribe par mailto enverrait l’adresse e-mail déchiffrée en texte clair à Braze. Lorsque le chiffrement au niveau du champ de l’identifiant est activé, nous prenons en charge la méthode HTTP: basée sur une URL, y compris le désabonnement en un clic. Nous vous recommandons également d’inclure un lien de désabonnement en un clic dans le corps de votre e-mail.

Le chiffrement au niveau du champ de l’identifiant prend-il en charge d’autres identifiants, comme le numéro de téléphone ?

Non. Actuellement, le chiffrement au niveau du champ de l’identifiant n’est pris en charge que pour les adresses e-mail.