Configurer l'authentification auprès de SendGrid

info

Bêta

This feature is in Beta. Pour l’utiliser, un administrateur du workspace doit activer Lakeflow Connect for SendGrid depuis la page Previews . See Manage Databricks previews.

Cette page montre comment configurer SendGrid pour activer l’authentification depuis Databricks pour le connecteur SendGrid. Le connecteur SendGrid utilise une clé d’API SendGrid pour ingérer des données dans Databricks. Utilisez les identifiants récupérés lors des étapes décrites sur cette page pour créer une connexion Unity Catalog dans Databricks.

Prérequis

• Un compte SendGrid sur un forfait API e-mail Pro ou Premier , ou un forfait Advanced Marketing Campaigns. Les sous-utilisateurs ne sont disponibles que sur ces forfaits. Pour plus d’informations, consultez Subusers dans la documentation SendGrid.
• Accès administrateur pour créer une clé API avec un accès en lecture aux données de Subusers, IP Access Management, Suppressions, Unsubscribe Groups, Marketing et Template.
• Pour ingérer les tables contacts, lists, segments, singlesends, singlesend_stats et automations_stats, vous devez disposer d’un compte SendGrid dans lequel Marketing Campaigns est activé.
• Si votre compte a activé IP Access Management, les adresses IP de sortie Databricks serverless doivent figurer sur votre liste d’autorisations. SendGrid bloque l’accès à l’API depuis les adresses IP qui ne figurent pas sur la liste.

Configurer SendGrid

Créez une clé API SendGrid avec un accès en lecture aux APIs correspondant aux tables que vous souhaitez ingérer. Pour plus d’informations, consultez les clés API dans la documentation SendGrid.

1. Connectez-vous à l'application SendGrid en tant qu'administrateur.

2. Dans la navigation de gauche, sélectionnez Paramètres > Clés API .

3. Cliquez sur Créer une clé API .

4. Saisissez un nom pour la clé, puis sélectionnez Accès personnalisé .

5. Accordez un accès en lecture aux autorisations suivantes, en fonction des tables que vous souhaitez ingérer. Pour connaître l’étendue de la clé API correspondant à chaque autorisation, consultez Autorisations des clés API dans la documentation de SendGrid.

Autorisation	Portée de la clé API	Tables
Gestion de l’accès IP	Accès en lecture	recent_access_attempts, parent_access_attempts
Sous-utilisateurs	Accès en lecture	subusers, recent_access_attempts
Suppressions	suppression.read	bounces, spam_reports, global_suppressions, blocks, invalid_emails
Groupes de désabonnement	asm.groups.read	suppression_groups, suppression_group_members
Marketing	marketing.read	contacts, lists, segments, singlesends, singlesend_stats, automations_stats
Templates	templates.read	templates

Autorisation	Portée de la clé API	Tables
Gestion de l’accès IP	Accès en lecture	recent_access_attempts, parent_access_attempts
Sous-utilisateurs	Accès en lecture	subusers, recent_access_attempts
Suppressions	suppression.read	bounces, spam_reports, global_suppressions, blocks, invalid_emails
Groupes de désabonnement	asm.groups.read	suppression_groups, suppression_group_members
Marketing	marketing.read	contacts, lists, segments, singlesends, singlesend_stats, automations_stats
Templates	templates.read	templates

Gardez chaque catégorie d’autorisations développée pendant que vous effectuez vos sélections. La réduction d’une catégorie peut déclencher un Reset de ses sélections. 6. Cliquez sur Créer et afficher , puis copiez la clé générée. SendGrid n’affiche la valeur de la clé qu’une seule fois.

7. Stockez la clé en lieu sûr. Vous saisissez cette valeur comme clé API lorsque vous créez une connexion dans Databricks. Saisissez uniquement la valeur de la clé, sans le préfixe Bearer.

Notez la région des données de votre compte SendGrid. Les comptes dont les données résident dans l’UE utilisent api.eu.sendgrid.com; tous les autres comptes utilisent l’endpoint global api.sendgrid.com. Vous sélectionnez cette région lorsque vous créez la connexion. Les tables Marketing Campaigns (contacts, lists, segments, singlesends, singlesend_stats et automations_stats) sont disponibles uniquement pour les comptes de la région des États-Unis. Ne les sélectionnez pas sur une connexion qui utilise la région eu.

La clé d’API ne lit les données que pour le compte auquel elle appartient. Pour ingérer des données provenant de plusieurs comptes ou sous-utilisateurs SendGrid, créez une clé d’API et une connexion distinctes pour chacun d’eux.

Étapes suivantes

Créez une connexion SendGrid dans Databricks. Voir Créer une connexion SendGrid.