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

Xeroに対する認証の構成

備考

ベータ版

この機能はベータ版です。使用するには、ワークスペース管理者が Previews ページから Xero 用 Lakeflow Connect を有効にする必要があります。Databricksのプレビューを管理を参照してください。

Lakeflow Connect Xeroコネクタの認証を許可するには、Xero開発者ポータルでウェブアプリを作成し、取り込む組織のテナントIDをメモします。このページのステップから取得した認証情報を使用して、Databricksで Unity Catalog 接続を作成します。

前提条件​

  • トライアルまたは有料のXeroサブスクリプション上のXero組織。コネクタをテストするには、Xeroデモ会社を使用します。入門を参照してください。
  • Xero開発者アカウント（無料）。アプリの開発者価格レベルによって、アプリが接続できる組織の数と1日のAPI呼び出し制限が決まります。
  • 接続を承認するユーザーは、[接続されたアプリ]権限を持つ組織に対して、[標準]、[アドバイザー]、または[管理者]アクセス権を持っている必要があります。「パーミッション」を参照してください。
  • projects テーブルを取り込むには、組織がサブスクリプションに Xero Projects を追加する必要があり、認証を行うユーザーが Xero Projects ユーザー ロールを持っている必要があります。「 Xero Projects サブスクリプションの管理」および「 Projects API の概要」を参照してください。
  • アプリのリダイレクト URI を設定するための Databricks ワークスペースドメイン。

Xero の設定​

Xeroコネクタは、Xeroウェブアプリを通じたOAuthのユーザー・ツー・マシン（U2M）認可で認証を行います。このステップでは、アプリを作成し、DatabricksのリダイレクトURIを登録して、接続ページで入力する認証情報をメモします。情報については、「Xero OAuth 2.0の概要」を参照してください。

  1. Xero開発者ポータルにサインインし、 マイアプリ をクリックします。
  2. 「 新しいアプリ 」をクリックします。
  3. [新しい Xero アプリの追加] ダイアログで、 [アプリ名] を入力し、 [統合タイプ] として [Web アプリ] を選択します。
  4. AIモデルのトレーニングとXeroの最小セキュリティ要件に関する質問に回答します。
  5. 会社またはアプリケーションURL に、会社のURLを入力します。
  6. OAuth 2.0リダイレクトURI に https://<your-databricks-workspace-domain>/login/oauth/http.html を入力します。
  7. Xero Developer Platformの利用規約に同意するには、チェックボックスを選択してから アプリを作成 をクリックします。
  8. アプリで「 構成 」tabをクリックし、「 シークレットの生成 」をクリックします。Xeroはシークレットを1回だけ表示します。
  9. クライアントID とクライアントシークレットを保存してください。これらの認証情報を使用して、DatabricksでUnity Catalog接続を作成してください。

このコネクタは、サインインするときに読み取り専用スコープの固定セットを要求するため、アプリでスコープを構成する必要はありません。リストについては、「必要なOAuth権限」を参照してください。

テナントIDの確認​

各パイプラインは 1 つの Xero 組織を取り込み、必要な tenant_id オプション名を指定します。Xero は、アプリが接続する各組織をテナント ID で識別します。「テナント」を参照してください。

  1. 組織に対して承認されたアクセストークンを使用して GET https://api.xero.com/connections を呼び出します。リクエストに Xero-Tenant-Id ヘッダーは必要ありません。たとえば、Xero API Explorer を開き、 Connect your Xero organisation をクリックし、組織を選択してリクエストを実行します。
  2. 応答には、接続されているテナントごとに 1 つのエントリがリストされます。tenantName が組織と一致するエントリを見つけ、その tenantId 値をメモします。id ではなく tenantId を使用してください。これは接続を識別するものです。

次のステップ​

Databricks に Xero 接続を作成します。「Xero 接続の作成」を参照してください。

このページの見出し