各製品の資料を入手。
詳細はこちら →
製品をチェック
JDBI からOkta データ のデータアクセスオブジェクトを作成
JDBI でOkta のデータ 用のSQL オブジェクトAPIを作成する方法を概説します。
最終更新日：2022-05-25
この記事で実現できるOkta 連携のシナリオ
こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
JDBI は、Fluent スタイルとSQL オブジェクトスタイルという2つの異なるスタイルAPI を公開する、Java 用のSQL コンビニエンスライブラリです。CData JDBC Driver for Okta は、Java アプリケーションとリアルタイムOkta のデータ のデータ連携を実現します。これらの技術を組み合わせることによって、Okta のデータ へのシンプルなコードアクセスが可能になります。ここでは、基本的なDAO（Data Access Object ）とそれに付随するOkta のデータ の読み書きのためのコードの作成について説明します。
Okta Users Entity のDAO を作成
以下のインターフェースは、実装されるSQL ステートメントごとに単一のメソッドを作成するためのSQL オブジェクトの正しい動作を宣言します。
public interface MyUsersDAO {
//request specific data from Okta (String type is used for simplicity)
@SqlQuery("SELECT ProfileFirstName FROM Users WHERE Status = :status")
String findProfileFirstNameByStatus(@Bind("status") String status);
/*
* close with no args is used to close the connection
*/
void close();
}
Okta への接続を開く
必要な接続プロパティを収集し、Okta に接続するための適切なJDBC URL を作成します。
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 アプリケーションに付与するスコープを選択します。これらのスコープは、アプリが読み取り可能なデータを決定します。そのため、特定のビューに対するスコープを付与しないと、そのビューに対するクエリを実行する権限がドライバーに付与されません。各ビューに必要なスコープを確認するには、ヘルプドキュメントのデータモデル > ビュー のビュー固有のページを参照してください。
ビルトイン接続文字列デザイナー
JDBC URL の構成については、Okta JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
java -jar cdata.jdbc.okta.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
Okta の接続文字列は、通常次のようになります。
jdbc:okta:Domain=dev-44876464.okta.com;InitiateOAuth=GETANDREFRESH
構成済みのJDBC URL を使用して、DAO インターフェースのインスタンスを取得します。以下に示す特定のメソッドはインスタンスにバインドされたハンドルを開くため、ハンドルとバインドされたJDBC 接続を開放するには、インスタンスを明示的に閉じる必要があります。
DBI dbi = new DBI("jdbc:okta:Domain=dev-44876464.okta.com;InitiateOAuth=GETANDREFRESH");
MyUsersDAO dao = dbi.open(MyUsersDAO.class);
//do stuff with the DAO
dao.close();
Okta データ について
Okta への接続を開いた状態で以前定義したメソッドを呼び出すだけで、Okta のUsers エンティティからデータを取得できます。
//disply the result of our 'find' method
String profileFirstName = dao.findProfileFirstNameByStatus("Active");
System.out.println(profileFirstName);
JDBI ライブラリはJDBC 接続を処理できるため、CData JDBC Driver for Okta と統合することで、SQL Object API for Okta を簡単に作成できます。今すぐ無料トライアルをダウンロードし、Java アプリケーションでリアルタイムOkta を操作しましょう。
関連コンテンツ
