メインコンテンツまでスキップ
に最終更新

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

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://my-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
備考

ベータ版

HubSpot CRM Hub オブジェクトのインジェストはベータ版です。ワークスペース管理者は、hubspot_connector_crm_objects プレビューにオプトインすることで、 プレビュー ページからこの機能へのアクセスを制御できます。Databricks のプレビューを管理するを参照してください。

このプレビューを有効にしている場合は、HubSpot CRM Hub オブジェクトを取り込むために、以下のスコープも 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.schemas.companies.read
  • crm.schemas.contacts.read
  • crm.schemas.deals.read
  • crm.schemas.line_items.read
  • crm.schemas.orders.read
  • sales-email-read
  • tickets

  1. HubSpot アカウントにアプリをデプロイしてください：

    Bash
    hs project upload

  2. アプリの認証の詳細を取得する：

    Bash
    hs project open

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

  3. 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 を持つユーザーは、そこからパイプラインを作成できます。HubSpot 接続の作成を参照してください。

このページの見出し