Passer au contenu

Cette page a été traduite automatiquement et peut contenir des inexactitudes. Pour signaler une erreur de traduction, utilisez le module de commentaires en bas de la table des matières, à droite de la page.

Sources connectées

Les sources connectées offrent une alternative sans copie à la synchronisation directe des données avec la fonctionnalité d’ingestion de données cloud (CDI) de Braze. Une source connectée interroge directement votre entrepôt de données pour créer de nouveaux Segments, sans copier aucune des données sous-jacentes dans Braze.

Après avoir ajouté une source connectée à votre espace de travail Braze, vous pouvez créer un Segment CDI dans les extensions de segments. Les extensions de segments CDI vous permettent d’écrire du code SQL qui interroge directement votre entrepôt de données (en utilisant les données mises à disposition via votre source connectée CDI), puis de créer et de maintenir un groupe d’utilisateurs que vous pouvez cibler dans Braze.

Pour en savoir plus sur la création d’un Segment avec cette source, consultez les extensions de segments CDI.

Avertissement

Comme les sources connectées s’exécutent directement sur votre entrepôt de données, vous supportez l’ensemble des coûts liés à l’exécution de ces requêtes dans votre entrepôt de données. Les sources connectées n’enregistrent pas de points de données, et les extensions de segments CDI ne consomment pas de crédits de segments SQL.

Intégrer des sources connectées

Étape 1 : Connecter vos ressources

Les sources connectées de Cloud Data Ingestion nécessitent une configuration côté Braze et dans votre instance. Suivez ces étapes pour configurer l’intégration. Certaines étapes se font dans votre entrepôt de données, d’autres dans votre tableau de bord de Braze.

Dans votre entrepôt de données

Créez un rôle et accordez-lui les autorisations nécessaires pour interroger et créer des tables dans un schéma.
Configurez votre entrepôt et donnez-y accès à ce rôle.
Créez un utilisateur pour ce rôle avec Workload Identity Federation ou une paire de clés RSA.
Selon votre configuration, vous devrez peut-être autoriser les adresses IP de Braze dans votre politique réseau Snowflake.

Dans le tableau de bord de Braze

Créez une nouvelle source connectée dans le tableau de bord de Braze.
Configurez les détails de synchronisation de la source connectée.
Pour une paire de clés RSA, récupérez la clé publique. Pour Workload Identity Federation, copiez l’instruction depuis le formulaire d’identifiants.

Dans votre entrepôt de données

Pour une paire de clés RSA, ajoutez la clé publique à l’utilisateur Snowflake pour l’authentification. Pour Workload Identity Federation, exécutez l’instruction dans une feuille de calcul Snowflake. Une fois terminé, vous pouvez utiliser la source connectée pour créer une ou plusieurs extensions de segments CDI.

Configurez les données sources et les ressources requises dans votre environnement Redshift.
Créez une nouvelle source connectée dans le tableau de bord de Braze.
Testez l’intégration.
Utilisez la source connectée pour créer une ou plusieurs extensions de segments CDI.

Configurez les données sources et les ressources requises dans votre environnement BigQuery.
Créez un compte de service auquel Braze accède via Workload Identity Federation ou une clé de compte de service, et autorisez l’accès aux projets et jeux de données BigQuery qui contiennent les données à synchroniser.
Créez une nouvelle source connectée dans le tableau de bord de Braze.
Testez l’intégration.
Utilisez la source connectée pour créer une ou plusieurs extensions de segments CDI.

Configurez les données sources et les ressources requises dans votre environnement Databricks.
Créez un principal de service pour l’authentification OAuth machine à machine (M2M) ou un jeton d’accès personnel, et autorisez l’accès aux catalogues et schémas Databricks qui contiennent les données à synchroniser.
Créez une nouvelle source connectée dans le tableau de bord de Braze.
Testez l’intégration.
Utilisez la source connectée pour créer une ou plusieurs extensions de segments CDI.

Important

Un temps de démarrage de deux à cinq minutes peut être nécessaire lorsque Braze se connecte aux instances SQL Classic et Pro, ce qui entraîne des délais lors de la configuration et du test de la connexion, ainsi que lors de la création et de l’actualisation des extensions de segments CDI. Une instance SQL serverless réduit ce temps de démarrage et améliore le débit des requêtes, mais peut entraîner des coûts d’intégration légèrement plus élevés.

Créez un principal de service et autorisez-le à accéder à l’espace de travail Fabric utilisé pour votre intégration.
Dans votre espace de travail Fabric, configurez les données sources et accordez les autorisations à votre principal de service.
Créez une nouvelle source connectée dans le tableau de bord de Braze.
Testez l’intégration.
Utilisez la source connectée pour créer une ou plusieurs extensions de segments CDI.

Étape 2 : Configurer votre entrepôt de données

Configurez les données sources et les ressources requises dans votre environnement d’entrepôt de données. La source connectée peut faire référence à une ou plusieurs tables : assurez-vous donc que votre utilisateur Braze a l’autorisation d’accéder à toutes les tables que vous souhaitez inclure dans la source connectée.

Étape 2.1 : Créer un rôle et accorder des autorisations

Créez un rôle que votre source connectée utilisera. Ce rôle servira à générer la liste des tables disponibles dans vos extensions de segments CDI et à interroger les tables sources pour créer de nouveaux segments. Une fois la source connectée créée, Braze découvrira les noms et descriptions de toutes les tables accessibles à l’utilisateur dans le schéma source.

L’autorisation create table est requise pour que Braze puisse créer une table contenant les résultats de la requête de votre extension de segments CDI avant de mettre à jour le segment dans Braze. Braze crée une table temporaire par segment, qui n’existe que pendant la mise à jour du segment par Braze.

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;

Étape 2.2 : Configurer l’entrepôt et donner accès au rôle Braze

CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;

GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

Remarque

L’option auto-resume doit être activée sur l’entrepôt. Si ce n’est pas le cas, vous devrez accorder à Braze des privilèges OPERATE supplémentaires sur l’entrepôt pour que Braze puisse l’activer au moment d’exécuter la requête.

Étape 2.3 : Configurer l’utilisateur

Braze s’authentifie auprès de Snowflake avec Workload Identity Federation ou une paire de clés RSA. Les identifiants existants par paire de clés RSA continuent de fonctionner et vous n’avez pas besoin de les migrer. Suivez l’une des deux méthodes.

workload identity federation
key pair

Utilisez les autorisations de rôle et d’entrepôt décrites à l’étape 2.1 et à l’étape 2.2. Si votre compte Snowflake utilise une politique réseau, autorisez les adresses IP de Braze comme décrit à l’étape 2.4.

Créez l’utilisateur de service à partir du formulaire d’identifiants Snowflake, puis exécutez cette instruction dans une feuille de calcul Snowflake. Pour savoir ce que fait l’instruction et où l’exécuter, consultez la section Configurer Snowflake pour Workload Identity Federation.

CREATE USER BRAZE_INGESTION_USER;

GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;

Vous partagerez les informations de connexion avec Braze et recevrez une clé publique à ajouter à l’utilisateur lors d’une étape ultérieure.

Remarque

Lorsque vous connectez différents espaces de travail au même compte Snowflake, vous devez créer un utilisateur unique pour chaque espace de travail Braze dans lequel vous créez une intégration. Au sein d’un même espace de travail, vous pouvez réutiliser le même utilisateur pour plusieurs intégrations, mais la création de l’intégration échouera si un utilisateur du même compte Snowflake est dupliqué entre plusieurs espaces de travail.

Étape 2.4 : Autoriser les adresses IP de Braze dans votre politique réseau Snowflake (facultatif)

Selon la configuration de votre compte Snowflake, vous devrez peut-être autoriser les adresses IP suivantes dans votre politique réseau Snowflake. Pour plus d’informations, consultez la documentation Snowflake sur la modification d’une politique réseau.

Pour les instances US-01, US-02, US-03, US-04, US-05, US-06, US-07, voici les adresses IP correspondantes :

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

Pour l’instance US-08, voici les adresses IP correspondantes :

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

Pour l’instance US-10, voici les adresses IP correspondantes :

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Pour les instances EU-01 et EU-02, voici les adresses IP correspondantes :

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

Pour l’instance AU-01, voici les adresses IP correspondantes :

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Pour l’instance ID-01, voici les adresses IP correspondantes :

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

Pour l’instance JP-01, voici les adresses IP correspondantes :

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

Pour l’instance KR-01, voici les adresses IP correspondantes :

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

Étape 2.1 : Créer un utilisateur et accorder des autorisations

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;

Créez un utilisateur que votre source connectée utilisera. Cet utilisateur servira à générer la liste des tables disponibles dans vos extensions de segments CDI et à interroger les tables sources pour créer de nouveaux segments. Une fois la source connectée créée, Braze découvrira les noms et descriptions de toutes les tables accessibles à l’utilisateur dans le schéma source. Si vous créez plusieurs intégrations CDI, vous pouvez accorder des autorisations sur un schéma ou gérer les autorisations à l’aide d’un groupe.

Vous pouvez accorder l’accès à toutes les tables d’un schéma, ou uniquement à certaines tables. Toutes les tables auxquelles le rôle Braze a accès pourront être interrogées dans l’extension de segments CDI. Veillez à accorder à l’utilisateur l’accès aux nouvelles tables lors de leur création, ou définissez des autorisations par défaut pour l’utilisateur.

Étape 2.2 : Autoriser l’accès aux adresses IP de Braze

Si vous disposez d’un pare-feu ou d’autres politiques réseau, vous devez accorder à Braze un accès réseau à votre instance Redshift. Autorisez l’accès depuis les adresses IP suivantes correspondant à la région de votre tableau de bord de Braze.

Vous devrez peut-être aussi modifier vos groupes de sécurité pour permettre à Braze d’accéder à vos données dans Redshift. Veillez à autoriser explicitement le trafic entrant depuis les adresses IP de la section suivante et sur le port utilisé pour interroger votre cluster Redshift (5439 par défaut). Vous devez autoriser explicitement la connectivité TCP Redshift sur ce port, même si les règles entrantes sont définies sur « tout autoriser ». En outre, l’endpoint du cluster Redshift doit être accessible publiquement pour que Braze puisse se connecter à votre cluster.

Si vous ne souhaitez pas que votre cluster Redshift soit accessible publiquement, vous pouvez configurer un VPC et une instance EC2 afin d’utiliser un tunnel SSH pour accéder aux données Redshift. Pour plus d’informations, consultez AWS : How do I access a private Amazon Redshift cluster from my local machine?

Pour les instances US-01, US-02, US-03, US-04, US-05, US-06, US-07, voici les adresses IP correspondantes :

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

Pour l’instance US-08, voici les adresses IP correspondantes :

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

Pour l’instance US-10, voici les adresses IP correspondantes :

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Pour les instances EU-01 et EU-02, voici les adresses IP correspondantes :

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

Pour l’instance AU-01, voici les adresses IP correspondantes :

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Pour l’instance ID-01, voici les adresses IP correspondantes :

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

Pour l’instance JP-01, voici les adresses IP correspondantes :

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

Pour l’instance KR-01, voici les adresses IP correspondantes :

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

Étape 2.1 : Créer des identifiants pour Braze

Créez dans GCP un compte de service que Braze utilisera pour se connecter à vos tables et en lire les données. Le compte de service doit disposer des autorisations suivantes :

BigQuery Connection User : permet à Braze d’établir des connexions.
BigQuery User : permet à Braze d’exécuter des requêtes, de lire les métadonnées des jeux de données et de lister les tables.
BigQuery Data Viewer : permet à Braze de consulter les jeux de données et leur contenu.
BigQuery Job User : permet à Braze d’exécuter des tâches.
bigquery.tables.create permet à Braze de créer des tables temporaires lors de l’actualisation des segments.

Créez un compte de service que votre source connectée utilisera. Cet utilisateur servira à générer la liste des tables disponibles dans vos extensions de segments CDI et à interroger les tables sources pour créer de nouveaux segments. Une fois la source connectée créée, Braze découvrira les noms et descriptions de toutes les tables accessibles à l’utilisateur dans le schéma source.

Vous pouvez accorder l’accès à toutes les tables d’un jeu de données, ou uniquement à certaines tables. Toutes les tables auxquelles le rôle Braze a accès pourront être interrogées dans l’extension de segments CDI.

Braze peut accéder au compte de service avec Workload Identity Federation ou une clé de compte de service. Les identifiants existants par clé de compte de service continuent de fonctionner et vous n’avez pas besoin de les migrer. Un même identifiant Workload Identity Federation peut servir à la fois pour les sources BigQuery et Google Cloud Storage.

workload identity federation
service account key

Configurez un pool d’identités de charge de travail, un fournisseur et le compte de service, puis associez le principal Braze au compte de service. Pour connaître la procédure, consultez la section Configurer Google Cloud pour Workload Identity Federation. Si vous avez déjà configuré Workload Identity Federation pour une autre source BigQuery ou Google Cloud Storage, vous n’avez pas besoin de recommencer. Accordez simplement au compte de service existant les autorisations listées à cette étape.

Après avoir créé le compte de service et accordé les autorisations, générez une clé JSON. Pour plus d’informations, consultez Google Cloud : Créer et supprimer des clés de compte de service. Vous la téléchargerez dans le tableau de bord de Braze plus tard.

Étape 2.2 : Autoriser l’accès aux adresses IP de Braze

Si vous avez mis en place des politiques réseau, vous devez accorder à Braze un accès réseau à votre instance BigQuery. Autorisez l’accès depuis les adresses IP suivantes correspondant à la région de votre tableau de bord de Braze.

Pour les instances US-01, US-02, US-03, US-04, US-05, US-06, US-07, voici les adresses IP correspondantes :

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

Pour l’instance US-08, voici les adresses IP correspondantes :

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

Pour l’instance US-10, voici les adresses IP correspondantes :

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Pour les instances EU-01 et EU-02, voici les adresses IP correspondantes :

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

Pour l’instance AU-01, voici les adresses IP correspondantes :

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Pour l’instance ID-01, voici les adresses IP correspondantes :

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

Pour l’instance JP-01, voici les adresses IP correspondantes :

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

Pour l’instance KR-01, voici les adresses IP correspondantes :

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

Étape 2.1 : Créer des identifiants pour Braze

Braze peut se connecter à Databricks avec OAuth machine à machine (M2M) via un principal de service, ou avec un jeton d’accès personnel. Braze recommande OAuth M2M. Les identifiants existants par jeton d’accès personnel continuent de fonctionner et vous n’avez pas besoin de les migrer.

Quelle que soit la méthode choisie, Braze utilise ces identifiants pour générer la liste des tables disponibles dans vos extensions de segments CDI et pour interroger les tables sources afin de créer de nouveaux segments. Une fois la source connectée créée, Braze découvre les noms et descriptions de toutes les tables accessibles à l’utilisateur dans le schéma source.

Vous pouvez accorder l’accès à toutes les tables d’un schéma, ou uniquement à certaines tables. Toutes les tables auxquelles le rôle Braze a accès peuvent être interrogées dans l’extension de segments CDI.

L’autorisation CREATE TABLE est requise pour que Braze puisse créer une table contenant les résultats de la requête de votre extension de segments CDI avant de mettre à jour le segment dans Braze. Braze crée une table temporaire par segment, qui n’existe que pendant la mise à jour du segment par Braze.

oauth m2m
personal access token

Créez un principal de service, générez un secret client et accordez au principal de service l’autorisation Can use sur votre entrepôt SQL. Pour connaître la procédure, consultez la section Créer des identifiants pour Braze.
Accordez au principal de service l’accès au schéma utilisé pour la source connectée, y compris CREATE TABLE. Utilisez l’ID d’application du principal de service (la même valeur que l’ID client) comme bénéficiaire.

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`;

Remplacez APPLICATION_ID par l’ID d’application de votre principal de service.

Conservez l’ID client et le secret en lieu sûr jusqu’à ce que vous deviez les saisir dans le tableau de bord de Braze lors de l’étape de création des identifiants.

Dans votre espace de travail Databricks, sélectionnez votre nom d’utilisateur Databricks dans la barre supérieure, puis sélectionnez User Settings dans le menu déroulant.
Assurez-vous que le compte de service dispose des privilèges CREATE TABLE sur le schéma utilisé pour la source connectée.
Dans l’onglet Access tokens, sélectionnez Generate new token.
Saisissez un commentaire qui vous aidera à identifier ce jeton, par exemple « Braze CDI », et définissez une durée de vie illimitée en laissant le champ Lifetime (days) vide.
Sélectionnez Generate.
Copiez le jeton affiché, puis sélectionnez Done.

Conservez le jeton en lieu sûr jusqu’à ce que vous deviez le saisir dans le tableau de bord de Braze lors de l’étape de création des identifiants.

Étape 2.2 : Autoriser l’accès aux adresses IP de Braze

Si vous avez mis en place des politiques réseau, vous devez accorder à Braze un accès réseau à votre instance Databricks. Autorisez l’accès depuis les adresses IP suivantes correspondant à la région de votre tableau de bord de Braze.

Pour les instances US-01, US-02, US-03, US-04, US-05, US-06, US-07, voici les adresses IP correspondantes :

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

Pour l’instance US-08, voici les adresses IP correspondantes :

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

Pour l’instance US-10, voici les adresses IP correspondantes :

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Pour les instances EU-01 et EU-02, voici les adresses IP correspondantes :

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

Pour l’instance AU-01, voici les adresses IP correspondantes :

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Pour l’instance ID-01, voici les adresses IP correspondantes :

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

Pour l’instance JP-01, voici les adresses IP correspondantes :

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

Pour l’instance KR-01, voici les adresses IP correspondantes :

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

Étape 2.1 : Accorder l’accès aux ressources Fabric

Braze se connectera à votre entrepôt Fabric à l’aide d’un principal de service avec authentification Entra ID. Vous allez créer un nouveau principal de service que Braze utilisera, et lui accorder l’accès aux ressources Fabric nécessaires. Braze aura besoin des informations suivantes pour se connecter :

ID de locataire (également appelé répertoire) de votre compte Azure
ID de principal (également appelé ID d’application) pour le principal de service
Secret client pour permettre à Braze de s’authentifier

Dans le portail Azure, accédez au centre d’administration Microsoft Entra, puis à App Registrations.
Sélectionnez + New registration sous Identity > Applications > App registrations.
Saisissez un nom et sélectionnez Accounts in this organizational directory only comme type de compte pris en charge. Ensuite, sélectionnez Register.
Sélectionnez l’application (principal de service) que vous venez de créer, puis accédez à Certificates & secrets > + New client secret.
Saisissez une description pour le secret et définissez une période d’expiration. Ensuite, sélectionnez Add.
Notez le secret client créé afin de l’utiliser lors de la configuration de Braze.

Remarque

Azure n’autorise pas d’expiration illimitée pour les secrets de principal de service. Pensez à actualiser les identifiants avant leur expiration afin de maintenir le flux de données vers Braze.

Étape 2.2 : Accorder l’accès aux ressources Fabric

Vous allez permettre à Braze de se connecter à votre instance Fabric. Dans votre portail d’administration Fabric, accédez à Settings > Governance and insights > Admin portal > Tenant settings.

Dans Developer settings, activez « Service principals can use Fabric APIs » pour que Braze puisse se connecter avec Microsoft Entra ID.
Dans OneLake settings, activez « Users can access data stored in OneLake with apps external to Fabric » pour que le principal de service puisse accéder aux données depuis une application externe.

Étape 2.3 : Obtenir la chaîne de connexion de l’entrepôt

Vous aurez besoin de l’endpoint SQL de votre entrepôt pour que Braze puisse se connecter. Pour récupérer l’endpoint SQL, accédez à l’espace de travail dans Fabric, puis, dans la liste des éléments, survolez le nom de l’entrepôt et sélectionnez Copy SQL connection string. Gardez cette valeur à portée de main pour la configuration des identifiants à l’étape 3.

Étape 2.4 : Autoriser les adresses IP de Braze dans le pare-feu (facultatif)

Selon la configuration de votre compte Microsoft Fabric, vous devrez peut-être autoriser les adresses IP suivantes dans votre pare-feu afin de permettre le trafic provenant de Braze. Pour plus d’informations, consultez la documentation sur l’accès conditionnel Entra.

Pour les instances US-01, US-02, US-03, US-04, US-05, US-06, US-07, voici les adresses IP correspondantes :

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

Pour l’instance US-08, voici les adresses IP correspondantes :

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

Pour l’instance US-10, voici les adresses IP correspondantes :

100.25.232.164
35.168.86.179
52.7.44.117
3.92.153.18
35.172.3.129
50.19.162.19

Pour les instances EU-01 et EU-02, voici les adresses IP correspondantes :

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

Pour l’instance AU-01, voici les adresses IP correspondantes :

13.210.1.145
13.211.70.159
13.238.45.54
52.65.73.167
54.153.242.239
54.206.45.213

Pour l’instance ID-01, voici les adresses IP correspondantes :

108.136.157.246
108.137.30.207
16.78.128.71
16.78.14.134
16.78.162.208
43.218.73.35

Pour l’instance JP-01, voici les adresses IP correspondantes :

13.159.155.212
54.199.221.241
13.192.23.16
54.250.120.139
18.181.114.232
3.114.38.100

Pour l’instance KR-01, voici les adresses IP correspondantes :

43.200.215.4
52.79.67.175
52.79.113.60
3.34.212.92
54.116.134.231
3.37.197.225

Étape 3 : Créer une source connectée dans le tableau de bord de Braze

Étape 3.1 : Ajouter les informations de connexion Snowflake et la table source

Créez une source connectée dans le tableau de bord de Braze. Accédez à Paramètres des données > Ingestion de données cloud > Sources connectées, sélectionnez Ajouter une source de données, puis sélectionnez Snowflake.

Dans Configurer la source, saisissez les informations suivantes :

Nom des identifiants et la méthode d’authentification, Workload Identity Federation ou Paire de clés
Identifiants : Localisateur de compte, Nom d’utilisateur et Rôle
Configuration : Entrepôt, Base de données et Schéma

Pour Workload Identity Federation, sélectionnez Copier l’instruction, exécutez-la dans une feuille de calcul Snowflake, puis sélectionnez Enregistrer les identifiants. Pour une paire de clés, sélectionnez Enregistrer les identifiants et générer la clé RSA avant de tester la connexion.

Étape 3.2 : Configurer les détails de synchronisation

Choisissez un nom pour la source connectée. Ce nom apparaîtra dans la liste des sources disponibles lorsque vous créerez une nouvelle extension de segments CDI.

Configurez une durée d’exécution maximale pour cette source. Braze interrompt automatiquement toute requête qui dépasse cette durée. La durée d’exécution maximale autorisée est de 60 minutes ; une durée plus courte réduit les coûts engagés sur votre compte Snowflake. Ce paramètre s’applique aux requêtes exécutées via cette source, y compris les synchronisations et les extensions de segments CDI qui l’utilisent.

Remarque

Si les requêtes expirent régulièrement alors que vous avez défini une durée d’exécution maximale de 60 minutes, essayez d’optimiser le temps d’exécution de vos requêtes ou de dédier un entrepôt plus puissant à l’utilisateur Braze.

Étape 3.3 : Noter la clé publique (paire de clés)

À l’étape Tester la connexion, notez la clé publique RSA. Vous en aurez besoin pour finaliser l’intégration dans Snowflake.

Étape 3.1 : Ajouter les informations de connexion Redshift et la table source

Dans Configurer la source, saisissez les informations suivantes :

Identifiants : URL de l’hôte Redshift, Nom d’utilisateur, Mot de passe et Port
Configuration : Base de données et Schéma

Si nécessaire, activez Connecter avec un tunnel SSH et saisissez Hôte du tunnel, Port du tunnel et Nom d’utilisateur du tunnel.

Étape 3.2 : Configurer les détails de synchronisation

Choisissez un nom pour la source connectée. Ce nom apparaîtra dans la liste des sources disponibles lorsque vous créerez une nouvelle extension de segments CDI.

Configurez une durée d’exécution maximale pour cette source. Braze interrompt automatiquement toute requête qui dépasse cette durée. La durée d’exécution maximale autorisée est de 60 minutes ; une durée plus courte réduit les coûts engagés sur votre compte Redshift. Ce paramètre s’applique aux requêtes exécutées via cette source, y compris les synchronisations et les extensions de segments CDI qui l’utilisent.

Remarque

Étape 3.3 : Noter la clé publique (facultatif)

Si l’option Connecter avec un tunnel SSH est sélectionnée pour vos identifiants, notez la clé publique RSA à l’étape Tester la connexion. Vous en aurez besoin pour finaliser l’intégration dans Redshift.

Étape 3.1 : Ajouter les informations de connexion BigQuery et la table source

Dans Configurer la source, saisissez les informations suivantes :

Identifiants : Nom des identifiants et méthode d’authentification, ainsi que Numéro de projet, ID du pool d’identités de charge de travail, ID du fournisseur et E-mail du compte de service (Workload Identity Federation) ou votre Clé JSON téléchargée (clé de compte de service)
Configuration : Projet et Jeu de données

Étape 3.2 : Configurer les détails de synchronisation

Choisissez un nom pour la source connectée. Ce nom apparaîtra dans la liste des sources disponibles lorsque vous créerez une nouvelle extension de segments CDI.

Configurez une durée d’exécution maximale pour cette source. Braze interrompt automatiquement toute requête qui dépasse cette durée. La durée d’exécution maximale autorisée est de 60 minutes ; une durée plus courte réduit les coûts engagés sur votre compte BigQuery. Ce paramètre s’applique aux requêtes exécutées via cette source, y compris les synchronisations et les extensions de segments CDI qui l’utilisent.

Remarque

Étape 3.3 : Tester la connexion

Sélectionnez Tester la connexion pour vérifier que la liste des tables visibles par l’utilisateur correspond à vos attentes, puis sélectionnez Terminé. Votre source connectée est maintenant créée et prête à être utilisée dans les extensions de segments CDI.

Étape 3.1 : Ajouter les informations de connexion Databricks et la table source

Dans Configurer la source, saisissez les informations suivantes :

Identifiants : Nom des identifiants, Méthode d’authentification, Nom d’hôte et Chemin HTTP, ainsi que ID client et Secret client (OAuth M2M) ou Jeton d’accès (jeton d’accès personnel)
Configuration : Catalogue et Schéma

Étape 3.2 : Configurer les détails de synchronisation

Choisissez un nom pour la source connectée. Ce nom apparaîtra dans la liste des sources disponibles lorsque vous créerez une nouvelle extension de segments CDI.

Configurez une durée d’exécution maximale pour cette source. Braze interrompt automatiquement toute requête qui dépasse cette durée. La durée d’exécution maximale autorisée est de 60 minutes ; une durée plus courte réduit les coûts engagés sur votre compte Databricks. Ce paramètre s’applique aux requêtes exécutées via cette source, y compris les synchronisations et les extensions de segments CDI qui l’utilisent.

Remarque

Étape 3.3 : Tester la connexion

Étape 3.1 : Ajouter les informations de connexion Microsoft Fabric et la table source

Dans Configurer la source, saisissez les informations suivantes :

Identifiants : Nom des identifiants, ID du locataire, ID du principal, Secret client et Chaîne de connexion
Configuration : Base de données et Schéma

Si l’option Connecter avec un tunnel SSH est disponible dans votre espace de travail et nécessaire pour votre configuration, saisissez également Hôte du tunnel, Port du tunnel et Nom d’utilisateur du tunnel.

Étape 3.2 : Configurer les détails de synchronisation

Choisissez un nom pour la source connectée. Ce nom apparaîtra dans la liste des sources disponibles lorsque vous créerez une nouvelle extension de segments CDI.

Configurez une durée d’exécution maximale pour cette source. Braze interrompt automatiquement toute requête qui dépasse cette durée. La durée d’exécution maximale autorisée est de 60 minutes ; une durée plus courte réduit les coûts engagés sur votre compte Microsoft Fabric. Ce paramètre s’applique aux requêtes exécutées via cette source, y compris les synchronisations et les extensions de segments CDI qui l’utilisent.

Remarque

Si les requêtes expirent régulièrement alors que vous avez défini une durée d’exécution maximale de 60 minutes, essayez d’optimiser le temps d’exécution de vos requêtes ou d’augmenter la capacité Fabric.

Étape 3.3 : Tester la connexion

Étape 4 : Finaliser la configuration de l’entrepôt de données

workload identity federation
key pair

Vous avez exécuté l’instruction du formulaire d’identifiants lors d’une étape précédente. Sélectionnez Tester la connexion dans Braze, puis Terminé. Votre source connectée est maintenant créée et prête à être utilisée dans les extensions de segments CDI.

Ajoutez la clé publique notée à l’étape précédente à votre utilisateur dans Snowflake. Cela permet à Braze de se connecter à Snowflake. Pour plus de détails, consultez la section Authentification par paire de clés Snowflake.

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

Pour renouveler la clé ultérieurement, accédez à Paramètres des données > Ingestion de données cloud > Identifiants, ouvrez les identifiants sous Identifiants d’accès aux données Snowflake, puis sélectionnez Renouveler les identifiants. Pour en savoir plus sur la fenêtre modale de détails, consultez la section Examiner des identifiants Snowflake.

Une fois la clé ajoutée à l’utilisateur dans Snowflake, sélectionnez Tester la connexion dans Braze, puis Terminé. Votre source connectée est maintenant créée et prête à être utilisée dans les extensions de segments CDI.

Si vous vous connectez avec un tunnel SSH, ajoutez la clé publique notée à l’étape précédente à l’utilisateur du tunnel SSH.

Une fois la clé ajoutée à l’utilisateur, sélectionnez Tester la connexion dans Braze, puis Terminé. Votre source connectée est maintenant créée et prête à être utilisée dans les extensions de segments CDI.

Cette étape ne s’applique pas à BigQuery.

Cette étape ne s’applique pas à Databricks.

Cette étape ne s’applique pas à Microsoft Fabric.

Remarque

Vous devez tester une source avec succès avant qu’elle puisse passer de l’état « brouillon » à l’état « actif ». Si vous devez fermer la page de création, votre intégration sera enregistrée et vous pourrez revenir sur la page de détails pour apporter des modifications et effectuer le test.

Configuration d’intégrations ou d’utilisateurs supplémentaires (facultatif)

Vous pouvez configurer plusieurs intégrations avec Braze, mais chaque intégration doit être configurée pour se connecter à un schéma différent. Lorsque vous créez des connexions supplémentaires, vous pouvez réutiliser des identifiants existants si vous vous connectez au même compte Snowflake.

Si vous réutilisez le même utilisateur et le même rôle à paire de clés dans plusieurs intégrations, vous n’avez pas besoin d’ajouter à nouveau la clé publique. Un identifiant Workload Identity Federation n’a pas de clé publique à ajouter.

Vous pouvez configurer plusieurs sources avec Braze, mais chaque source doit être configurée pour se connecter à un schéma différent. Lorsque vous créez des sources supplémentaires, vous pouvez réutiliser des identifiants existants si vous vous connectez au même compte Redshift.

Vous pouvez configurer plusieurs sources avec Braze, mais chaque source doit être configurée pour se connecter à un jeu de données différent. Lorsque vous créez des sources supplémentaires, vous pouvez réutiliser des identifiants existants si vous vous connectez au même compte BigQuery.

Utilisation de la source connectée

Une fois la source créée, vous pouvez l’utiliser pour créer une ou plusieurs extensions de segments CDI. Pour plus d’informations sur la création d’un segment à partir de cette source, consultez la documentation sur les extensions de segments CDI.

Remarque

Si les requêtes expirent régulièrement alors que vous avez défini une durée d’exécution maximale de 60 minutes, essayez d’optimiser le temps d’exécution de vos requêtes ou d’allouer davantage de ressources de calcul (par exemple, un entrepôt plus grand) à l’utilisateur Braze.

New Stuff!