Zoho Analytics を使用してPingOne のデータをインポート

CData Connect Server を使用してZoho Analytics からPingOne に接続し、リアルタイムPingOne のデータをインポートします。

古川えりか
コンテンツスペシャリスト
最終更新日：2022-12-13

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

Zoho Analytics はモダンなBI およびアナリティクスプラットフォームであり、データに接続、分析したりビジュアライゼーションやダッシュボードを作成して意思決定につながるインサイトを発見できます。 CData Connect Server と組み合わせると、Zoho Analytics はレポートや分析のためにPingOne のデータにクラウドベースで即座にアクセスできます。 Connect Server を使用してPingOne に接続し、Zoho Analytics でダッシュボードを作成してPingOne のデータを分析する方法を紹介します。

CData Connect Server は、PingOne にクラウドベースのインターフェースを提供し、ネイティブにサポートされているデータベースにデータを複製することなく、Zoho Analytics でPingOne のデータの分析を実現します。 CData Connect Server は、最適化されたデータ処理により、サポートされているすべてのSQL 操作（フィルタ、JOIN など）をPingOne に直接プッシュし、サーバー側の処理を利用して要求されたPingOne のデータを高速で返します。

ホスティングについて

Zoho Analytics からCData Connect Server に接続するには、利用するConnect Server インスタンスをネットワーク経由での接続が可能なサーバーにホスティングして、URL での接続を設定する必要があります。CData Connect がローカルでホスティングされており、localhost アドレス（localhost:8080 など）またはローカルネットワークのIP アドレス（192.168.1.x など）からしか接続できない場合、Zoho Analytics はCData Connect Server に接続することができません。

クラウドホスティングでの利用をご希望の方は、AWS Marketplace やGCP Marketplace で設定済みのインスタンスを提供しています。

PingOne のデータの仮想データベースを作成する

CData Connect Server は、シンプルなポイントアンドクリックインターフェースを使用してデータソースに接続し、データを取得します。まずは、右側のサイドバーのリンクからConnect Server をインストールしてください。

Connect Server にログインし、「CONNECTIONS」をクリックします。
一覧から「PingOne」を選択します。
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
接続すると、本製品はデフォルトブラウザでPingOne のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。ドライバーはこれでOAuth プロセスを完了します。
1. ドライバーはPingOne からアクセストークンを取得し、それを使ってデータをリクエストします。
2. OAuth 値はOAuthSettingsLocation で指定された場所に保存され、接続間で永続化されるようにします。
ドライバーはアクセストークンの期限が切れると自動的にリフレッシュします。

Web アプリケーションやヘッドレスマシン、クライアントクレデンシャルグラントを含むその他のOAuth メソッドについては、ヘルプドキュメントを参照してください。
「 Test Connection」をクリックします。
「Permission」->「 Add」とクリックし、適切な権限を持つ新しいユーザー(または既存のユーザー) を追加します。

仮想データベースが作成されたら、Zoho Analytics を含むお好みのクライアントからPingOne に接続できるようになります。

CData Connect Server を使用してZoho Analytics からPingOne へ接続

Zoho Analytics からCData Connect Server への接続を確立するには、次の手順を実行します

Zoho Analytics にログインします。

新しい接続を作成し、Cloud Databases を選択して接続モーダルを開きます。

次の情報を入力します。
- Database Type - MS SQL Server を選択。
- Endpoint - CONNECT_SERVER_URL を入力。
- SQL Server Instance Name - 空欄のまま。
- Port - 1433 を入力。
- Username - CData Connect Server のユーザー名を入力。ユーザー名はCData Connect Server のインターフェースの右上に表示されています。例えばuser@domain.com です。
- Password - Connect Server ユーザーのパスワード。
- Database Name - 接続したいCData Connect Server データソースのConnection Name を入力。例えばPingOne1です。
- 「Next」をクリック。
[CData].[Administrators].Users など、インポートしたいテーブルを選択します。