Skip to content

Amazon S3

Amazon S3 est un système de stockage hautement évolutif proposé par Amazon Web Services.

L’intégration de Braze et d’Amazon S3 propose deux stratégies d’intégration :

  • Tirez parti de Currents, qui vous permet d’y stocker des données jusqu’à ce que vous souhaitiez les connecter à d’autres plateformes, outils et emplacements.
  • Utilisez les exportations de données du tableau de bord (telles que les exportations CSV et les rapports d’engagement).

Prérequis

Créer un nouveau compartiment S3

Pour créer un compartiment pour votre application, procédez comme suit :

  1. Ouvrez la console Amazon S3 et suivez les instructions pour vous connecter ou créer un compte AWS.
  2. Une fois connecté, sélectionnez S3 dans la catégorie Storage & Content Delivery.
  3. Sélectionnez Create Bucket sur l’écran suivant.
  4. Lorsque vous y êtes invité, créez votre compartiment et sélectionnez une région AWS.

Braze ne vous permet pas de choisir ou de configurer une région dans le tableau de bord. La région AWS est déterminée par l’endroit où vous créez le compartiment dans la console AWS. L’intégration envoie les données au nom de compartiment que vous fournissez, et AWS achemine automatiquement les requêtes vers la région du compartiment. Si votre connecteur tente de se connecter à une région différente de celle souhaitée (par exemple, eu-west-1 au lieu de eu-central-1), créez ou utilisez un compartiment S3 dans la région souhaitée dans AWS. Il n’y a rien à modifier du côté de Braze.

Intégration

Braze propose deux stratégies d’intégration différentes avec Amazon S3 : l’une pour Braze Currents et l’autre pour toutes les exportations de données du tableau de bord (telles que les exportations CSV ou les rapports d’engagement). Les deux intégrations prennent en charge deux méthodes d’authentification ou d’autorisation différentes :

Méthode d’authentification par clé secrète AWS

Cette méthode d’authentification génère une clé secrète et un ID de clé d’accès qui permettent à Braze de s’authentifier en tant qu’utilisateur sur votre compte AWS pour écrire des données dans votre compartiment.

Étape 1 : Créer un utilisateur

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.

Étape 2 : Obtenir les identifiants

Après avoir créé un nouvel utilisateur, sélectionnez Show User Security Credentials pour révéler votre ID de clé d’accès et votre clé d’accès secrète. Ensuite, notez ces identifiants quelque part ou sélectionnez le bouton Download Credentials, car vous devrez les saisir ultérieurement dans le tableau de bord de Braze.

Page des identifiants de sécurité de l'utilisateur AWS IAM affichant l'ID de clé d'accès et la clé d'accès secrète.

Étape 3 : Créer une politique

Accédez à Policies > Get Started > Create Policy pour ajouter des autorisations à votre utilisateur. Ensuite, sélectionnez Create Your Own Policy. Cela accorde des autorisations limitées, de sorte que Braze ne puisse accéder qu’aux compartiments spécifiés.

Écran de création de politique AWS IAM avec les options de politique pour l'intégration S3.

Spécifiez un nom de politique de votre choix et saisissez l’extrait de code suivant dans la section Policy Document. Veillez à remplacer INSERTBUCKETNAME par le nom de votre compartiment. Sans ces autorisations, l’intégration échoue lors de la vérification des identifiants et ne sera pas créée.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": ["s3:ListBucket", "s3:GetBucketLocation"],
            "Resource": ["arn:aws:s3:::INSERTBUCKETNAME"]
        },
        {
            "Effect": "Allow",
            "Action": ["s3:PutObject", "s3:GetObject"],
            "Resource": ["arn:aws:s3:::INSERTBUCKETNAME/*"]
        }
    ]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": ["s3:ListBucket", "s3:GetBucketLocation"],
            "Resource": ["arn:aws:s3:::INSERTBUCKETNAME"]
        },
        {
            "Effect": "Allow",
            "Action": ["s3:GetObject", "s3:PutObject", "s3:DeleteObject"],
            "Resource": ["arn:aws:s3:::INSERTBUCKETNAME*", "arn:aws:s3:::INSERTBUCKETNAME/", "arn:aws:s3:::INSERTBUCKETNAME"]
        }
    ]
}

Étape 4 : Attacher la politique

Après avoir créé une nouvelle politique, accédez à Users et sélectionnez votre utilisateur spécifique. Dans l’onglet Permissions, sélectionnez Attach Policy, puis sélectionnez la nouvelle politique que vous avez créée. Vous êtes maintenant prêt à lier vos identifiants AWS à votre compte Braze.

Onglet des autorisations de l'utilisateur AWS IAM avec l'action Attach Policy sélectionnée.

Étape 5 : Lier Braze à AWS

Dans Braze, accédez à Partner Integrations > Currents.

Ensuite, sélectionnez Create New Current puis Amazon S3 Data Export.

Nommez votre Current. Dans la section Credentials, assurez-vous que AWS Secret Access Key est sélectionné, puis saisissez votre ID d’accès S3, votre clé d’accès secrète AWS et le nom de votre compartiment AWS S3 dans les champs prévus.

Indiquez une adresse e-mail de contact pour les notifications d’erreurs d’intégration. Braze envoie des notifications à cette adresse si l’intégration rencontre des erreurs, telles que des problèmes d’identifiants ou de connectivité. Pour vous assurer que les bonnes personnes reçoivent les alertes, utilisez une liste de distribution ou une adresse e-mail de groupe.

Formulaire de création d'un nouveau Current dans Braze pour Amazon S3 avec les champs d'identifiants de clé secrète AWS.

Vous pouvez également ajouter les personnalisations suivantes selon vos besoins :

  • Folder Path : La valeur par défaut est currents. Si ce dossier n’existe pas, Braze en crée automatiquement un pour vous.
  • Server-Side, At-Rest AES-256 Encryption : Désactivé par défaut et inclut l’en-tête x-amz-server-side-encryption.

Sélectionnez Launch Current pour continuer.

Une notification vous informe si vos identifiants ont été validés avec succès. AWS S3 est maintenant configuré pour Braze Currents.

Dans Braze, accédez à Partner Integrations > Technology Partners et sélectionnez Amazon S3.

Sur la page AWS Credentials, assurez-vous que AWS Secret Access Key est sélectionné, puis saisissez votre ID d’accès AWS, votre clé d’accès secrète AWS et le nom de votre compartiment AWS S3 dans les champs prévus. Lors de la saisie de votre clé secrète, sélectionnez d’abord Test Credentials pour vous assurer que vos identifiants fonctionnent, puis sélectionnez Save en cas de succès.

Page des identifiants du partenaire technologique Amazon S3 dans Braze avec les actions de test et d'enregistrement.

Une notification vous informe si vos identifiants ont été validés avec succès. AWS S3 est maintenant intégré à votre compte Braze.

Méthode d’authentification par ARN de rôle AWS

Cette méthode d’authentification génère un Amazon Resource Name (ARN) de rôle qui permet au compte Amazon de Braze de s’authentifier en tant que membre du rôle que vous avez créé pour écrire des données dans votre compartiment.

Étape 1 : Créer une politique

Pour commencer, connectez-vous à la console de gestion AWS en tant qu’administrateur de compte. Accédez à la section IAM de la console AWS, sélectionnez Policies dans la barre de navigation, puis sélectionnez Create Policy.

Page des politiques IAM AWS avec le bouton Create Policy sélectionné.

Ouvrez l’onglet JSON et saisissez l’extrait de code suivant dans la section Policy Document. Veillez à remplacer INSERTBUCKETNAME par le nom de votre compartiment. Sélectionnez Review Policy lorsque vous avez terminé.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": ["s3:ListBucket", "s3:GetBucketLocation"],
            "Resource": ["arn:aws:s3:::INSERTBUCKETNAME"]
        },
        {
            "Effect": "Allow",
            "Action": ["s3:PutObject", "s3:GetObject"],
            "Resource": ["arn:aws:s3:::INSERTBUCKETNAME/*"]
        }
    ]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": ["s3:ListBucket", "s3:GetBucketLocation"],
            "Resource": ["arn:aws:s3:::INSERTBUCKETNAME"]
        },
        {
            "Effect": "Allow",
            "Action": ["s3:PutObject", "s3:GetObject","s3:DeleteObject"],
            "Resource": ["arn:aws:s3:::INSERTBUCKETNAME/*"]
        }
    ]
}

Ensuite, donnez un nom et une description à la politique, puis sélectionnez Create Policy.

Étape de révision de la politique IAM AWS avec les champs pour le nom et la description de la politique.

Liste des politiques IAM AWS montrant la politique S3 nouvellement créée.

Étape 2 : Créer un rôle

Dans la même section IAM de la console, sélectionnez Roles > Create Role.

Page des rôles IAM AWS avec le bouton Create Role sélectionné.

Récupérez l’ID de compte Braze et l’ID externe depuis votre compte Braze :

  • Currents : Dans Braze, accédez à Partner Integrations > Currents. Ensuite, sélectionnez Create New Current puis Amazon S3 Data Export. Vous y trouverez les identifiants nécessaires à la création de votre rôle.
  • Exportation de données du tableau de bord : Dans Braze, accédez à Partner Integrations > Technology Partners et sélectionnez Amazon S3. Vous y trouverez les identifiants nécessaires à la création de votre rôle. (Créez vos rôles ici si vous configurez uniquement l’archivage des messages.)

De retour sur la console AWS, sélectionnez Another AWS Account comme type de sélecteur d’entité de confiance. Fournissez votre ID de compte Braze, cochez la case Require external ID et saisissez l’ID externe Braze. Sélectionnez Next lorsque vous avez terminé.

La page S3 « Create Role ». Cette page contient des champs pour le nom du rôle, la description du rôle, les entités de confiance, les politiques et la limite de permissions.

Étape 3 : Attacher la politique

Ensuite, attachez la politique que vous avez créée précédemment au rôle. Recherchez la politique dans la barre de recherche et cochez la case à côté de la politique pour l’attacher. Sélectionnez Next lorsque vous avez terminé.

ARN de rôle

Donnez un nom et une description au rôle, puis sélectionnez Create Role.

ARN de rôle

Votre rôle nouvellement créé apparaît désormais dans la liste.

Étape 4 : Lier à Braze AWS

Dans la console AWS, trouvez votre rôle nouvellement créé dans la liste. Sélectionnez le nom pour ouvrir les détails de ce rôle.

Page de détails du rôle IAM AWS pour le rôle nouvellement créé.

Notez le Role ARN en haut de la page de résumé du rôle.

Résumé du rôle IAM AWS montrant la valeur du Role ARN.

Retournez dans votre compte Braze et copiez l’ARN du rôle dans le champ prévu à cet effet.

Dans Braze, accédez à Partner Integrations > Currents. Ensuite, sélectionnez Create New Current et sélectionnez Amazon S3 Data Export.

Écran de configuration Amazon S3 de Braze Currents avec les champs AWS Role ARN et compartiment.

Donnez un nom à votre Current. Ensuite, dans la section Credentials, assurez-vous que AWS Role ARN est sélectionné, puis fournissez votre ARN de rôle et le nom du compartiment AWS S3 dans les champs désignés.

Indiquez une adresse e-mail de contact pour les notifications d’erreurs d’intégration. Braze envoie des notifications à cette adresse si l’intégration rencontre des erreurs, telles que des problèmes d’identifiants ou de connectivité. Pour vous assurer que les bonnes personnes reçoivent les alertes, utilisez une liste de distribution ou une adresse e-mail de groupe.

Vous pouvez également ajouter les personnalisations suivantes selon vos besoins :

  • Chemin du dossier (par défaut currents)
  • Chiffrement AES-256 côté serveur au repos (désactivé par défaut) - Inclut l’en-tête x-amz-server-side-encryption

Sélectionnez Launch Current pour continuer. Une notification indique si vos identifiants ont été validés avec succès. AWS S3 est maintenant configuré pour Braze Currents.

Dans Braze, accédez à la page Technology Partners sous Integrations et sélectionnez Amazon S3.

Page du partenaire technologique Amazon S3 de Braze avec les identifiants AWS Role ARN sélectionnés.

Sur la page AWS Credentials, assurez-vous que le bouton radio AWS Role ARN est sélectionné, puis saisissez votre ARN de rôle et le nom du compartiment AWS S3 dans les champs désignés. Sélectionnez d’abord Test Credentials pour confirmer que vos identifiants fonctionnent correctement, puis sélectionnez Save en cas de succès.

Une notification vous informe si vos identifiants ont été validés avec succès. AWS S3 est maintenant intégré à votre compte Braze.

Mise à jour des identifiants Amazon S3 pour Currents

Vous pouvez mettre à jour les identifiants Amazon S3 sur un connecteur Braze Currents existant sans interrompre l’intégration ni perdre les données déjà exportées vers votre compartiment.

Pour actualiser les identifiants — ou pour basculer entre AWS Secret Access Key et AWS Role ARN — terminez les étapes IAM et AWS décrites plus haut dans cet article pour la méthode choisie (politiques, utilisateur ou rôle, et identifiants selon les besoins).

Lorsque vous avez terminé de préparer les identifiants dans AWS, accédez à Partner Integrations > Currents dans Braze, localisez votre connecteur Amazon S3 dans la liste, sélectionnez Edit, mettez à jour les Credentials, puis sélectionnez Update Current. Braze valide les identifiants que vous saisissez ; votre connecteur continue de fonctionner et les données déjà présentes dans votre compartiment restent disponibles. Pour en savoir plus, consultez la section Mise à jour de Currents dans Configurer Currents.

Comportement d’exportation

Les utilisateurs qui ont intégré une solution de stockage de données dans le cloud et des API d’exportation, des rapports de tableau de bord ou des rapports CSV constatent les comportements suivants :

  • Toutes les exportations API ne renvoient pas d’URL de téléchargement dans le corps de la réponse et doivent être récupérées via le stockage de données.
  • Tous les rapports de tableau de bord et les rapports CSV sont envoyés par e-mail à l’utilisateur pour téléchargement (aucune autorisation de stockage requise) et sauvegardés sur le stockage de données.

Erreur Unable to connect to S3, please validate that your credentials are correct

Si vous voyez cette erreur lors du téléchargement d’une exportation CSV, ouvrez l’intégration Amazon S3 sur la page Partenaires technologiques et sélectionnez Test Credentials. Le résultat explique ce qui a échoué lors de la validation — par exemple, la clé pourrait ne pas disposer de la permission GetObject, ce qui empêche Braze de générer des liens de téléchargement.

Mettez à jour votre politique IAM afin que l’utilisateur ou le rôle d’intégration puisse appeler s3:GetObject sur le compartiment S3 et le chemin d’objet configurés dans votre intégration Braze. Pour d’autres problèmes d’exportation, consultez la Résolution des problèmes d’exportation.

Connecteurs multiples

Si vous avez l’intention de créer plusieurs connecteurs Currents pour envoyer des données vers votre compartiment S3, vous pouvez utiliser les mêmes identifiants, mais vous devez spécifier un chemin de dossier différent pour chacun. Vous pouvez les créer dans le même espace de travail, ou les répartir et les créer dans plusieurs espaces de travail. Vous avez également la possibilité de créer une politique distincte pour chaque intégration, ou de créer une seule politique couvrant les deux intégrations.

Si vous prévoyez d’utiliser le même compartiment S3 à la fois pour Currents et pour les exportations de données, vous devez créer deux politiques distinctes, car chaque intégration nécessite des permissions différentes.

Résolution des problèmes

Erreur : le compte n’a pas l’accès PutObject

Si vous voyez l’erreur suivante lors de l’enregistrement des identifiants Amazon S3 pour les exportations de données du tableau de bord, cela peut être dû à des autorisations incorrectes ou à des paramètres de chiffrement côté serveur.

1

S3 Credentials are invalid because this account does not have 'PutObject access'. Please check the permissions and ensure that this key has access to 'PutObject' in the 'CUSTOMER-BUCKET-HERE' bucket.

Pour résoudre ce problème, vérifiez les points suivants.

Politique de compartiment incorrecte

Vérifiez que vous avez créé une politique avec les autorisations appropriées, comme décrit dans Intégration Amazon S3 (utilisez la politique Dashboard Data Export pour votre méthode d’authentification).

Chiffrement côté serveur

1

User: arn:aws:sts::XXX:assumed-role/braze-iam-role/braze is not authorized to perform: kms:GenerateDataKey on resource: arn:aws:XXX because no identity-based policy allows the kms:GenerateDataKey action

Si vous recevez ce message d’erreur de la part du support Braze ou dans vos journaux AWS, votre compartiment S3 est configuré avec le chiffrement AWS Key Management Service (SSE-KMS). Braze ne prend pas en charge SSE-KMS pour Currents ni pour les exportations de données du tableau de bord. Pour résoudre ce problème, désactivez SSE-KMS dans votre compartiment S3.

Vérifier les autorisations supplémentaires

Assurez-vous de disposer des autorisations nécessaires, notamment s3:GetBucketLocation et s3:PutObject.
New Stuff!