Jitterbit でライブ PingOne のデータと連携

Mohsin Turki
Mohsin Turki
Technical Marketing Engineer
CData Connect AI を使用して、Jitterbit でライブ PingOne のデータ に接続・連携します。

Jitterbit は、データワークフローを効率化できるエンタープライズ iPaaS（Integration Platform as a Service）です。CData Connect AI と組み合わせることで、Jitterbit からライブ PingOne のデータ にアクセスできます。この記事では、Connect AI を使用して PingOne に接続し、Jitterbit でライブ PingOne のデータ と連携する方法を説明します。

CData Connect AI は PingOne 用の純粋な OData インターフェースを提供し、ネイティブにサポートされているデータベースにデータをレプリケーションすることなく、PingOne からデータをクエリできます。CData Connect AI は最適化されたデータ処理機能を標準で備えており、サポートされているすべての SQL 操作（フィルタ、JOIN など）を PingOne に直接プッシュし、サーバーサイド処理を活用して、リクエストされた PingOne のデータ を迅速に返します。

Jitterbit 向けに PingOne 接続を構成

Jitterbit から PingOne のデータ を操作するには、Connect AI から PingOne に接続し、ユーザーにアクセス権を付与し、PingOne のデータ 用のワークスペースを作成する必要があります。

Connect AI から PingOne に接続

CData Connect AI は、シンプルなポイント＆クリック インターフェースを使用してデータソースに接続します。

  1. Connect AI にログインし、Sources をクリックして、 Add Connection をクリックします。
    2. 接続の追加
  2. Add Connection パネルから「PingOne」を選択します。
    3. データソースの選択
  3. PingOne に接続するために必要な認証プロパティを入力します。

    PingOne に接続するには以下のプロパティを設定します。

    • Region：自身のPingOne 組織のデータがホスティングされている地域。
    • AuthScheme：PingOne に接続する際に使用する認証の種類。
    • WorkerAppEnvironmentId （デフォルトのPingOne ドメインを使用する場合に必要）、またはAuthorizationServerURL のいずれかで、下で説明するように設定します。

    WorkerAppEnvironmentId の設定

    WorkerAppEnvironmentId は、Worker アプリケーションが存在するPingOne 環境のID です。 このパラメータは、環境がデフォルトのPingOne ドメイン（auth.pingone）を利用している場合のみ使用されます。 これは、ヘルプドキュメントのカスタムOAuth アプリケーションの作成で説明するように、PingOne への認証に使用するカスタムOAuth アプリケーションを作成した後に設定します。

    はじめに、このプロパティの値を見つけます。

    1. 自身のPingOne 組織のホームページからナビゲーションサイドバーに移動し、Environments をクリックします。
    2. OAuth / Worker のカスタムアプリケーションを作成した環境（通常はAdministrators）を見つけ、Manage Environment をクリックします。 環境のホームページが表示されます。
    3. 環境のホームページのナビゲーションサイドバーで、Applications をクリックします。
    4. リストから、OAuth またはWorker アプリケーションの詳細を見つけます。
    5. Environment ID フィールドの値をコピーします。 以下の例に似たものになるはずです：
      WorkerAppEnvironmentId='11e96fc7-aa4d-4a60-8196-9acf91424eca'

    次に、WorkerAppEnvironmentId をEnvironment ID フィールドの値に設定します。

    AuthorizationServerURL の設定

    AuthorizationServerURL は、お使いのアプリケーションが配置されている環境のPingOne 認可サーバーのベースURL です。 このプロパティは、PingOne プラットフォームAPI ドキュメントで説明されているように、環境にカスタムドメインを設定した場合にのみ使用されます。 Custom Domains を参照してください。

    OAuth でのPingOne への認証

    PingOne はOAuth とOAuthClient 認証の両方をサポートしています。 上述の設定手順に加え、OAuth またはOAuthCliet 認証をサポートするために、さらに2つの手順を完了する必要があります。

    • ヘルプドキュメントのカスタムOAuth アプリケーションの作成で説明するように、カスタムOAuth アプリケーションを作成して設定します。
    • ドライバーがデータモデル内のエンティティにアクセスできるようにするには、ヘルプドキュメントのAdministrator Roles での説明のとおり、使用するアドミンユーザー / ワーカーアプリケーションに対して正しいロールを設定していることを確認してください。
    • 以下のサブセクションで説明されているように、選択した認証スキームと認証フローに適切なプロパティを設定します。

    OAuth（認可コードグラント）

    AuthScheme をOAuth に設定します。

    デスクトップアプリケーション

    OAuth アクセストークンの取得およびリフレッシュ

    以下を設定して、接続してください。

    • InitiateOAuth：GETANDREFRESH。繰り返しOAuth の交換を行ったり、手動でOAuthAccessToken を設定する必要をなくすには、InitiateOAuth を使用します。
    • OAuthClientId：カスタムOAuth アプリケーションを作成した際に取得したClient ID。
    • OAuthClientSecret：カスタムOAuth アプリケーションを作成した際に取得したClient Secret。
    • CallbackURL：カスタムOAuth アプリケーションの登録時に定義したリダイレクトURI。例：https://localhost:3333

    接続すると、CData 製品 はデフォルトブラウザでPingOne のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。 ドライバーはこれでOAuth プロセスを完了します。

    1. ドライバーはPingOne からアクセストークンを取得し、それを使ってデータをリクエストします。
    2. OAuth 値はOAuthSettingsLocation で指定された場所に保存され、接続間で永続化されるようにします。

    ドライバーはアクセストークンの期限が切れると自動的にリフレッシュします。

    Web アプリケーションやヘッドレスマシン、クライアントクレデンシャルグラントを含むその他のOAuth メソッドについては、ヘルプドキュメントを参照してください。

    接続の構成（Salesforce の例）
  4. Save & Test をクリックします。
  5. Add PingOne Connection ページの Permissions タブに移動し、User-based permissions を更新します。 権限の更新

パーソナルアクセストークンの追加

REST API、OData API、または仮想 SQL Server を介して Connect AI に接続する場合、パーソナルアクセストークン（PAT）を使用して Connect AI への接続を認証します。アクセスの粒度を維持するために、サービスごとに別々の PAT を作成することをお勧めします。

  1. Connect AI アプリの右上にある歯車アイコン（）をクリックして、設定ページを開きます。
  2. Settings ページで Access Tokens セクションに移動し、 Create PAT をクリックします。
  3. PAT に名前を付け、Create をクリックします。 新しい PAT の作成
  4. パーソナルアクセストークンは作成時にのみ表示されるため、必ずコピーして安全な場所に保存してください。

Jitterbit 向けに PingOne エンドポイントを構成

PingOne に接続した後、目的のテーブル用のワークスペースを作成します。

  1. Workspaces ページに移動し、 Add をクリックして新しいワークスペースを作成します（または既存のワークスペースを選択します）。 Workspaces ページ 新しいワークスペースの追加
  2. Add をクリックして、ワークスペースに新しいアセットを追加します。
  3. PingOne 接続（例：PingOne1）を選択し、Next をクリックします。 アセットの選択（Salesforce の例）
  4. 操作するテーブルを選択し、Confirm をクリックします。 テーブルの選択（Salesforce の例）
  5. ワークスペースの OData Service URL（例：https://cloud.cdata.com/api/odata/{workspace_name}）をメモしておきます。

接続、PAT、およびワークスペースの構成が完了すると、Jitterbit から PingOne のデータ に接続する準備が整います。

Connect AI を使用して Jitterbit から PingOne に接続

OData プロトコルを使用して Jitterbit から CData Connect AI への接続を確立するには、以下の手順に従います。

  1. Jitterbit にログインします。
  2. Cloud Studio でプロジェクトを作成し、ワークスペース環境を設定します。 Jitterbit での新規プロジェクト作成
  3. Sources をクリックし、検索バーに OData と入力します。
  4. OData コネクタを選択します。
  5. OData 接続プロパティを入力します。
    • Connection Name：接続名を入力します。
    • OData Metadata URL：https://cloud.cdata.com/api/odata/{workspace_name} と入力します。
    • Authentication：Basic Auth を選択します。
    • User Name：CData Connect AI のユーザー名を入力します。これは CData Connect AI インターフェースの右上に表示されます（例：[email protected]）。
    • Password：Settings ページで生成した PAT を入力します。
    Connect AI OData エンドポイントへの接続の構成
  6. Test をクリックして接続をテストし、Save Changes をクリックします。
  7. 実行する操作を選択し、プロジェクトのワークフローにドラッグします。 ワークフロー用の操作の選択
  8. クエリ操作をダブルクリックすると、OData エンドポイントで使用可能なすべてのテーブルと派生ビューが表示されます。 使用可能なエンドポイントの表示
  9. テーブルを選択し、クエリを構成します。

これで、Jitterbit でライブ PingOne のデータ を変換・連携できます。

CData Connect AI の入手

Jitterbit から 数百種類の SaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスを実現するには、 CData Connect AI をぜひお試しください！

はじめる準備はできましたか？

CData Connect AI の詳細、または無料トライアルにお申し込みください：

無料トライアル

この記事の内容

関連記事