CData BizTalk Adapter for Okta で SQL コマンドスキーマを生成する方法

この記事では、CData BizTalk Adapter を使用して取得したOkta のデータを処理するためのスキーマ生成方法を説明します。SELECT コマンド用のスキーマを生成します。

このガイドでは、CData BizTalk Adapter for Okta を使用して Okta への SQL コマンドを実行する方法を解説します。

Okta 用アダプターをプロジェクトに追加する

以下の手順で、BizTalk Server プロジェクトにアダプターを追加します。

1. まだ行っていない場合は、Visual Studio で新しい BizTalk Server プロジェクトを作成します。
2. Solution Explorer でプロジェクトを右クリックし、Add -> Add Generated Items をクリックします。
3. 表示されるダイアログボックスで Add Adapter Metadata を選択します。
4. 表示される Add Adapter ウィザードで、リストからアダプターを選択します。
5. Port メニューでは、選択を空白のままにします。または、トランスポートタイプとしてアダプターが設定されている Receive Location か Send Port を選択することもできます。

SQL コマンド用のスキーマを生成する

Add Adapter ウィザードでアダプターを選択すると、Schema ウィザードが表示されます。以下の手順で接続プロパティを構成し、コマンドの結果のメタデータを取得します。

1. Connection String ページで、認証情報やその他の接続プロパティを入力します（BizTalk アプリケーションで既に構成済みのアダプターを選択していない場合）。一般的な接続文字列は以下のとおりです：

   Domain=dev-44876464.okta.com;
   

   Okta に接続するには、Domain 接続文字列プロパティをお使いのOkta ドメインに設定します。 Okta はOAuth およびOAuthJWT 認証をサポートしています。

   OAuth認証

   OAuth で認証するには、AuthScheme をOAuth に設定する必要があります。また、カスタムOAuth アプリケーションを作成する必要があります。

   カスタムOAuth アプリケーションの作成

   Okta アカウントから：

   1. 管理者アカウントでOkta のデベロッパーエディションにサインインします。
   2. Admin Consoleで、Applications > Applications に移動します。
   3. Create App Integration をクリックします。
   4. Sign-in method は、OIDC - OpenID Connect を選択します。
   5. Application type は、Web Application を選択します。
   6. カスタムアプリケーションの名前を入力します。
   7. Grant TypeをAuthorization Code に設定します。トークンを自動的に更新したい場合は、Refresh Token もチェックしてください。
   8. コールバックURL を設定します。
      • デスクトップアプリケーションやヘッドレスマシンでは、http://localhost:33333 または任意の別のポート番号を使用します。ここで設定したURI が、CallbackURL プロパティになります。
      • Web アプリケーションの場合、コールバックURL を信頼できるリダイレクトURL に設定します。このURL は、アプリケーションへのアクセスが許可されたことを示すトークンを伴ってユーザーが戻ってくるWeb 上の場所です。
   9. Assignments セクションで、Limit access to selected groups を選択してグループを追加するか、グループの割り当ては一旦スキップします。
   10. OAuth アプリケーションを保存します。
   11. アプリケーションのGeneral タブに、アプリケーションのClient Id とClient Secret が表示されます。後で使用できるように、これらを記録してください。Client Id はOAuthClientId の設定に使用し、Client Secret はOAuthClientSecret の設定に使用します。
   12. Assignments タブを確認し、アプリケーションにアクセスする必要のあるすべてのユーザーがアプリケーションに割り当てられていることを確かめます。
   13. Okta API Scopes タブで、OAuth アプリケーションに付与するスコープを選択します。これらのスコープは、アプリが読み取り可能なデータを決定します。そのため、特定のビューに対するスコープを付与しないと、そのビューに対するクエリを実行する権限がドライバーに付与されません。各ビューに必要なスコープを確認するには、ヘルプドキュメントのデータモデル > ビュー のビュー固有のページを参照してください。

   OAuth 認証の詳細や、OAuthJWT 認証については、ヘルプドキュメントを参照してください。

   
2. 次のページ（Schema Information）の General Options セクションで、アダプターの構成に応じて Send Port または Receive Location を選択します。
3. 結果セット全体のスキーマを生成する場合は、Message Mode メニューで Single Message オプションを選択します。結果セットの各行ごとにスキーマを生成する場合は、Message Per Row オプションを選択し、メッセージのルート要素が 'row' であることを確認します。
4. Command Type メニューで、SQL Command を選択します。

5. Statement Information ページの SQL Command Text ボックスに、SQL コマンドを入力します（Receive Location または Send Port を構成済みの場合は、構成した SQL コマンドがボックスに入力されています）。この例では以下のクエリを使用します：

   SELECT Id, ProfileFirstName FROM Users WHERE Status = 'Active'
   

   
6. ウィザードに表示されるサマリーで設定を確認し、Finish をクリックして schema.xsd ファイルを生成します。

スキーマの処理

シンプルな BizTalk アプリケーションでスキーマを使用する方法については、チュートリアルを参照してください。