Ir al contenido

Esta página fue traducida automáticamente y puede contener errores. Para informar de un error de traducción, usa el componente de comentarios situado bajo el sumario, a la derecha de la página.

Fuentes conectadas

Las fuentes conectadas son una alternativa de copia cero a la sincronización directa de datos con la característica de ingesta de datos en el cloud (CDI) de Braze. Una fuente conectada consulta directamente tu almacén de datos para crear nuevos segmentos sin copiar ninguno de los datos subyacentes a Braze.

Después de añadir una fuente conectada a tu espacio de trabajo de Braze, puedes crear un segmento CDI dentro de las extensiones de segmento. Las extensiones de segmento CDI te permiten escribir SQL que consulta directamente tu almacén de datos (utilizando los datos que están disponibles a través de tu fuente conectada CDI) y crean y mantienen un grupo de usuarios a los que puedes dirigirte dentro de Braze.

Para obtener más información sobre cómo crear un segmento con esta fuente, consulta Extensiones de segmento CDI.

Advertencia

Dado que las fuentes conectadas se ejecutan directamente en tu almacén de datos, asumirás todos los costes asociados a la ejecución de estas consultas en tu almacén de datos. Las fuentes conectadas no registran puntos de datos y las extensiones de segmento CDI no consumen créditos de segmento SQL.

Integración de fuentes conectadas

Paso 1: Conecta tus recursos

Las fuentes conectadas de Cloud Data Ingestion requieren cierta configuración en Braze y en tu instancia. Sigue estos pasos para configurar la integración−algunos pasos se realizan en tu almacén de datos y otros en tu panel de Braze.

En tu almacén de datos

Crea un rol y concédele permisos para consultar y crear tablas en un esquema.
Configura tu almacén y da acceso a ese rol.
Crea un usuario para ese rol con Workload Identity Federation o un par de claves RSA.
Según tu configuración, es posible que tengas que permitir las IP de Braze en tu política de red de Snowflake.

En el panel de Braze

Crea una nueva fuente conectada en el panel de Braze.
Configura los detalles de sincronización de la fuente conectada.
Para un par de claves RSA, obtén la clave pública. Para Workload Identity Federation, copia la instrucción del formulario de credenciales.

En tu almacén de datos

Para un par de claves RSA, añade la clave pública al usuario de Snowflake para la autenticación. Para Workload Identity Federation, ejecuta la instrucción en una hoja de cálculo de Snowflake. Cuando termines, puedes usar la fuente conectada para crear una o más extensiones de segmento CDI.

Configura los datos de origen y los recursos necesarios en tu entorno de Redshift.
Crea una nueva fuente conectada en el panel de Braze.
Prueba la integración.
Usa la fuente conectada para crear una o más extensiones de segmento CDI.

Configura los datos de origen y los recursos necesarios en tu entorno de BigQuery.
Crea una cuenta de servicio a la que Braze acceda mediante Workload Identity Federation o una clave de cuenta de servicio, y permite el acceso a los proyectos y conjuntos de datos de BigQuery que contienen los datos que quieres sincronizar.
Crea una nueva fuente conectada en el panel de Braze.
Prueba la integración.
Usa la fuente conectada para crear una o más extensiones de segmento CDI.

Configura los datos de origen y los recursos necesarios en tu entorno de Databricks.
Crea una entidad de servicio para la autenticación OAuth de máquina a máquina (M2M) o un token de acceso personal, y permite el acceso a los catálogos y esquemas de Databricks que contienen los datos que quieres sincronizar.
Crea una nueva fuente conectada en el panel de Braze.
Prueba la integración.
Usa la fuente conectada para crear una o más extensiones de segmento CDI.

Importante

Puede haber un tiempo de calentamiento de dos a cinco minutos cuando Braze se conecta a instancias SQL Classic y Pro, lo que provocará retrasos durante la configuración y prueba de la conexión, así como durante la creación y actualización de extensiones de segmento CDI. Usar una instancia SQL sin servidor minimizará el tiempo de calentamiento y mejorará el rendimiento de las consultas, pero puede suponer costos de integración ligeramente más altos.

Crea una entidad de servicio y permite el acceso al espacio de trabajo de Fabric que se usará para tu integración.
En tu espacio de trabajo de Fabric, configura los datos de origen y concede permisos a tu entidad de servicio
Crea una nueva fuente conectada en el panel de Braze.
Prueba la integración.
Usa la fuente conectada para crear una o más extensiones de segmento CDI.

Paso 2: Configura tu almacén de datos

Configura los datos de origen y los recursos necesarios en el entorno de tu almacén de datos. La fuente conectada puede hacer referencia a una o más tablas, así que asegúrate de que tu usuario de Braze tenga permiso para acceder a todas las tablas que quieras incluir en la fuente conectada.

Paso 2.1: Crea un rol y concede permisos

Crea un rol para que lo use tu fuente conectada. Este rol se usará para generar la lista de tablas disponibles en tus extensiones de segmento CDI y para consultar las tablas de origen y crear nuevos segmentos. Una vez creada la fuente conectada, Braze detectará los nombres y la descripción de todas las tablas disponibles para el usuario en el esquema de origen.

El permiso create table es necesario para que Braze pueda crear una tabla con los resultados de la consulta de tu extensión de segmento CDI antes de actualizar el segmento en Braze. Braze creará una tabla temporal por segmento, y la tabla solo persistirá mientras Braze actualiza el segmento.

CREATE ROLE BRAZE_INGESTION_ROLE;

GRANT USAGE ON DATABASE BRAZE_CLOUD_PRODUCTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT CREATE TABLE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;

-- grant access to all current and future tables or views in the schema
GRANT SELECT ON ALL TABLES IN SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT SELECT ON FUTURE TABLES IN SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;

-- grant access to specific tables or views in the schema
GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC TO ROLE BRAZE_INGESTION_ROLE;

Paso 2.2: Configura el almacén y da acceso al rol de Braze

CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;

GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

Nota

El almacén debe tener activada la opción auto-resume. Si no lo está, tendrás que conceder a Braze privilegios OPERATE adicionales en el almacén para que Braze pueda activarlo cuando llegue el momento de ejecutar la consulta.

Paso 2.3: Configura el usuario

Braze se autentica en Snowflake con Workload Identity Federation o un par de claves RSA. Las credenciales existentes de par de claves RSA siguen funcionando y no necesitas migrarlas. Sigue uno de los dos métodos.

workload identity federation
key pair

Usa las concesiones de rol y almacén del Paso 2.1 y del Paso 2.2. Si tu cuenta de Snowflake usa una política de red, permite las direcciones IP de Braze como se describe en el Paso 2.4.

Crea el usuario de servicio desde el formulario de credenciales de Snowflake y ejecuta esa instrucción en una hoja de cálculo de Snowflake. Para saber qué hace la instrucción y dónde ejecutarla, consulta Configurar Snowflake para Workload Identity Federation.

CREATE USER BRAZE_INGESTION_USER;

GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;

Compartirás la información de conexión con Braze y recibirás una clave pública que deberás añadir al usuario en un paso posterior.

Nota

Al conectar distintos espacios de trabajo a la misma cuenta de Snowflake, debes crear un usuario único para cada espacio de trabajo de Braze en el que crees una integración. Dentro de un espacio de trabajo, puedes reutilizar el mismo usuario en varias integraciones, pero la creación de la integración fallará si un usuario de la misma cuenta de Snowflake está duplicado en varios espacios de trabajo.

Paso 2.4: Permite las IP de Braze en tu política de red de Snowflake (opcional)

Según la configuración de tu cuenta de Snowflake, es posible que tengas que permitir las siguientes direcciones IP en tu política de red de Snowflake. Para más información sobre cómo hacerlo, consulta la documentación de Snowflake sobre modificar una política de red.

Para las instancias US-01, US-02, US-03, US-04, US-05, US-06, US-07, estas son las direcciones IP correspondientes:

23.21.118.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

Para la instancia US-08, estas son las direcciones IP correspondientes:

52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145

Para la instancia US-10, estas son las direcciones IP correspondientes:

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Para las instancias EU-01 y EU-02, estas son las direcciones IP correspondientes:

52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

Para la instancia AU-01, estas son las direcciones IP correspondientes:

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Para la instancia ID-01, estas son las direcciones IP correspondientes:

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

Para la instancia JP-01, estas son las direcciones IP correspondientes:

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

Para la instancia KR-01, estas son las direcciones IP correspondientes:

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

Paso 2.1: Crea el usuario y concede permisos

CREATE USER braze_user PASSWORD '{password}';
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT CREATE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT SELECT ON TABLE USERS_ATTRIBUTES_SYNC TO braze_user;

Crea un usuario para que lo use tu fuente conectada. Este usuario se usará para generar la lista de tablas disponibles en tus extensiones de segmento CDI y para consultar las tablas de origen y crear nuevos segmentos. Una vez creada la fuente conectada, Braze detectará los nombres y la descripción de todas las tablas disponibles para el usuario en el esquema de origen. Si creas varias integraciones CDI, quizá te convenga conceder permisos a un esquema o gestionar los permisos mediante un grupo.

Puedes elegir conceder acceso a todas las tablas de un esquema o conceder privilegios solo a tablas específicas. Las tablas a las que tenga acceso el rol de Braze estarán disponibles para consultarse en la extensión de segmento CDI. Asegúrate de conceder al usuario acceso a las nuevas tablas cuando se creen, o establece permisos predeterminados para el usuario.

El permiso create table es necesario para que Braze pueda crear una tabla con los resultados de la consulta de tu extensión de segmento CDI antes de actualizar el segmento en Braze. Braze creará una tabla temporal por segmento, que solo persistirá mientras Braze actualiza el segmento.

Paso 2.2: Permite el acceso a las IP de Braze

Si tienes un firewall u otras políticas de red, debes dar a Braze acceso de red a tu instancia de Redshift. Permite el acceso desde las siguientes IP correspondientes a la región de tu panel de Braze.

Es posible que también tengas que cambiar tus grupos de seguridad para permitir que Braze acceda a tus datos en Redshift. Asegúrate de permitir explícitamente el tráfico entrante en las IP de la siguiente sección y en el puerto usado para consultar tu clúster de Redshift (el predeterminado es 5439). Debes permitir explícitamente la conectividad TCP de Redshift en este puerto aunque las reglas de entrada estén configuradas como “permitir todo”. Además, es importante que el endpoint del clúster de Redshift sea de acceso público para que Braze pueda conectarse a tu clúster.

Si no quieres que tu clúster de Redshift sea de acceso público, puedes configurar una VPC y una instancia EC2 para usar un túnel ssh y acceder a los datos de Redshift. Para más información, consulta AWS: ¿Cómo accedo a un clúster privado de Amazon Redshift desde mi máquina local?

Para las instancias US-01, US-02, US-03, US-04, US-05, US-06, US-07, estas son las direcciones IP correspondientes:

23.21.118.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

Para la instancia US-08, estas son las direcciones IP correspondientes:

52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145

Para la instancia US-10, estas son las direcciones IP correspondientes:

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Para las instancias EU-01 y EU-02, estas son las direcciones IP correspondientes:

52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

Para la instancia AU-01, estas son las direcciones IP correspondientes:

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Para la instancia ID-01, estas son las direcciones IP correspondientes:

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

Para la instancia JP-01, estas son las direcciones IP correspondientes:

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

Para la instancia KR-01, estas son las direcciones IP correspondientes:

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

Paso 2.1: Crea credenciales para Braze

Crea una cuenta de servicio en GCP para que Braze la use para conectarse y leer datos de tus tablas. La cuenta de servicio debe tener los permisos de la siguiente sección:

BigQuery Connection User: Permite a Braze establecer conexiones.
BigQuery User: Da acceso a Braze para ejecutar consultas, leer los metadatos de los conjuntos de datos y listar tablas.
BigQuery Data Viewer: Da acceso a Braze para ver los conjuntos de datos y su contenido.
BigQuery Job User: Da acceso a Braze para ejecutar trabajos.
bigquery.tables.create Da acceso a Braze para crear tablas temporales durante la actualización de segmentos.

Crea una cuenta de servicio para que la use tu fuente conectada. Este usuario se usará para generar la lista de tablas disponibles en tus extensiones de segmento CDI y para consultar las tablas de origen y crear nuevos segmentos. Una vez creada la fuente conectada, Braze detectará los nombres y la descripción de todas las tablas disponibles para el usuario en el esquema de origen.

Puedes elegir conceder acceso a todas las tablas de un conjunto de datos o conceder privilegios solo a tablas específicas. Las tablas a las que tenga acceso el rol de Braze estarán disponibles para consultarse en la extensión de segmento CDI.

Braze puede acceder a la cuenta de servicio con Workload Identity Federation o con una clave de cuenta de servicio. Las credenciales existentes de clave de cuenta de servicio siguen funcionando y no necesitas migrarlas. Una misma credencial de Workload Identity Federation puede servir tanto para orígenes de BigQuery como de Google Cloud Storage.

workload identity federation
service account key

Configura un grupo de identidades de carga de trabajo, un proveedor y la cuenta de servicio, y vincula la entidad principal de Braze a la cuenta de servicio. Para ver los pasos, consulta Configurar Google Cloud para Workload Identity Federation. Si ya configuraste Workload Identity Federation para otro origen de BigQuery o Google Cloud Storage, no necesitas repetirlo. Concede a la cuenta de servicio existente los permisos indicados en este paso.

Después de crear la cuenta de servicio y conceder los permisos, genera una clave JSON. Para más información, consulta Google Cloud: Crear y eliminar claves de cuentas de servicio. La subirás al panel de Braze más adelante.

Paso 2.2: Permite el acceso a las IP de Braze

Si tienes políticas de red, debes dar a Braze acceso de red a tu instancia de BigQuery. Permite el acceso desde las siguientes IP correspondientes a la región de tu panel de Braze.

Para las instancias US-01, US-02, US-03, US-04, US-05, US-06, US-07, estas son las direcciones IP correspondientes:

23.21.118.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

Para la instancia US-08, estas son las direcciones IP correspondientes:

52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145

Para la instancia US-10, estas son las direcciones IP correspondientes:

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Para las instancias EU-01 y EU-02, estas son las direcciones IP correspondientes:

52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

Para la instancia AU-01, estas son las direcciones IP correspondientes:

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Para la instancia ID-01, estas son las direcciones IP correspondientes:

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

Para la instancia JP-01, estas son las direcciones IP correspondientes:

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

Para la instancia KR-01, estas son las direcciones IP correspondientes:

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

Paso 2.1: Crea credenciales para Braze

Braze puede conectarse a Databricks mediante OAuth de máquina a máquina (M2M) con una entidad de servicio, o con un token de acceso personal. Braze recomienda OAuth M2M. Las credenciales existentes de token de acceso personal siguen funcionando y no necesitas migrarlas.

Sea cual sea el método que elijas, Braze usa estas credenciales para generar la lista de tablas disponibles en tus extensiones de segmento CDI y para consultar las tablas de origen y crear nuevos segmentos. Una vez creada la fuente conectada, Braze detecta los nombres y las descripciones de todas las tablas disponibles para el usuario en el esquema de origen.

Puedes conceder acceso a todas las tablas de un esquema o conceder privilegios solo a tablas específicas. Las tablas a las que tenga acceso el rol de Braze están disponibles para consultarse en la extensión de segmento CDI.

El permiso CREATE TABLE es necesario para que Braze pueda crear una tabla con los resultados de la consulta de tu extensión de segmento CDI antes de actualizar el segmento en Braze. Braze crea una tabla temporal por segmento, que solo persiste mientras Braze actualiza el segmento.

oauth m2m
personal access token

Crea una entidad de servicio, genera un secreto de cliente y concede a la entidad de servicio el permiso Can use en tu almacén SQL. Para ver los pasos, consulta Crear credenciales para Braze.
Concede a la entidad de servicio acceso al esquema usado para la fuente conectada, incluido CREATE TABLE. Usa el ID de aplicación de la entidad de servicio (el mismo valor que el ID de cliente) como beneficiario de la concesión.

GRANT USE CATALOG ON CATALOG `BRAZE-CLOUD-PRODUCTION` TO `APPLICATION_ID`;
GRANT USE SCHEMA, CREATE TABLE ON SCHEMA `BRAZE-CLOUD-PRODUCTION`.INGESTION TO `APPLICATION_ID`;
GRANT SELECT ON SCHEMA `BRAZE-CLOUD-PRODUCTION`.INGESTION TO `APPLICATION_ID`;

Sustituye APPLICATION_ID por el ID de aplicación de tu entidad de servicio.

Guarda el ID de cliente y el secreto en un lugar seguro hasta que necesites introducirlos en el panel de Braze durante el paso de creación de credenciales.

En tu espacio de trabajo de Databricks, selecciona tu nombre de usuario de Databricks en la barra superior y, a continuación, selecciona User Settings en el desplegable.
Asegúrate de que la cuenta de servicio tenga privilegios CREATE TABLE en el esquema usado para la fuente conectada.
En la pestaña Access tokens, selecciona Generate new token.
Introduce un comentario que te ayude a identificar este token, como “Braze CDI”, y cambia la vigencia del token a sin vigencia dejando vacío (en blanco) el cuadro Lifetime (days).
Selecciona Generate.
Copia el token que se muestra y, a continuación, selecciona Done.

Guarda el token en un lugar seguro hasta que necesites introducirlo en el panel de Braze durante el paso de creación de credenciales.

Paso 2.2: Permite el acceso a las IP de Braze

Si tienes políticas de red, debes dar a Braze acceso de red a tu instancia de Databricks. Permite el acceso desde las siguientes IP correspondientes a la región de tu panel de Braze.

Para las instancias US-01, US-02, US-03, US-04, US-05, US-06, US-07, estas son las direcciones IP correspondientes:

23.21.118.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

Para la instancia US-08, estas son las direcciones IP correspondientes:

52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145

Para la instancia US-10, estas son las direcciones IP correspondientes:

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Para las instancias EU-01 y EU-02, estas son las direcciones IP correspondientes:

52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

Para la instancia AU-01, estas son las direcciones IP correspondientes:

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Para la instancia ID-01, estas son las direcciones IP correspondientes:

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

Para la instancia JP-01, estas son las direcciones IP correspondientes:

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

Para la instancia KR-01, estas son las direcciones IP correspondientes:

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

Paso 2.1: Concede acceso a los recursos de Fabric

Braze se conectará a tu almacén de Fabric usando una entidad de servicio con autenticación de Entra ID. Crearás una nueva entidad de servicio para que la use Braze y concederás acceso a los recursos de Fabric según sea necesario. Braze necesitará los siguientes datos para conectarse:

ID de tenant (también llamado directorio) de tu cuenta de Azure
ID de principal (también llamado ID de aplicación) del service principal
Secreto de cliente para que Braze se autentique

En el portal de Azure, ve al centro de administración de Microsoft Entra y luego a App Registrations.
Selecciona + New registration en Identity > Applications > App registrations.
Introduce un nombre y selecciona Accounts in this organizational directory only como tipo de cuenta compatible. Luego, selecciona Register.
Selecciona la aplicación (entidad de servicio) que acabas de crear y luego ve a Certificates & secrets > + New client secret.
Introduce una descripción para el secreto y establece un periodo de caducidad para el secreto. Luego, selecciona Add.
Toma nota del secreto de cliente creado para usarlo en la configuración de Braze.

Nota

Azure no permite una caducidad ilimitada en los secretos de las entidades de servicio. Recuerda renovar las credenciales antes de que caduquen para mantener el flujo de datos hacia Braze.

Paso 2.2: Concede acceso a los recursos de Fabric

Darás acceso a Braze para que se conecte a tu instancia de Fabric. En tu portal de administración de Fabric, ve a Settings > Governance and insights > Admin portal > Tenant settings.

En Developer settings, habilita “Service principals can use Fabric APIs” para que Braze pueda conectarse usando Microsoft Entra ID.
En OneLake settings, habilita “Users can access data stored in OneLake with apps external to Fabric” para que la entidad de servicio pueda acceder a los datos desde una aplicación externa.

Paso 2.3: Obtén la cadena de conexión del almacén

Necesitarás el endpoint SQL de tu almacén para que Braze pueda conectarse. Para obtener el endpoint SQL, ve al espacio de trabajo en Fabric y, en la lista de elementos, pasa el cursor sobre el nombre del almacén y selecciona Copy SQL connection string. Ten este valor a mano para configurar las credenciales en el paso 3.

Paso 2.4: Permite las IP de Braze en el firewall (opcional)

Según la configuración de tu cuenta de Microsoft Fabric, es posible que tengas que permitir las siguientes direcciones IP en tu firewall para permitir el tráfico procedente de Braze. Para más información sobre cómo habilitarlo, consulta la documentación correspondiente sobre Entra Conditional Access.

Para las instancias US-01, US-02, US-03, US-04, US-05, US-06, US-07, estas son las direcciones IP correspondientes:

23.21.118.191
34.206.23.173
50.16.249.9
52.4.160.214
54.87.8.34
54.156.35.251
52.54.89.238
18.205.178.15

Para la instancia US-08, estas son las direcciones IP correspondientes:

52.151.246.51
52.170.163.182
40.76.166.157
40.76.166.170
40.76.166.167
40.76.166.161
40.76.166.156
40.76.166.166
40.76.166.160
40.88.51.74
52.154.67.17
40.76.166.80
40.76.166.84
40.76.166.85
40.76.166.81
40.76.166.71
40.76.166.144
40.76.166.145

Para la instancia US-10, estas son las direcciones IP correspondientes:

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Para las instancias EU-01 y EU-02, estas son las direcciones IP correspondientes:

52.58.142.242
52.29.193.121
35.158.29.228
18.157.135.97
3.123.166.46
3.64.27.36
3.65.88.25
3.68.144.188
3.70.107.88

Para la instancia AU-01, estas son las direcciones IP correspondientes:

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Para la instancia ID-01, estas son las direcciones IP correspondientes:

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

Para la instancia JP-01, estas son las direcciones IP correspondientes:

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

Para la instancia KR-01, estas son las direcciones IP correspondientes:

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

Paso 3: Crea una fuente conectada en el panel de Braze

Paso 3.1: Añade la información de conexión de Snowflake y la tabla de origen

Crea una fuente conectada en el panel de Braze. Ve a Configuración de datos > Ingesta de datos en la nube > Fuentes conectadas, selecciona Añadir origen de datos y, a continuación, selecciona Snowflake.

En Configurar origen, introduce lo siguiente:

Nombre de la credencial y el método de autenticación, Workload Identity Federation o Par de claves
Credenciales: Localizador de cuenta, Nombre de usuario y Rol
Configuración: Almacén, Base de datos y Esquema

Para Workload Identity Federation, selecciona Copiar instrucción, ejecútala en una hoja de cálculo de Snowflake y, a continuación, selecciona Guardar credencial. Para un par de claves, selecciona Guardar credenciales y generar clave RSA antes de probar la conexión.

Paso 3.2: Configura los detalles de sincronización

Elige un nombre para la fuente conectada. Este nombre se usará en la lista de fuentes disponibles cuando crees una nueva extensión de segmento CDI.

Configura un tiempo de ejecución máximo para esta fuente. Braze cancelará automáticamente cualquier consulta que supere el tiempo de ejecución máximo. El tiempo de ejecución máximo permitido es de 60 minutos; un tiempo de ejecución menor reducirá los costos generados en tu cuenta de Snowflake. Esta configuración se aplica a las consultas ejecutadas a través de esta fuente, incluidas las sincronizaciones y las extensiones de segmento CDI que la usan.

Nota

Si las consultas agotan el tiempo de espera de forma constante y has establecido un tiempo de ejecución máximo de 60 minutos, plantéate optimizar el tiempo de ejecución de tu consulta o dedicar un almacén más grande al usuario de Braze.

Paso 3.3: Anota la clave pública (par de claves)

En el paso Probar conexión, anota la clave pública RSA. La necesitarás para completar la integración en Snowflake.

Paso 3.1: Añade la información de conexión de Redshift y la tabla de origen

En Configurar origen, introduce lo siguiente:

Credenciales: URL del host de Redshift, Nombre de usuario, Contraseña y Puerto
Configuración: Base de datos y Esquema

Si es necesario, habilita Conectar con túnel SSH e introduce Host del túnel, Puerto del túnel y Nombre de usuario del túnel.

Paso 3.2: Configura los detalles de sincronización

Elige un nombre para la fuente conectada. Este nombre se usará en la lista de fuentes disponibles cuando crees una nueva extensión de segmento CDI.

Configura un tiempo de ejecución máximo para esta fuente. Braze cancelará automáticamente cualquier consulta que supere el tiempo de ejecución máximo. El tiempo de ejecución máximo permitido es de 60 minutos; un tiempo de ejecución menor reducirá los costos generados en tu cuenta de Redshift. Esta configuración se aplica a las consultas ejecutadas a través de esta fuente, incluidas las sincronizaciones y las extensiones de segmento CDI que la usan.

Nota

Paso 3.3: Anota la clave pública (opcional)

Si tus credenciales tienen seleccionada la opción Conectar con túnel SSH, anota la clave pública RSA en el paso Probar conexión. La necesitarás para completar la integración en Redshift.

Paso 3.1: Añade la información de conexión de BigQuery y la tabla de origen

En Configurar origen, introduce lo siguiente:

Credenciales: Nombre de la credencial y método de autenticación, además de Número de proyecto, ID del grupo de identidades de carga de trabajo, ID del proveedor y Correo electrónico de la cuenta de servicio (Workload Identity Federation) o la Clave JSON que hayas subido (clave de cuenta de servicio)
Configuración: Proyecto y Conjunto de datos

Paso 3.2: Configura los detalles de sincronización

Elige un nombre para la fuente conectada. Este nombre se usará en la lista de fuentes disponibles cuando crees una nueva extensión de segmento CDI.

Configura un tiempo de ejecución máximo para esta fuente. Braze cancelará automáticamente cualquier consulta que supere el tiempo de ejecución máximo. El tiempo de ejecución máximo permitido es de 60 minutos; un tiempo de ejecución menor reducirá los costos generados en tu cuenta de BigQuery. Esta configuración se aplica a las consultas ejecutadas a través de esta fuente, incluidas las sincronizaciones y las extensiones de segmento CDI que la usan.

Nota

Paso 3.3: Prueba la conexión

Selecciona Probar conexión para comprobar que la lista de tablas visibles para el usuario es la que esperas y, a continuación, selecciona Listo. Tu fuente conectada ya está creada y lista para usarse en extensiones de segmento CDI.

Paso 3.1: Añade la información de conexión de Databricks y la tabla de origen

En Configurar origen, introduce lo siguiente:

Credenciales: Nombre de la credencial, Método de autenticación, Nombre de host y Ruta HTTP, además de ID de cliente y Secreto de cliente (OAuth M2M) o Token de acceso (token de acceso personal)
Configuración: Catálogo y Esquema

Paso 3.2: Configura los detalles de sincronización

Elige un nombre para la fuente conectada. Este nombre se usará en la lista de fuentes disponibles cuando crees una nueva extensión de segmento CDI.

Configura un tiempo de ejecución máximo para esta fuente. Braze cancelará automáticamente cualquier consulta que supere el tiempo de ejecución máximo. El tiempo de ejecución máximo permitido es de 60 minutos; un tiempo de ejecución menor reducirá los costos generados en tu cuenta de Databricks. Esta configuración se aplica a las consultas ejecutadas a través de esta fuente, incluidas las sincronizaciones y las extensiones de segmento CDI que la usan.

Nota

Paso 3.3: Prueba la conexión

Paso 3.1: Añade la información de conexión de Microsoft Fabric y la tabla de origen

En Configurar origen, introduce lo siguiente:

Credenciales: Nombre de las credenciales, ID de inquilino, ID principal, Secreto de cliente y Cadena de conexión
Configuración: Base de datos y Esquema

Si Conectar con túnel SSH está disponible en tu espacio de trabajo y lo necesitas para tu configuración, introduce también Host del túnel, Puerto del túnel y Nombre de usuario del túnel.

Paso 3.2: Configura los detalles de sincronización

Elige un nombre para la fuente conectada. Este nombre se usará en la lista de fuentes disponibles cuando crees una nueva extensión de segmento CDI.

Configura un tiempo de ejecución máximo para esta fuente. Braze cancelará automáticamente cualquier consulta que supere el tiempo de ejecución máximo. El tiempo de ejecución máximo permitido es de 60 minutos; un tiempo de ejecución menor reducirá los costos generados en tu cuenta de Microsoft Fabric. Esta configuración se aplica a las consultas ejecutadas a través de esta fuente, incluidas las sincronizaciones y las extensiones de segmento CDI que la usan.

Nota

Paso 3.3: Prueba la conexión

Paso 4: Finaliza la configuración del almacén de datos

workload identity federation
key pair

Ya ejecutaste la instrucción del formulario de credenciales en un paso anterior. Selecciona Probar conexión en Braze y, a continuación, selecciona Listo. Tu fuente conectada ya está creada y lista para usarse en extensiones de segmento CDI.

Añade la clave pública que anotaste en el paso anterior a tu usuario en Snowflake. Esto permite que Braze se conecte a Snowflake. Para más detalles, consulta Autenticación con par de claves de Snowflake.

ALTER USER BRAZE_INGESTION_USER SET rsa_public_key='{INSERT_YOUR_KEY}';

Para rotar la clave más adelante, ve a Configuración de datos > Ingesta de datos en la nube > Credenciales, abre la credencial en Credenciales de acceso a datos de Snowflake y selecciona Rotar credencial. Para ver el modal de detalles, consulta Revisar una credencial de Snowflake.

Después de añadir la clave al usuario en Snowflake, selecciona Probar conexión en Braze y, a continuación, selecciona Listo. Tu fuente conectada ya está creada y lista para usarse en extensiones de segmento CDI.

Si te conectas con un túnel SSH, añade la clave pública que anotaste en el paso anterior al usuario del túnel SSH.

Después de añadir la clave al usuario, selecciona Probar conexión en Braze y, a continuación, selecciona Listo. Tu fuente conectada ya está creada y lista para usarse en extensiones de segmento CDI.

Esto no se aplica a BigQuery.

Esto no se aplica a Databricks.

Esto no se aplica a Microsoft Fabric.

Nota

Debes probar correctamente una fuente antes de que pueda pasar del estado “borrador” al estado “activo”. Si necesitas cerrar la página de creación, tu integración se guardará y podrás volver a la página de detalles para hacer cambios y probarla.

Configurar integraciones o usuarios adicionales (opcional)

Puedes configurar varias integraciones con Braze, pero cada integración debe configurarse para conectarse a un esquema diferente. Al crear conexiones adicionales, puedes reutilizar las credenciales existentes si te conectas a la misma cuenta de Snowflake.

Si reutilizas el mismo usuario y rol de par de claves en varias integraciones, no necesitas volver a añadir la clave pública. Una credencial de Workload Identity Federation no tiene ninguna clave pública que añadir.

Puedes configurar varios orígenes con Braze, pero cada origen debe configurarse para conectarse a un esquema diferente. Al crear orígenes adicionales, puedes reutilizar las credenciales existentes si te conectas a la misma cuenta de Redshift.

Puedes configurar varios orígenes con Braze, pero cada origen debe configurarse para conectarse a un conjunto de datos diferente. Al crear orígenes adicionales, puedes reutilizar las credenciales existentes si te conectas a la misma cuenta de BigQuery.

Uso de la fuente conectada

Después de crear la fuente, puedes usarla para crear una o más extensiones de segmento de CDI. Para obtener más información sobre cómo crear un segmento con esta fuente, consulta la documentación sobre las extensiones de segmento de CDI.

Nota

Si las consultas agotan el tiempo de espera de forma constante y has establecido un tiempo de ejecución máximo de 60 minutos, considera optimizar el tiempo de ejecución de tus consultas o dedicar más recursos informáticos (como un almacén de datos más grande) al usuario de Braze.

New Stuff!