Amazon S3

Amazon S3 es un sistema de almacenamiento altamente escalable ofrecido por Amazon Web Services.

La integración de Braze y Amazon S3 presenta dos estrategias de integración:

• Aprovecha Currents, habilitándote para almacenar datos allí hasta que quieras conectarlos a otras plataformas, herramientas y ubicaciones.
• Utiliza las exportaciones de datos del panel (como las exportaciones CSV y los informes de interacción).

Requisitos previos

Crear un nuevo contenedor de S3

Para crear un contenedor para tu aplicación, haz lo siguiente:

1. Abre la consola de Amazon S3 y sigue las instrucciones para Iniciar sesión o Crear una cuenta en AWS.
2. Tras iniciar sesión, selecciona S3 en la categoría Almacenamiento y entrega de contenidos.
3. Selecciona Crear contenedor en la siguiente pantalla.
4. Se te pedirá que crees tu contenedor y selecciones una región.

Integración

Braze tiene dos estrategias diferentes de integración con Amazon S3: una para Braze Currents y otra para todas las exportaciones de datos del panel (como exportaciones CSV o informes de interacción). Ambas integraciones admiten dos métodos diferentes de autenticación o autorización:

• Método de clave de acceso secreta de AWS
• Método ARN del rol de AWS

Método de autenticación de clave secreta de AWS

Este método de autenticación genera una clave secreta y un ID de clave de acceso que habilita a Braze a autenticarse como usuario en tu cuenta de AWS para escribir datos en tu contenedor.

Paso 1: Crear usuario

Para recuperar tu ID de clave de acceso y tu clave de acceso secreta, tendrás que crear un usuario IAM y un grupo de administradores en AWS.

Paso 2: Obtener credenciales

Tras crear un nuevo usuario, selecciona Mostrar credenciales de seguridad del usuario para revelar su ID de clave de acceso y su clave de acceso secreta. A continuación, anota estas credenciales en algún sitio o selecciona el botón Descargar credenciales, ya que tendrás que introducirlas en el panel Braze más adelante.

Paso 3: Crear política

Ve a Políticas > Empezar > Crear política para añadir permisos a tu usuario. A continuación, selecciona Crear tu propia política. Esto dará permisos limitados, para que Braze sólo pueda acceder a los contenedores especificados.

Especifica un nombre de política de tu elección, e introduce el siguiente fragmento de código en la sección Documento de Política. Asegúrate de sustituir INSERTBUCKETNAME por el nombre de tu contenedor. Sin estos permisos, la integración no superará la comprobación de credenciales y no se creará.

• braze currents
• exportación de datos del panel

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

Paso 4: Adjuntar política

Después de crear una nueva política, ve a Usuarios y selecciona en tu usuario específico. En la pestaña Permisos, selecciona Adjuntar política y selecciona la nueva política que has creado. Ahora, estás listo para vincular tus credenciales de AWS a tu cuenta Braze.

Paso 5: Vincular Braze a AWS

• braze currents
• exportación de datos del panel

Método de autenticación ARN del rol de AWS

Este método de autenticación genera un nombre de recurso de Amazon (ARN) de rol que habilita la cuenta de Amazon Braze para autenticarse como miembro del rol que creaste para escribir datos en tu contenedor.

Paso 1: Crear política

Para comenzar, inicie sesión en la consola de administración de AWS como administrador de cuenta. Ve a la sección IAM de la consola de AWS, selecciona Políticas en la barra de navegación y selecciona Crear política.

Abre la pestaña JSON e introduce el siguiente fragmento de código en la sección Documento de Política. Asegúrate de sustituir INSERTBUCKETNAME por el nombre de tu contenedor. Seleccione Revisar política cuando haya terminado.

• braze currents
• exportación de datos del panel

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

A continuación, dale un nombre y una descripción a la política y selecciona Crear política.

Paso 2: Crear rol

Dentro de la misma sección IAM de la consola, selecciona Roles > Crear Rol.

Recupera el ID de tu cuenta Braze y el ID externo de tu cuenta Braze:

• Currents: En Braze, ve a Integraciones de socios > Exportación de datos. A continuación, selecciona Crear corriente y luego Exportación de datos de Amazon S3. Aquí encontrarás los identificadores necesarios para crear tu rol.
• Exportación de datos del panel: En Braze, ve a Integraciones de socios > Socios tecnológicos y selecciona Amazon S3. Aquí encontrarás los identificadores necesarios para crear tu rol.

De vuelta en la consola de AWS, selecciona Otra cuenta de AWS como tipo de selector de entidad de confianza. Proporciona el ID de tu cuenta Braze, marca la casilla Requerir ID externo e introduce el ID externo Braze. Seleccione Siguiente cuando haya terminado.

Paso 3: Adjuntar política

A continuación, adjunta al rol la política que creaste anteriormente. Busca la póliza en la barra de búsqueda, y coloca una marca de verificación junto a la póliza para adjuntarla. Seleccione Siguiente cuando haya terminado.

Dale al rol un nombre y una descripción, y selecciona Crear rol.

Ahora deberías ver tu función recién creada en la lista.

Paso 4: Enlace a Braze AWS

En la consola de AWS, busca en la lista el rol que acabas de crear. Selecciona el nombre para abrir los detalles de ese rol.

Toma nota del ARN del Rol en la parte superior de la página de resumen del Rol.

Vuelve a tu cuenta de Braze y copia el ARN del rol en el campo correspondiente.

• braze currents
• exportación de datos del panel

Comportamiento de la exportación

Los usuarios que hayan integrado una solución de almacenamiento de datos en la nube e intenten exportar API, informes de cuadros de mando o informes CSV experimentarán lo siguiente:

• Todas las exportaciones de la API no devolverán una URL de descarga en el cuerpo de la respuesta y deberán recuperarse a través del almacenamiento de datos.
• Todos los informes del panel y los informes CSV se enviarán al correo electrónico del usuario para su descarga (sin necesidad de permisos de almacenamiento) y se realizará una copia de seguridad en Almacenamiento de datos.

Conectores múltiples

Si pretendes crear más de un conector Currents para enviarlo a tu contenedor de S3, podrás utilizar las mismas credenciales, pero deberás especificar una ruta de carpeta diferente para cada uno. Pueden crearse en el mismo espacio de trabajo, o dividirse y crearse en varios espacios de trabajo. También tienes la opción de crear una única política para cada integración, o crear una política que cubra ambas integraciones.

Si planeas utilizar el mismo contenedor de S3 tanto para Currents como para la exportación de datos, tendrás que crear dos políticas distintas, ya que cada integración requiere permisos diferentes.