Cognos Analytics でPingOne のデータを分析

こんにちは！リードエンジニアの杉本です。

IBM Watson® を搭載したCognos Analytics では、データのクリーニングと連携、さらに可視化を行うことができます。CData Connect Server と組み合わせると、クラウドデータとCognos Analytics を即座にリアルタイムで接続し、データ管理、視覚化、分析などを行うことができます。 この記事では、CData Connect Server でPingOne に接続し、さらにCognos Analytics でPingOne のデータを分析する方法を紹介します。

NOTE：この手順を実行するにはCognos Analytics 11.2.4 以降が必要です。

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

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

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

1. Connect Server にログインし、「CONNECTIONS」をクリックします。
2. 一覧から「PingOne」を選択します。
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

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

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

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

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

   
4. 「 Test Connection」をクリックします。
5. 「Permission」->「 Add」とクリックし、適切な権限を持つ新しいユーザー(または既存のユーザー) を追加します。

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

Cognos Analytics からPingOne への接続

以下のステップでは、Cognos Analytics からCData Connect Server に接続してリアルタイムPingOne のデータを分析する方法を説明します。

CData Connect Server JDBC Driver をダウンロードする

1. CData Connect Server JDBC Driver をダウンロードしてインストールします：https://www.cdata.com/jp/cloud/clients/download.aspx#jdbc。
2. JAR ファイル（cdata.jdbc.connect.jar）をインストールディレクトリ（例：C:\Program Files\CData\JDBC Driver for CData Connect\lib）からCognos Analytics のインストールディレクトリにある"drivers" フォルダにコピーします。

CData Connect Server への接続を設定する

1. IBM Cognos を立ち上げ、管理 -> データ・サーバー接続に移動します。
2. アイコンをクリックしてデータサーバーを追加します。
3. CData Connect Server を選択します。
4. JDBC URL を適切な接続文字列に設定します。次に例を示します。 jdbc:connect://AuthScheme=Basic;
5. Driver class name を"cdata.jdbc.connect.ConnectDriver" に設定します。
6. 認証方式を選択し、認証情報を作成して保存します。
   • Username をCData Connect Server のユーザー名（例：user@mydomain.com）に設定。
   • Password をConnect Server ユーザーのパスワードに設定。
7. Test connection をクリックし、接続が成功したことを確認します。

これでCognos Analytics でPingOne のデータを分析し可視化する準備が整いました。Cognos Analytics の使用について、詳しくはIBM Cognos Analytics のドキュメントを参照してください。

Cognos Analytics のPingOne のデータへのリアルタイムアクセス

Cognos Analytics からリアルタイムPingOne のデータに直接クラウド間接続ができるようになりました。これで、PingOne を複製することなく新しい可視化やレポートなどを作成できます。

クラウドアプリケーションから直接100を超えるSaaS 、ビッグデータ、NoSQL データソースへのリアルタイムデータアクセスを実現するには、CData Connect Server の30日間無償トライアルをぜひお試しください。