Amazon QuickSight でPingOne のデータに連携するインタラクティブなダッシュボードを作成

CData Connect Server を使ってPingOne のデータの仮想エンドポイントを作成して、Amazon QuickSight からPingOne のデータを使ったインタラクティブダッシュボードを作成。

加藤龍彦
デジタルマーケティング
最終更新日：2022-04-16

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

Amazon QuickSight は、ユーザーがインタラクティブなダッシュボードを作成できるサービスです。Amazon QuickSight とCData Connect Server を一緒に使うことで、簡単にPingOne のデータに連携する可視化、ダッシュボードを作成することができます。この記事では、Connect Server を経由してAmazon QuickSight からPingOne に連携するダッシュボードを作成する方法を説明します。

CData Connect Server は、PingOne のデータの仮想インターフェースを提供し、Amazon QuickSight からリアルタイムPingOne のデータに直接連携することができます。Amazon QuickSight に簡単にPingOne のデータをインポートすることで、レスポンシブなダッシュボードをAWS エコシステム上で作成することができます。

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

CData Connect Server は、直観的なPoint-and-click インターフェースでデータソースへの接続およびAPI エンドポイント作成を行います。

Connect Server にログインして、Databases をクリックします。
利用できるデータソースアイコンから"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 Database をクリックします。
Permission -> Add をクリックして、新しいユーザーを追加し、適切な権限を指定します。

これで、PingOne の仮想データベースが作成でき、Amazon QuickSight からの可視化が可能になりました。

QuickSight にPingOne のデータをインポートして、インタラクティブダッシュボードを作成

次の手順で、PingOne の仮想データベースをCData Connedct Server に作成し、データをインポートして可視化を作成します。

Amazon QuickSight にログインして「データセット」をクリックします。
次に「新しいデータセット」をクリックし、SQL Server をデータソースとして選択します。以下のように、CData Connect Server インスタンスの接続情報を入力していきます。
- データソース名：任意
- 接続タイプ：パブリックネットワーク
- データベースサーバー: 接続するCData Connect Server インスタンスのURL。例：CONNECT_SERVER_URL
- ポート：インスタンス接続用のポート。1433 など。
- データベース名：仮想データベース名、例： PingOne1
- ユーザー名：Connect Server で接続許可を与えたユーザー名
- パスワード：Connect Server ユーザーのパスワード
- SSL：インスタンス側でSSL を設定している場合にはオンに、設定していない場合はオフにしてください。
「接続を検証」をクリックして接続をテストし、問題がなければ「データソースを作成」をクリックして接続を確立します。
テーブルの選択画面で、「カスタムSQL を使用」を選択します。
次の画面で、「データの編集/プレビュー」を選択します。
カスタムSQL を入力、およびデータをプレビューできる画面が表示されるので、「スキーマエクスプローラー」から可視化したいスキーマおよびテーブルを選択して、以下の形式でカスタムクエリを作成します。
SELECT <カラム名> FROM [<スキーマ名>].[<テーブル名>]。例えば、SELECT * FROM [PingOne1].[[CData].[Administrators].Users] などです。
プレビューでデータを確認できたら、「保存して視覚化」ボタンを押して、データをロードします。
あとは、フィールドとタイプを選択して自在に可視化を作成できます。