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).

Conditions préalables

Création d’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 avec AWS.
  2. Après vous être connecté, sélectionnez S3 dans la catégorie Storage & Content Delivery.
  3. Sélectionnez Create Bucket dans 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 dispose de 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 permet à 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 afficher 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.

Étape 3 : Créer une politique

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

Spécifiez le 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 à la vérification des identifiants et n’est 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 : Joindre 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 la nouvelle politique que vous avez créée. Vous êtes maintenant prêt à lier vos identifiants AWS à votre compte Braze.

Étape 5 : Lier Braze à AWS

Dans Braze, accédez à Intégrations partenaires > Currents.

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

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

Vous pouvez également ajouter les personnalisations suivantes en fonction de vos besoins :

  • Chemin d’accès au dossier : La valeur par défaut est currents. Si ce dossier n’existe pas, Braze le crée automatiquement pour vous.
  • Chiffrement AES-256 côté serveur, au repos : La valeur par défaut est OFF et inclut l’en-tête x-amz-server-side-encryption.

Sélectionnez Launch Current pour continuer.

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

Dans Braze, accédez à Intégrations partenaires > Partenaires technologiques et sélectionnez Amazon S3.

Sur la page AWS Credentials, assurez-vous que l’option AWS Secret Access Key est sélectionnée, puis saisissez votre ID d’accès AWS, votre clé d’accès secrète AWS et le nom du compartiment S3 AWS dans les champs désignés. Lorsque vous saisissez 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.

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

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

Cette méthode d’authentification génère un nom de ressource Amazon (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.

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 2 : Créer un rôle

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

Récupérez votre ID de compte Braze et votre ID externe à partir de votre compte Braze :

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

De retour sur la console AWS, sélectionnez Another AWS Account comme type de sélecteur d’entité de confiance. Indiquez votre ID de compte Braze, cochez la case Require external ID et saisissez l’ID externe de 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 les limites des autorisations.

Étape 3 : Joindre 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 pour la joindre. Sélectionnez Next lorsque vous avez terminé.

ARN du rôle

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

ARN du rôle

Votre nouveau rôle apparaît maintenant 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.

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

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

Dans Braze, accédez à Intégrations partenaires > Currents. Ensuite, sélectionnez Create New Current puis Amazon S3 Data Export.

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

Vous pouvez également ajouter les personnalisations suivantes en fonction de vos besoins :

  • Chemin d’accès au 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 Partenaires technologiques sous Intégrations et sélectionnez Amazon S3.

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 S3 AWS 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 indique si vos identifiants ont été validés avec succès. AWS S3 est désormais intégré à votre compte Braze.

Comportement à l’exportation

Les utilisateurs qui ont intégré une solution de stockage de données dans le cloud et qui exportent via des API, des rapports de tableau de bord ou des rapports CSV constatent le comportement suivant :

  • 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 n’est requise) et sauvegardés sur Data Storage.

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é peut ne pas disposer de l’autorisation 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 section 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 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 dans plusieurs espaces de travail. Vous avez également la possibilité de créer une politique unique pour chaque intégration ou de créer une politique qui couvre les deux intégrations.

Si vous prévoyez d’utiliser le même compartiment S3 pour Currents et les exportations de données, vous devez créer deux politiques distinctes, car chaque intégration nécessite des autorisations 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

Confirmez que vous avez créé une politique avec les autorisations correctes telles que décrites dans la section 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 de l’assistance 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 ou 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!