Exportação de eventos de segurança com Amazon S3

Você pode exportar automaticamente eventos de segurança para o Amazon S3, um provedor de armazenamento em nuvem, com um trabalho diário que é executado à meia-noite UTC. Depois da configuração, você não precisa mais exportar eventos de segurança manualmente pelo dashboard.

Importante

A disponibilidade da exportação de eventos de segurança com Amazon S3 depende da sua edição da plataforma. Se esse recurso não estiver no seu espaço de trabalho, entre em contato com o seu gerente de sucesso do cliente para obter informações.

A exportação envia os eventos de segurança das últimas 24 horas em formato CSV para o seu armazenamento S3 configurado. O arquivo CSV usa as mesmas colunas de um relatório exportado manualmente, além de uma coluna Version. Essas exportações não estão sujeitas ao limite de 10.000 linhas que se aplica aos downloads manuais de relatórios CSV do dashboard.

A Braze oferece suporte a dois métodos diferentes de autenticação e autorização S3 para configurar a exportação para o Amazon S3:

• Método da chave de acesso secreta da AWS
• Método do ARN da função da AWS

Importante

A partir de dezembro de 2026, está previsto que essa exportação seja executada a cada hora, em vez de diariamente. Revise todos os trabalhos posteriores que esperam um único arquivo diário.

Método de chave de acesso secreta da AWS

Esse método gera uma chave secreta e um ID de chave de acesso que permitem à Braze se autenticar como um usuário na sua conta AWS para gravar dados no seu bucket.

Etapa 1: Criar um usuário de Identity and Access Management (IAM)

Para obter sua chave de acesso secreta e seu ID de chave de acesso, você precisa criar um usuário IAM seguindo as instruções em Configuração da sua conta AWS.

Etapa 2: Obter credenciais

1. Depois de criar um novo usuário, gere a chave de acesso e baixe seu ID de chave de acesso e sua chave de acesso secreta.

2. Anote essas credenciais em algum lugar ou baixe os arquivos de credenciais, porque você vai precisar inseri-las na Braze mais tarde.

Etapa 3: Criar política

1. Acesse IAM (Identity and Access Management) > Policies > Create Policy para adicionar permissões ao seu usuário.
2. Selecione Create Your Own Policy, que concede permissões limitadas para que a Braze só possa acessar os buckets especificados.
3. Especifique um nome de política de sua escolha.
4. Insira o seguinte snippet de código na seção Policy Document. Substitua “INSERTBUCKETNAME” pelo nome do seu bucket. Sem essas permissões, a integração vai falhar na verificação de credenciais e não será criada.

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

Etapa 4: Anexar política

1. Depois de criar uma nova política, acesse Users e selecione seu usuário específico.
2. Na guia Permissions, selecione Add Permissions, anexe a política diretamente e, em seguida, selecione essa política.

Agora você já pode vincular suas credenciais da AWS à sua conta Braze!

Etapa 5: Vincular a Braze à AWS

1. Na Braze, acesse Configurações > Configurações da empresa > Configurações do administrador > Configurações de segurança e role até a seção Download de eventos de segurança.
2. Ative Exportar para AWS S3 em Exportar para armazenamento em nuvem e selecione Chave de acesso secreta da AWS, o que ativa a exportação para o S3.
3. Insira as seguintes informações:

• ID da chave de acesso da AWS
• Nome do bucket da AWS
• Chave de acesso secreta da AWS
  • Ao inserir essa chave, primeiro selecione Testar credenciais para confirmar que suas credenciais funcionam.

4. Selecione Salvar alterações.

Você integrou o AWS S3 à sua conta Braze!

Método de ARN de função da AWS

O método de ARN de função da AWS gera um Amazon Resource Name (ARN) de função que permite que a conta Amazon da Braze se autentique como membro dessa função.

Etapa 1: Criar política

1. Faça login no console de gerenciamento da AWS como administrador da conta.
2. No console da AWS, acesse a seção IAM (Identity and Access Management) > Policies e selecione Create Policy.

3. Abra a guia JSON e insira o seguinte snippet de código na seção Policy Document. Substitua INSERTBUCKETNAME pelo nome do seu bucket.

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. Depois de revisar a política, selecione Next.

5. Dê um nome e uma descrição à política e selecione Create Policy.

Etapa 2: Criar função

1. Na Braze, acesse Configurações > Configurações da empresa > Configurações de administrador > Configurações de segurança e role até a seção Download de eventos de segurança.
2. Selecione ARN de função da AWS.
3. Anote os identificadores, o ID da conta da Braze e o ID externo da Braze necessários para criar sua função.

1. No console da AWS, acesse a seção IAM (Identity and Access Management) > Roles > Create Role.
2. Selecione Another AWS Account como o tipo de seletor de entidade confiável.
3. Informe o ID da conta da Braze, marque a caixa Require external ID e insira o ID externo da Braze.
4. Quando terminar, selecione Next.

Etapa 3: Anexar política

1. Pesquise na barra de pesquisa a política que você criou anteriormente e marque a caixa ao lado dela para anexá-la.
2. Selecione Next.

3. Dê um nome e uma descrição à função e selecione Create Role.

Sua nova função vai aparecer na lista!

Etapa 4: Vincular à AWS da Braze

1. No console da AWS, encontre a função que você acabou de criar na lista. Selecione o nome para abrir os detalhes da função e anote o ARN.

2. Na Braze, acesse Configurações > Configurações da empresa > Configurações de administrador > Configurações de segurança e role até a seção Download de eventos de segurança.

3. Confirme que a opção ARN de função da AWS está selecionada e insira o ARN da função e o nome do bucket S3 da AWS nos campos indicados.
4. Selecione Testar credenciais para confirmar que suas credenciais funcionam corretamente.
5. Selecione Salvar alterações.

Você integrou o AWS S3 à sua conta da Braze!