Exportation d’événements de sécurité avec Amazon S3

Vous pouvez exporter automatiquement les événements de sécurité vers Amazon S3, un fournisseur de stockage cloud, grâce à une tâche quotidienne qui s’exécute à minuit UTC. Une fois la configuration effectuée, il n’est pas nécessaire d’exporter manuellement les événements de sécurité depuis le tableau de bord. Cette tâche exporte les événements de sécurité des dernières 24 heures au format CSV vers votre stockage S3 configuré. Le fichier CSV présente la même structure qu’un rapport exporté manuellement.

Braze prend en charge deux méthodes d’authentification et d’autorisation S3 différentes pour configurer l’exportation Amazon S3 :

• Méthode de clé d’accès secrète AWS
• Méthode ARN de rôle AWS

Méthode de clé d’accès secrète AWS

Cette méthode 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 de gestion des identités et des accès (IAM)

Pour récupérer votre clé d’accès secrète et votre ID de clé d’accès, vous devrez créer un utilisateur IAM en suivant les instructions de la section Configurer votre compte AWS.

Étape 2 : Obtenir les identifiants

1. Après avoir créé un nouvel utilisateur, générez la clé d’accès et téléchargez votre ID de clé d’accès et votre clé d’accès secrète.

2. Notez ces identifiants quelque part ou téléchargez les fichiers d’identifiants, car vous devrez les saisir dans Braze ultérieurement.

Étape 3 : Créer une politique

1. Accédez à IAM (Identity and Access Management) > Policies > Create Policy pour ajouter des autorisations à votre utilisateur.
2. Sélectionnez Create Your Own Policy, ce qui accorde des autorisations limitées afin que Braze ne puisse accéder qu’aux compartiments spécifiés.
3. Indiquez un nom de politique de votre choix.
4. 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 échouera 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:GetObject", "s3:PutObject", "s3:DeleteObject"],
            "Resource": ["arn:aws:s3:::INSERTBUCKETNAME*", "arn:aws:s3:::INSERTBUCKETNAME/", "arn:aws:s3:::INSERTBUCKETNAME"]
        }
    ]
}

Étape 4 : Attacher la politique

1. Après avoir créé une nouvelle politique, accédez à Users et sélectionnez votre utilisateur spécifique.
2. Dans l’onglet Permissions, sélectionnez Add Permissions, attachez directement la politique, puis sélectionnez cette politique.

Vous êtes maintenant prêt à lier vos identifiants AWS à votre compte Braze !

Étape 5 : Lier Braze à AWS

1. Dans Braze, accédez à Paramètres > Paramètres de l’entreprise > Paramètres d’administration > Paramètres de sécurité et faites défiler jusqu’à la section Security Event Download.
2. Activez Export to AWS S3 sous Export to cloud storage et sélectionnez AWS secret access key pour activer l’exportation S3.
3. Saisissez les informations suivantes :
   • ID de clé d’accès AWS
   • Clé d’accès secrète AWS
   • Lors de la saisie de cette clé, sélectionnez d’abord Test Credentials pour vérifier que vos identifiants fonctionnent. - Nom du compartiment AWS

4. Sélectionnez Enregistrer les modifications.

L’intégration d’AWS S3 avec votre compte Braze est terminée !

Méthode ARN de rôle AWS

La méthode ARN de rôle AWS 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 de ce rôle.

Étape 1 : Créer une politique

1. Connectez-vous à la console de gestion AWS en tant qu’administrateur de compte.
2. Dans la console AWS, accédez à la section IAM (Identity and Access Management) > Policies, puis sélectionnez Create Policy.

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

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/*"]
        }
    ]
}

4. Sélectionnez Next après avoir vérifié la politique.

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

Étape 2 : Créer un rôle

1. Dans Braze, accédez à Paramètres > Paramètres de l’entreprise > Paramètres d’administration > Paramètres de sécurité et faites défiler jusqu’à la section Security Event Download.
2. Sélectionnez AWS Role ARN.
3. Notez les identifiants nécessaires pour créer votre rôle : l’ID de compte Braze et l’ID externe Braze.

1. Dans la console AWS, accédez à la section IAM (Identity and Access Management) > Roles > Create Role.
2. Sélectionnez Another AWS Account comme type d’entité de confiance.
3. Fournissez votre ID de compte Braze, cochez la case Require external ID, puis saisissez votre ID externe Braze.
4. Sélectionnez Next une fois terminé.

Étape 3 : Attacher la politique

1. Recherchez la politique que vous avez créée précédemment dans la barre de recherche, puis cochez la case à côté de la politique pour l’attacher.
2. Sélectionnez Next.

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

Votre rôle nouvellement créé apparaîtra dans la liste !

Étape 4 : Lier à Braze AWS

1. 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 et notez l’ARN.

2. Dans Braze, accédez à Paramètres > Paramètres de l’entreprise > Paramètres d’administration > Paramètres de sécurité et faites défiler jusqu’à la section Security Event Download.

3. Assurez-vous que AWS role ARN est sélectionné, puis saisissez votre ARN de rôle et le nom de votre compartiment AWS S3 dans les champs prévus à cet effet.
4. Sélectionnez Test Credentials pour vérifier que vos identifiants fonctionnent correctement.
5. Sélectionnez Enregistrer les modifications.

L’intégration d’AWS S3 avec votre compte Braze est terminée !