Aller au contenu principal
Dernière mise à jour le

Configurer OAuth pour l'ingestion HubSpot

Découvrez comment configurer HubSpot pour l’ingestion de données de HubSpot Marketing Hub dans Databricks. Le connecteur HubSpot géré 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 de 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://e2.our-staging-workspace.cloud.databricks.com/login/oauth/lakehousefederation.html

  3. Dans le même fichier, définissez auth.requiredScopes sur uniquement les portées suivantes. Omettre l'un de ces éléments ou ajouter des périmètres supplémentaires entraînera des échecs plus tard 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

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

    Bash
    hs project upload

  5. 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.

  6. 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.

Étapes suivantes​

Utilisez l'Explorateur de catalogues pour créer une connexion afin que tout utilisateur disposant de USE CONNECTION ou ALL PRIVILEGES puisse créer des pipelines. Consultez Créer une connexion HubSpot.

Sur cette page