各製品の資料を入手。
詳細はこちら →
MotionBoard からOkta のデータに連携してダッシュボードを作成
国産BI のMotionBoard からCData Connect Server を使ってOkta のデータにリアルタイム連携するレポートを作成。
最終更新日：2024-01-12
こんにちは！テクニカルディレクターの桑島です。
MotionBoard は、ウイングアーク1st 社が提供する人気のBI ダッシュボードツールです。この記事ではMotionBoard で、Okta のデータをCData Connect を通じてシームレスに統合利用する方法を説明します。
ホスティング型の連携プラットフォームであるConnect Server は、BI ツールや分析ツールとの使用に理想的です。サーバーの構成やデータプロキシのセットアップをすることなく、Web ベースのUI を使用してOkta の仮想データベースを作成し、MotionBoard から接続してリアルタイムOkta のデータを使った分析を開始できます。
ホスティングについて
MotionBoard からCData Connect Server に接続するには、利用するConnect Server インスタンスをネットワーク経由での接続が可能なサーバーにホスティングして、URL での接続を設定する必要があります。CData Connect がローカルでホスティングされており、localhost アドレス（localhost:8080 など）またはローカルネットワークのIP アドレス（192.168.1.x など）からしか接続できない場合、MotionBoard はCData Connect Server に接続することができません。
クラウドホスティングでの利用をご希望の方は、AWS Marketplace やGCP Marketplace で設定済みのインスタンスを提供しています。
Okta のデータの仮想データベースを作成する
CData Connect Server は、シンプルなポイントアンドクリックインターフェースを使用してデータソースに接続し、データを取得します。まずは、右側のサイドバーのリンクからConnect Server をインストールしてください。
- Connect Server にログインし、「CONNECTIONS」をクリックします。
- 一覧から「Okta」を選択します。
-
Okta に接続するために必要な認証プロパティを入力します。
Okta に接続するには、Domain 接続文字列プロパティをお使いのOkta ドメインに設定します。
Okta への認証にはOAuth を使用するため、カスタムOAuth アプリケーションを作成する必要があります。
カスタムOAuth アプリケーションの作成
Okta アカウントから：
- 管理者アカウントでOkta のデベロッパーエディションにサインインします。
- Admin Consoleで、Applications > Applications に移動します。
- Create App Integration をクリックします。
- Sign-in method は、OIDC - OpenID Connect を選択します。
- Application type は、Web Application を選択します。
- カスタムアプリケーションの名前を入力します。
- Grant TypeをAuthorization Code に設定します。トークンを自動的に更新したい場合は、Refresh Token もチェックしてください。
- コールバックURL を設定します。
- デスクトップアプリケーションやヘッドレスマシンでは、http://localhost:33333 または任意の別のポート番号を使用します。ここで設定したURI が、CallbackURL プロパティになります。
- Web アプリケーションの場合、コールバックURL を信頼できるリダイレクトURL に設定します。このURL は、アプリケーションへのアクセスが許可されたことを示すトークンを伴ってユーザーが戻ってくるWeb 上の場所です。
- Assignments セクションで、Limit access to selected groups を選択してグループを追加するか、グループの割り当ては一旦スキップします。
- OAuth アプリケーションを保存します。
- アプリケーションのGeneral タブに、アプリケーションのClient Id とClient Secret が表示されます。後で使用できるように、これらを記録してください。Client Id はOAuthClientId の設定に使用し、Client Secret はOAuthClientSecret の設定に使用します。
- Assignments タブを確認し、アプリケーションにアクセスする必要のあるすべてのユーザーがアプリケーションに割り当てられていることを確かめます。
- Okta API Scopes タブで、OAuth アプリケーションに付与するスコープを選択します。これらのスコープは、アプリが読み取り可能なデータを決定します。そのため、特定のビューに対するスコープを付与しないと、そのビューに対するクエリを実行する権限がドライバーに付与されません。各ビューに必要なスコープを確認するには、ヘルプドキュメントのデータモデル > ビュー のビュー固有のページを参照してください。
- 「 Test Connection」をクリックします。
- 「Permission」->「 Add」とクリックし、適切な権限を持つ新しいユーザー(または既存のユーザー) を追加します。
仮想データベースが作成されたら、MotionBoard を含むお好みのクライアントからOkta に接続できるようになります。
MotionBoard からOkta のデータに接続してダッシュボードを作成
MotionBoardの「システム設定 → 接続/認証 → 外部接続」から新しい外部接続を作成します。ここでのポイントは、接続先タイプはSQL Server を選択します。
- 外部接続名：任意（例：CDataConnect）
- 接続先タイプ：SQL Server
- 中継サービス：使用しない
外部接続の基本情報タブにて以下内容をセットします。
- 外部接続名：任意（例：CDataConnect）
- 接続先タイプ：SQL Server
- 接続先タイプ：SQL Server 4.0(JDBC)
- 中継サービス：使用しない
- サーバー名：xxx.cdataconnect.com
- ポート : 14333
- データベース名 : 先ほどConnect Server で作成した接続先データソース名(例：Okta1)
- ユーザー名 : Connect Server のユーザー名（メールアドレス）
- パスワード : パーソナルアクセストークン
「データソース」タブを開き、Okta 内のテーブルが一覧に表示されることを確認できます。ここまで確認できたら「保存」ボタンで外部接続定義を保存して閉じます。
「ボード新規作成」から新しいボードを作成します。
アイテムウィザードのDS1の接続先に上記の外部接続定義で作成した接続（本例では Cdata Connect）を選択します。次に、左側のデータベースにOkta のテーブルリストが表示されますので、使用するテーブルを選択します。右側にDealsテーブル内のデータがプレビューされます。
ウィザードを次に進み、作成するアイテムにチャートを選択して、「次へ」をクリックします。データソース エディタが起動します。左側の項目一覧から可視化したい項目を行項目・列項目・集計項目にセットします。もうRDB やCSV などのデータソースを扱う場合と同じ操作でビジュアライズを作成できます。あとは、おすすめチャートから適切なチャート種類を選択します。
おわりに
このように、CData Connect Server を経由することで、API 側の複雑な仕様を意識せずにMotionBoard でデータを可視化できます。他にも多くのデータソースに対応するCData Connect Server の詳細をこちらからご覧ください。
