データベースデータストアを追加する
データベースベースのデータストアは、外部のデータベースベースのデータにアクセスすることによってアプリケーション属性データを増やすために使用できます。このタスクでは、データベースベースのデータストアを追加します。
手順
データストアを追加する
- Access Gatewayインスタンスに進みます。
- 設定(Settings)タブを選択します。
- データストア(Data Stores)をクリックします。
- 追加(+)をクリックします。
- Sqlデータベース(Sql Database)をクリックして SQLデータベースを追加するか、LDAPデータベース(LDAP Database)をクリックしてLDAPデータベースを追加します。
SQLデータベース データストアを構成する
- SQLデータベースのデータストアを作成すると、新規データストアを作成する(Create New DataStore)ウィザードに次の情報を提供します。
フィールド 説明 名前(Name) データストアの識別に使用される名前(例えば
My SQL Datastore)。ドライバー(Driver) データストアのドライバー以下より1つを選択:
- MySQL/MariaDB
- PostgreSQL
- MSSQLサーバー
- OracleDB
HostName:Port(ホスト名:ポート) データベースインスタンスのFQDNおよびポートを入力します(例: mysqlserver.example.com:3306)。データベース(Database) データベース内のデータベース(スキーマ)名(例: userDatabase)。ユーザー名(Username)
データベースにアクセスするユーザー名(例:
dbuser)。パスワード(Password)
ユーザー名(Username)に関連付けられたパスワード
詳細クエリモード(Advanced Query Mode)
無効:テーブル名を指定(例:
people)。 - 検証されていません(Not Validated)をクリックします。Okta Access Gatewayは、接続検証を試みます。成功すると、ラベルが有効(Valid)に変更されます。
- 条件句(Clause Conditions)の下には、Oktaテナントとデータベースの結合を定義するWhere句を追加します。
- 追加(+)をクリックします。
- 句の内容を新規入力するダイアログボックスで、以下を入力します:
- フィールド(Field):結合のためのデータベースフィールド(例:メール)。
- 値(Value):結合のためのIDPフィールド(例:
${email@idp})。このフィールドには、固定値またはデータストア内のフィールドへの参照を含めることができます。たとえば、${fieldInIdP@idp}の場合、fieldInIdPはテーブルに対する結合に使用するIDPプロファイルからのフィールドを表します。
- 保存(Save)(
)をクリックします。別のデータストアを追加するには、前の手段を繰り返します。 - Okay(OK)をクリックします。
注意:Where句で使用するフィールドはアプリケーションの属性として定義する必要があります。フィールドがアプリケーション属性としてリストされていない場合、ランタイムエラーが発生します。where句で排他的に使用される属性は送信しないにマークする必要があります。アプリケーション属性を参照してください。
- アクティブ(Active)トグルをオンにして、データストアをアクティブ化します。
データストアをテストするデータストアをテストする
- データストアの行のシミュレートする(Simulate) (
)をクリックします。 - 各Where句のフィールドで、IDPの関連するエントリと一致する値を入力します。
- テスト(Test)をクリックしてシミュレーションを実行します。閉じる(Close)をクリックして終了します。
- テストの結果、データストアから既定値に関して予測されるデータが返れることを確認します。