メインコンテンツまでスキップ

HubSpot取り込み用のOAuthを構成する

HubSpot マーケティング Hub からDatabricksへの取り込み用に HubSpot を構成する方法を学びます。 LakeFlow Connectの管理対象 HubSpot コネクタは、 OAuth 2.0 ユーザー対マシン (U2M) 認証を使用します。 このページのステップから取得した認証詳細を使用して、 DatabricksでUnity Catalog接続を作成します。

注記

HubSpotは、従来の公開アプリ作成UIを廃止しました。このページで説明されているように、HubSpotのプロジェクトベースのプラットフォームとHubSpot CLIを使用してアプリを作成してください。詳細は、HubSpotの変更履歴をご覧ください。

HubSpot CLI をインストールして認証する

  1. Node.jsバージョン20以降をインストールしてください。

  2. HubSpot CLIをインストール:

    Bash
    npm install -g @hubspot/cli
  3. HubSpot アカウントで CLI を認証します:

    Bash
    hs account auth

    プロンプトに従って個人アクセストークンを生成し、ローカルのCLI設定に保存してください。

アプリケーションを作成し、認証の詳細を取得します。

  1. HubSpotのプロジェクトベースプラットフォームでアプリを作成する:

    Bash
    hs project create --project-base app --auth oauth --distribution private
  2. 生成されたapp-hsmeta.jsonファイルで、auth.redirectUrlsをワークスペースのリダイレクトURL(形式: https://<your_workspace_domain>/login/oauth/lakehousefederation.html)に設定します。例えば: https://e2.our-staging-workspace.cloud.databricks.com/login/oauth/lakehousefederation.html

  3. 同じファイルで、auth.requiredScopes を *のみ* 次のスコープに設定します。これらのいずれかを省略したり、追加のスコープを追加したりすると、セットアッププロセスで後で障害が発生します。

    • oauth
    • communication_preferences.read
    • content
    • crm.objects.marketing_events.read
    • crm.objects.marketing_events.write
    • forms
    • forms-uploaded-files
    • marketing.campaigns.read
  4. HubSpot アカウントにアプリをデプロイしてください:

    Bash
    hs project upload
  5. アプリの認証の詳細を取得する:

    Bash
    hs project open

    Project Components でアプリを選択し、 Auth tabをクリックします。 クライアントIDクライアントシークレット をメモしてください。これらを使用して、DatabricksでUnity Catalog接続を作成してください。

  6. HubSpot アカウントにアプリをインストールしてください:

    1. 「**Development** > **Projects**」に移動します。
    2. プロジェクトを選択し、アプリを選択してください。
    3. Distribution tabで、 今すぐインストール をクリックし、アプリを承認します。

レガシーアプリを移行する

HubSpot の取り込み用に従来の公開アプリがすでに構成されている場合は、新しいアプリを作成する代わりに、プロジェクトベースのプラットフォームに移行してください。移行により、アプリの既存のクライアント ID、クライアント シークレット、およびインストールも保持されるため、Unity Catalog 接続を更新する必要はありません。

  1. HubSpot CLIをバージョン7.6.0に更新します以降:

    Bash
    npm install -g @hubspot/cli@latest
  2. 移行コマンドを実行し、プロンプトに従ってアプリを選択し、移行するコンポーネントを確認してください。

    Bash
    hs app migrate

詳細については、HubSpotの移行ガイドを参照してください。

次のステップ

USE CONNECTION または ALL PRIVILEGES を持つユーザーがパイプラインを作成できるように、Catalog Explorer を使用して接続を作成してください。HubSpot接続を作成するをご覧ください。