HubSpot取り込み用のOAuthを構成する
HubSpot マーケティング Hub からDatabricksへの取り込み用に HubSpot を構成する方法を学びます。 LakeFlow Connectの管理対象 HubSpot コネクタは、 OAuth 2.0 ユーザー対マシン (U2M) 認証を使用します。 このページのステップから取得した認証詳細を使用して、 DatabricksでUnity Catalog接続を作成します。
HubSpotは、従来の公開アプリ作成UIを廃止しました。このページで説明されているように、HubSpotのプロジェクトベースのプラットフォームとHubSpot CLIを使用してアプリを作成してください。詳細は、HubSpotの変更履歴をご覧ください。
HubSpot CLI をインストールして認証する
-
Node.jsバージョン20以降をインストールしてください。
-
HubSpot CLIをインストール:
Bashnpm install -g @hubspot/cli -
HubSpot アカウントで CLI を認証します:
Bashhs account authプロンプトに従って個人アクセストークンを生成し、ローカルのCLI設定に保存してください。
アプリケーションを作成し、認証の詳細を取得します。
-
HubSpotのプロジェクトベースプラットフォームでアプリを作成する:
Bashhs project create --project-base app --auth oauth --distribution private -
生成された
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 -
同じファイルで、
auth.requiredScopesを *のみ* 次のスコープに設定します。これらのいずれかを省略したり、追加のスコープを追加したりすると、セットアッププロセスで後で障害が発生します。oauthcommunication_preferences.readcontentcrm.objects.marketing_events.readcrm.objects.marketing_events.writeformsforms-uploaded-filesmarketing.campaigns.read
-
HubSpot アカウントにアプリをデプロイしてください:
Bashhs project upload -
アプリの認証の詳細を取得する:
Bashhs project openProject Components でアプリを選択し、 Auth tabをクリックします。 クライアントID と クライアントシークレット をメモしてください。これらを使用して、DatabricksでUnity Catalog接続を作成してください。
-
HubSpot アカウントにアプリをインストールしてください:
- 「**Development** > **Projects**」に移動します。
- プロジェクトを選択し、アプリを選択してください。
- Distribution tabで、 今すぐインストール をクリックし、アプリを承認します。
レガシーアプリを移行する
HubSpot の取り込み用に従来の公開アプリがすでに構成されている場合は、新しいアプリを作成する代わりに、プロジェクトベースのプラットフォームに移行してください。移行により、アプリの既存のクライアント ID、クライアント シークレット、およびインストールも保持されるため、Unity Catalog 接続を更新する必要はありません。
-
HubSpot CLIをバージョン7.6.0に更新します以降:
Bashnpm install -g @hubspot/cli@latest -
移行コマンドを実行し、プロンプトに従ってアプリを選択し、移行するコンポーネントを確認してください。
Bashhs app migrate
詳細については、HubSpotの移行ガイドを参照してください。
次のステップ
USE CONNECTION または ALL PRIVILEGES を持つユーザーがパイプラインを作成できるように、Catalog Explorer を使用して接続を作成してください。HubSpot接続を作成するをご覧ください。