データベースデータストアを追加する

データベースベースのデータストアを追加して、外部のデータベースベースのデータにアクセスすることで、アプリケーションの属性データを拡張できます。

ステップ

データストアを追加する

  1. Access Gatewayインスタンスに進みます。
  2. ［Settings（設定）］タブを選択します。
  3. データストアをクリックします。
  4. ［+（追加）］をクリックします。
  5. ［Sql Database（Sqlデータベース）］をクリックして SQLデータベースを追加するか、［LDAP Database（LDAPデータベース）］をクリックしてLDAPデータベースを追加します。

SQLデータベース データストアを構成する

  1. SQLデータベースのデータストアを作成すると、新規データストアを作成するウィザードに次の情報を提供します。
    フィールド説明
    Name（名前）

    データストアの識別に使用される名前（例えば My SQL Datastore（自分のSQLデータベース））。

    Driver（ドライバー）

    データストアのドライバー以下より1つを選択：

    • MySQL/MariaDB
    • PostgreSQL
    • MSSQLサーバー
    • OracleDB
    HostName:Port（ホスト名：ポート）データベースインスタンスのFQDNおよびポートを入力します（例：mysqlserver.example.com:3306）。
    Database（データベース）データベース内のデータベース（スキーマ）名（例：userDatabase）。

    Username（ユーザー名）

    データベースにアクセスするユーザー名（例：dbuser）。

    Password（パスワード）

    Username（ユーザー名）に関連付けられたパスワード

    Advanced Query Mode（詳細クエリモード）

    無効：テーブル名を指定（例：人）。

  2. ［Not Validated（検証されていません）］をクリックします。Okta Access Gatewayは、接続検証を試みます。成功すると、ラベルが［Valid（有効）］に変更されます。
  3. 条件句の下には、Oktaテナントとデータベースの結合を定義する［Where］句を追加します。
    1. ［+（追加）］をクリックします。
    2. 句の内容を新規入力するダイアログボックスで、以下を入力します：
      • ［Field（フィールド）］：結合のためのデータベースフィールド（例：メール）。
      • ［Value（値）］：結合のためのIDPフィールド（例：${email@idp})。このフィールドには、固定値またはデータストア内のフィールドへの参照を含めることができます。たとえば、${fieldInIdP@idp}の場合、fieldInIdPはテーブルに対する結合に使用するIDPプロファイルからのフィールドを表します。
    3. ［Save（保存）］（）をクリックします。別のデータストアを追加するには、前の手段を繰り返します。
    4. ［Okay（OK）］をクリックします。

    Where句で使用するフィールドはアプリケーションの属性として定義する必要があります。フィールドがアプリケーション属性としてリストされていない場合、ランタイムエラーが発生します。where句で排他的に使用される属性は送信しないにマークする必要があります。「アプリケーション属性」をご参照ください。

  4. ［Active（アクティブ）］トグルをオンにして、データストアをアクティブ化します。

データストアをテストするデータストアをテストする

  1. データストアの行の［Simulate（シミュレートする）］ (データストアのシミュレートボタン。)をクリックします。
  2. 各Where句のフィールドで、IDPの関連するエントリと一致する値を入力します。
  3. ［Test（テスト）］をクリックしてシミュレーションを実行します。［Close（閉じる）］をクリックして終了します。
  4. テストの結果、データストアから既定値に関して予測されるデータが返れることを確認します。