Mendix で PingOne 連携アプリを構築

Dibyendu Datta
Dibyendu Datta
Lead Technology Evangelist
CData Connect AI を使って PingOne のデータ用の OData フィードを作成し、Mendix でカスタムアプリを構築できます。

Mendix は、モバイルアプリとWeb アプリの両方を大規模に構築・保守できる高生産性アプリプラットフォームです。CData Connect AI と組み合わせることで、Mendix からクラウド間で即座にPingOne のデータにアクセスできるようになります。この記事では、Mendix からCData Connect AI のデータソースに接続する方法を説明します。

CData Connect AI は PingOne 専用のクラウド間インターフェースを提供し、ネイティブでサポートされているデータベースにデータをレプリケートすることなく、Mendix でリアルタイムのPingOne のデータをインポートできます。Mendix でWeb およびモバイルアプリを構築する際、CData Connect AI はサポートされているすべてのSQL 操作（フィルター、JOIN など）を PingOne に直接プッシュし、サーバーサイド処理を活用して必要なPingOne のデータを迅速に返します。

Mendix 用に PingOne への接続を設定

Mendix から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」タブに移動し、ユーザーベースの権限を更新します。 権限の更新

Personal Access Token の追加

REST API、OData API、またはVirtual SQL Server 経由でConnect AI に接続する場合、Personal Access Token（PAT）を使用してConnect AI への接続を認証します。アクセス管理の粒度を維持するために、サービスごとに個別のPAT を作成することをお勧めします。

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

Mendix 用に PingOne エンドポイントを設定

PingOne への接続後、対象テーブル用のワークスペースを作成します。

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

接続、PAT、ワークスペースの設定が完了したら、Mendix からPingOne のデータに接続する準備が整いました。

PingOne 連携アプリの構築

OData メタデータファイルのダウンロード

Mendix で接続を作成する際、接続フローにはData Source Contract File が必要です。以下の手順に従って、curl（コマンドラインツール）を使用してCData Connect AI のOData メタデータファイルをダウンロードします：

  1. お使いのOS 用のコマンドラインウィンドウを開きます。Windows では、スタートメニューを開いて「cmd」と入力し、Enter キーを押してコマンドプロンプトを開きます。macOS およびLinux では、ターミナルウィンドウを開きます。
  2. curl がシステムにインストールされているか確認するには、「curl -help」と入力してEnter キーを押します。インストールされていない場合は、curl のWeb サイトからインストールしてください。
  3. 以下のcurl コマンドを実行します。USER をCData Connect AI のユーザー名に、PAT を先ほど生成したPAT に置き換えてください： 
    curl -u USER:PAT https://cloud.cdata.com/api/odata/{workspace_name}/$metadata -o metadata.xml
  4. curl コマンドで作成されたmetadata.xml ファイルを探し、アクセスしやすい場所に移動します。

Mendix からCData Connect AI に接続

以下の手順に従って、Mendix からCData Connect AI への接続を確立します：

  1. Mendix にログインし、Data Hub ページを開きます。
    2. Mendix ランディングページ
  2. 「Register a Data Source」セクションで「OData」を選択します。
    3. OData データソースの登録
  3. 上記の手順で取得したmetadata.xml ファイルをアップロードし、「Next」をクリックします。
    4. メタデータファイルのアップロード
  4. 「Data Source Name」と「Data Source Version」に希望する値を入力します。 「Data Source Relative Path」フィールドに「/api/odata/{workspace_name}」と入力し、「Next」をクリックします。
    5. データソースの作成
  5. 「Application information」ページで「Register a new application」をクリックします。
    6. 新しいアプリの登録
  6. 「Application Name」に名前を入力し、テクニカルオーナーを選択します（デフォルトでは現在ログインしているユーザーになります）。
    7. アプリのフィールドへの入力
  7. 「Next」をクリックします。「Environment Name」フィールドに希望する名前を入力します（例：CData Connect AI）。 「Environment Location」フィールドに「https://cloud.cdata.com」と入力し、必要に応じて適切な「Environment Type」（例：Production）を選択します。
    8. 環境の作成
  8. 「Done!」をクリックして接続を作成します。
    9. 接続の確定

これで、Mendix Studio Pro で接続を使用して、リアルタイムのPingOne のデータにアクセスするアプリケーションを簡単に作成できるようになりました。

CData Connect AI の入手

クラウドアプリケーションから直接、数百種類のSaaS、ビッグデータ、NoSQL ソースへのリアルタイムデータアクセスを実現するには、今すぐCData Connect AI をお試しください！

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

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

無料トライアル

この記事の内容

関連記事