Aller au contenu principal
Dernière mise à jour le

Configurer OAuth pour l'ingestion HubSpot

Le connecteur HubSpot managé dans Lakeflow Connect utilise l’authentification OAuth 2.0 utilisateur à machine (U2M). Utilisez les détails d’authentification que vous récupérez à partir des étapes sur cette page pour créer une connexion Unity Catalog dans Databricks.

remarque

HubSpot a retiré l'interface utilisateur de création d'applications publiques héritée. Créez votre application à l'aide de la plateforme basée sur des projets de HubSpot et du CLI HubSpot, comme décrit sur cette page. Consultez le journal des modifications HubSpot pour plus de détails.

Installer et authentifier la CLI HubSpot​

  1. Installez Node.js version 20 ou supérieure.

  2. Installer le HubSpot CLI :

    Bash
    npm install -g @hubspot/cli

  3. Authentifiez le CLI avec votre compte HubSpot :

    Bash
    hs account auth

    Suivez les invites pour générer une clé d'accès personnelle et l'enregistrer dans votre configuration CLI locale.

Créer une application et récupérer les détails d’authentification​

  1. Créez une application sur la plateforme basée sur les projets de HubSpot :

    Bash
    hs project create --project-base app --auth oauth --distribution private

  2. Dans le fichier app-hsmeta.json généré, définissez auth.redirectUrls sur l'URL de redirection de votre workspace (format : https://<your_workspace_domain>/login/oauth/lakehousefederation.html). Par exemple : https://my-workspace.cloud.databricks.com/login/oauth/lakehousefederation.html

  3. Dans le même fichier, définissez auth.requiredScopes sur uniquement les périmètres suivants. L’omission de l’un de ces éléments, ou l’ajout de périmètres non répertoriés sur cette page, entraînera des échecs ultérieurs dans le processus de configuration.

    • oauth
    • communication_preferences.read
    • content
    • crm.objects.marketing_events.read
    • crm.objects.marketing_events.write
    • forms
    • forms-uploaded-files
    • marketing.campaigns.read
info

Bêta

L’ingestion d’objets HubSpot CRM Hub est en bêta. Les administrateurs de Workspace peuvent contrôler l’accès à cette fonctionnalité depuis la page Aperçus en choisissant l’aperçu hubspot_connector_crm_objects. Consultez Gérer les aperçus Databricks.

Si vous avez activé cette prévisualisation, ajoutez également les périmètres suivants à auth.requiredScopes:

  • crm.objects.companies.read
  • crm.objects.contacts.read
  • crm.objects.deals.read
  • crm.objects.leads.read
  • crm.objects.line_items.read
  • crm.objects.orders.read
  • crm.objects.owners.read
  • crm.objects.products.read
  • crm.objects.tickets.read
  • crm.schemas.companies.read
  • crm.schemas.contacts.read
  • crm.schemas.deals.read
  • crm.schemas.line_items.read
  • crm.schemas.orders.read
  • sales-email-read

  1. Déployez l’application sur votre compte HubSpot :

    Bash
    hs project upload

  2. Récupérez les détails d'authentification de l'application :

    Bash
    hs project open

    Sous Composants du projet, sélectionnez votre application, puis cliquez sur l'Auth tab. Notez l' ID du client et le Secret du client . Utilisez-les pour créer une connexion Unity Catalog dans Databricks.

  3. Installez l'application dans votre compte HubSpot :

    1. Accédez à Développement > Projets .
    2. Sélectionnez votre projet, puis sélectionnez votre application.
    3. Dans le **Distribution** tab, cliquez sur **Installer maintenant** et autorisez l'application.

Migrer une application héritée​

Si vous avez déjà une application publique héritée configurée pour l'ingestion HubSpot, migrez-la vers la plateforme basée sur les projets au lieu de créer une nouvelle application. La migration préserve l'ID client, le secret client et les installations existants de votre application, de sorte que vous n'avez pas besoin de mettre à jour votre connexion Unity Catalog.

  1. Mettez à jour le HubSpot CLI vers la version 7,6,0. ou version ultérieure :

    Bash
    npm install -g @hubspot/cli@latest

  2. Exécutez la commande de migration et suivez les invites pour sélectionner votre application et confirmer les composants à migrer :

    Bash
    hs app migrate

Pour plus de détails, consultez le guide de migration de HubSpot.

Extension d'un pipeline HubSpot existant avec des objets CRM​

Si vous possédez déjà un pipeline HubSpot configuré sans les objets CRM et que vous souhaitez l’étendre pour les inclure, suivez les instructions ci-dessous :

  1. Inscrivez votre workspace à la version préliminaire de Hubspot Connector CRM Hub Objects . Consultez Gérer les aperçus Databricks.

  2. Dans votre application HubSpot, ajoutez les périmètres d’objets CRM à auth.requiredScopes dans app-hsmeta.json. Pour consulter la liste des périmètres d’objets CRM, reportez-vous à la page Create an app and retrieve authentication details.

  3. Redéployez l'application sur votre compte HubSpot :

    Bash
    hs project upload

  4. Réautorisez la connexion Unity Catalog existante : sur votre interface utilisateur Databricks, accédez à votre connexion UC HubSpot associée au pipeline, cliquez sur Edit et suivez les étapes pour vous reconnecter à HubSpot afin qu'elle prenne en compte les étendues ajoutées. Consultez la page Create a HubSpot connection.

Vous pouvez désormais modifier le pipeline afin d'inclure les objets CRM. Voir Ingérer des données depuis HubSpot.

Étapes suivantes​

Utilisez l’Explorateur de catalogue pour créer une connexion. Tout utilisateur disposant de USE CONNECTION ou ALL PRIVILEGES peut alors créer des pipelines à partir de celle-ci. Consultez Créer une connexion HubSpot.

Sur cette page