データベース・アプリケーション表(MSSQL)との統合

前提条件

Database Application Tables (MSSQL) Orchestrated Systemをインストールおよび構成する前に、次の前提条件およびタスクを考慮する必要があります。

データベース・アプリケーション表(MSSQL)システムは、Oracle Access Governanceで動作保証されています。サポートされているバージョンの詳細は、「Oracle Access Governanceとの統合に対して動作保証されているデータベース・アプリケーション表コンポーネント」を参照してください。

構成

接続の詳細を入力することで、顧客データベースとOracle Access Governance間の接続を確立できます。これを実現するには、Oracle Access Governanceコンソールで使用可能な調整されたシステム機能を使用します。

「Orchestrated Systems」ページに移動します。

次のステップに従って、Oracle Access Governanceコンソールの「Orchestrated Systems」ページにナビゲートします。

Oracle Access Governanceのナビゲーション・メニュー・アイコンから、「Service Administration」→「Orchestrated Systems」を選択します。
ワークフローを開始するには、「オーケストレート済システムの追加」ボタンを選択します。

システムの選択

ワークフローの「システムの選択」ステップで、オンボーディングするシステムのタイプを指定できます。「検索」フィールドを使用して、名前で必要なシステムを検索できます。

「データベース・アプリケーション表(MSSQL DB)」を選択します。
「次へ」をクリックします。

詳細の追加

ワークフローの「詳細の追加」ステップで、オーケストレート済システムの詳細を入力します:

「名前」フィールドに、接続先のシステムの名前を入力します。
「説明」フィールドに、システムの説明を入力します。
このオーケストレート済システムが信頼できるソースかどうか、および次のチェック・ボックスを設定してOracle Access Governanceが権限を管理できるかどうかを決定します。
- これは私のアイデンティティの認証ソースです
  次の項目から選択します。
  - アイデンティティとその属性のソース: システムは、ソース・アイデンティティおよび関連する属性として機能します。新しいアイデンティティは、このオプションを使用して作成されます。
  - アイデンティティ属性のソースのみ: 追加のアイデンティティ属性の詳細が取り込まれ、既存のアイデンティティに適用されます。このオプションは、新規アイデンティティ・レコードを取込みまたは作成しません。
- このシステムの権限を管理します
各ケースのデフォルト値は「未選択」です。
「次へ」を選択します。

所有者の追加

リソース所有権を関連付けるには、プライマリ所有者と追加所有者を追加します。これにより、これらの所有者は所有するリソースを管理(読取り、更新または削除)できるため、セルフサービスが促進されます。デフォルトでは、リソース作成者はリソース所有者として指定されます。1人のプライマリ所有者と最大20人の追加所有者をリソースに割り当てることができます。

ノート

サービス・インスタンスに対して最初のオーケストレート済システムを設定する場合、「アイデンティティの管理」セクションからアイデンティティを有効にした後にのみ所有者を割り当てることができます。

所有者を追加するには:

「プライマリ所有者は誰ですか。」フィールドで、Oracle Access Governanceのアクティブ・ユーザーをプライマリ所有者として選択します。
「他の所有者は誰ですか。」リストで1つ以上の追加所有者を選択します。リソースに最大20人の追加所有者を追加できます。

リストの「プライマリ所有者」を表示できます。すべての所有者は、所有するリソースを表示および管理できます。

アカウント設定

ワークフローの「アカウント設定」ステップで、システムが管理対象システムとして構成されている場合、Oracle Access Governanceでアカウントを管理する方法を入力します:

権限が要求され、アカウントがまだ存在しない場合は、このオプションを選択して新しいアカウントを作成します。このオプションはデフォルトで選択されています。選択すると、権限が要求されたときにアカウントが存在しない場合、Oracle Access Governanceによってアカウントが作成されます。このオプションをクリアすると、権限はオーケストレート済システム内の既存のアカウントに対してのみプロビジョニングされます。アカウントが存在しない場合、プロビジョニング操作は失敗します。
アカウント作成時の通知電子メールの受信者を選択します。デフォルトの受信者は「ユーザー」です。受信者が選択されていない場合、アカウントの作成時に通知は送信されません。
- ユーザー
- ユーザー・マネージャ
既存のアカウントの構成
ノート

これらの構成を設定できるのは、システム管理者によって許可されている場合のみです。グローバル・アカウント終了設定が有効になっている場合、アプリケーション管理者は、調整されたシステム・レベルでアカウント終了設定を管理できません。
1. 早期終了開始時のアカウントの処理の選択: 早期終了の開始時に実行する処理を選択します。これは、正式な退職日より前にアイデンティティ・アクセスを取り消す必要がある場合に発生します。
  - 削除: Oracle Access Governanceで管理されているすべてのアカウントおよび権限を削除します。
    ノート
    
    特定のオーケストレート済システムでアクションがサポートされていない場合、アクションは実行されません。
  - 無効化: すべてのアカウントを無効化し、Oracle Access Governanceで管理される権限を無効化します。
    - 無効化されたアカウントの権限の削除: 残存アクセス権がゼロであることを確認するには、これを選択して、アカウントの無効化時に直接割り当てられた権限およびポリシーで付与された権限を削除します。
  - アクションなし: アイデンティティにOracle Access Governanceによる早期終了のフラグが付けられている場合、アクションは実行されません。
2. 退職日のアカウントの処理の選択: 正式な退職時に実行する処理を選択します。これは、正式な退職日にIDアクセスを取り消す必要がある場合に発生します。
  - 削除: Oracle Access Governanceで管理されているすべてのアカウントおよび権限を削除します。
    ノート
    
    特定のオーケストレート済システムで「削除」アクションがサポートされていない場合、アクションは実行されません。
  - 無効化: すべてのアカウントを無効化し、Oracle Access Governanceで管理される権限を無効化します。
    - 無効化されたアカウントの権限の削除: 残存アクセス権がゼロであることを確認するには、これを選択して、アカウントの無効化時に直接割り当てられた権限およびポリシーで付与された権限を削除します。
    ノート
    
    特定のオーケストレート済システムで「無効化」アクションがサポートされていない場合は、アカウントが削除されます。
  - アクションなし: Oracle Access Governanceでは、アカウントおよび権限に対するアクションは実行されません。
アイデンティティが企業を離れたときは、そのアカウントへのアクセス権を削除する必要があります。
ノート

これらの構成を設定できるのは、システム管理者によって許可されている場合のみです。グローバル・アカウント終了設定が有効になっている場合、アプリケーション管理者は、調整されたシステム・レベルでアカウント終了設定を管理できません。
アカウントに対する次のアクションのいずれかを選択します。
- 削除: Oracle Access Governanceで管理されているすべてのアカウントおよび権限を削除します。
- 無効化: すべてのアカウントを無効化し、権限を非アクティブとしてマークします。
  - 無効化されたアカウントの権限の削除: アカウントの無効化時に直接割り当てられ、ポリシーで付与された権限を削除して、残存アクセスをゼロにします。
- アクションなし: アイデンティティが組織を離れるときにアクションを実行しません。
ノート

これらのアクションは、オーケストレートされたシステム・タイプでサポートされている場合にのみ使用できます。たとえば、「削除」がサポートされていない場合、「無効化」および「アクションなし」オプションのみが表示されます。
アカウントのすべての権限が削除された場合(アイデンティティが部門間を移動する場合など)、アカウントの処理を決定する必要がある場合があります。オーケストレート済システム・タイプでサポートされている場合、次のいずれかのアクションを選択します。
- 削除
- 使用不可
- 処理なし
アクセス・ガバナンスで作成されていないアカウントの管理: オーケストレート済システムで直接作成されるアカウントを管理する場合に選択します。これにより、既存のアカウントを調整し、Oracle Access Governanceから管理できます。

ノート

システムを管理対象システムとして構成しない場合、ワークフローのこのステップは表示されますが、有効になりません。この場合、ワークフローの「統合設定」ステップに直接進みます。

ノート

オーケストレート済システムで、汎用RESTおよびデータベース・アプリケーション表の統合と同様に動的スキーマ検出が必要な場合は、オーケストレート済システムの作成時に通知電子メールの宛先(ユーザー、Usermanager)のみを設定できます。モーバーおよびリーバの無効化/削除ルールは設定できません。これを行うには、オーケストレート済システムを作成してから、「オーケストレート済システム・アカウント設定の構成」の説明に従ってアカウント設定を更新する必要があります。

統合設定

ワークフローの「統合設定」ステップで、Oracle Access Governanceが顧客データベースに接続できるようにするために必要な詳細を入力します。

統合設定
パラメータ名	必須?	説明
Microsoft SQL Serverデータベースの簡易接続URL	はい	統合する顧客データベースシステムをホストするサーバーのURL。 host/port/database/encrypt/trustServerCertificateの形式を使用します。たとえば、jdbc:sqlserver://[host]:[port];[databaseName];[encrypt];[trustServerCertificate]です。詳細は、使用しているバージョンのMSSQL JDBCドキュメントを参照してください。
ユーザー名	はい	データのリコンシリエーションおよびプロビジョニングを実行するために顧客データベース・システムに接続するために必要なユーザー名。
パスワード/パスワードの確認	はい	顧客データベース・システムに接続しているユーザーを認証するパスワード。
データベース名	はい	接続する必要がある顧客データベース(マスター・データベースなど)。
カスタムJarの詳細	はい	MSSQLサーバー・データベース・ドライバjar。使用しているバージョンのMSSQL JDBCドキュメントを参照してください。jar名およびチェックサムは、`<jarName>::<jarChecksum>`の形式にする必要があります。SHA-512を使用してチェックサムを計算します。エージェントによるこの使用方法の詳細は、「カスタムJARサポート」を参照してください。
ユーザー・アカウント表名	はい	ユーザー・アカウントを含む表の名前。ノート自動増分されないキー列の場合、アカウントの作成プロビジョニングはカスタム・スクリプトでのみサポートされます。データベース・アプリケーション表統合によるスクリプトの詳細は、「Groovyを使用したデータベース・アプリケーション表(MSSQL)のカスタム・スクリプトの開発」を参照してください。ノート表名に表所有者のユーザー名を含めないでください(例: MYUSER.MYDBAT_PERSON)。そうしないと、エラーが表示されます。ユーザー名は、この表で説明するように、別のパラメータとして渡されます。
権限表		権限表の名前をカンマ区切りリストに追加します。このパラメータは、オーケストレート済システムが管理対象システム・モードで構成されている場合にのみ適用されます。ノート表名に表所有者のユーザー名を含めないでください(例: MYUSER.MYDBAT_PERMISSION)。そうしないと、エラーが表示されます。ユーザー名は、この表で説明するように、別のパラメータとして渡されます。
アカウント権限表		親表と子表にアカウント・データが存在する場合は、子表名のカンマ区切りリストを指定します。ノート表名に表所有者のユーザー名を含めないでください(例: MYUSER.MYDBAT_ACCOUNTPERMISSION)。そうしないと、エラーが表示されます。ユーザー名は、この表で説明するように、別のパラメータとして渡されます。
アフィリエーション表		作成されたアフィリエイト表のカンマ区切りリスト。詳細は、DBAT Affiliation Support for Custom Multivalued Identity Attributesを参照してください。
ルックアップ表		国などの属性の参照表のカンマ区切りのリスト。ノート表名に表所有者のユーザー名を含めないでください(例: MYUSER.MYDBAT_LOOKUP)。そうしないと、エラーが表示されます。ユーザー名は、この表で説明するように、別のパラメータとして渡されます。
キー列マッピング	はい	キー列マッピングのカンマ区切りリスト。これらのマッピングは、`Table:KeyColumn`の形式で入力する必要があります。ノートこのパラメータは、ACCOUNT、ENTITLEMENTおよびLOOKUP表にのみ適用されます。
名前列マッピング	はい	名前列マッピングのカンマ区切りリスト。これらのマッピングは、`Table:NameColumn`の形式で入力する必要があります。ノートこのパラメータは、ACCOUNT、ENTITLEMENTおよびLOOKUP表にのみ適用されます。
ユーザー・アカウント表パスワード列マッピング		ユーザー・アカウント表の`Table:PasswordColumn`形式のパスワード列マッピング。
ユーザー・アカウント表ステータス列マッピング	はい	`Table:StatusColumn`形式のユーザー・アカウント表のステータス列マッピング。ステータス列には、ユーザー・レコードのステータスが保持されます。特殊な値の場合、有効/無効の値を構成してください。
ユーザー・アカウント対応ステータス値		この値は、ステータス列が構成され、文字列型である場合、enable値として使用されます。このパラメータに値が指定されない場合、このパラメータはデフォルトで'ACTIVE'になります。
ユーザー・アカウント無効ステータス値		この値は、ステータス列が構成され、文字列型である場合、disable値として使用されます。このパラメータに値が指定されない場合、デフォルト値は'INACTIVE'になります。
ユーザー・アカウント・フィルタ条件		顧客データベースからOracle Access Governanceに取り込むユーザー・アカウント・レコードのサブセットを定義するWHERE句。例: COUNTRY IN ('IN'、'US')
スクリプトの作成		プロビジョニング操作を実行するためにデフォルトのSQL文ではなく、カスタム・ストアド・プロシージャまたはSQL文を使用するカスタム・スクリプト。ユーザー・アカウントの作成プロビジョニング操作用に作成されたGroovyスクリプトのファイルのURLを入力します。ファイルURLは次の書式で入力する必要があります: `/directoryName/fileName`。サンプル値: `/app/scripts/create_user.groovy` データベース・アプリケーション表統合によるスクリプトの詳細は、「Groovyを使用したデータベース・アプリケーション表(MSSQL)のカスタム・スクリプトの開発」を参照してください。
スクリプトの更新		プロビジョニング操作を実行するためにデフォルトのSQL文ではなく、カスタム・ストアド・プロシージャまたはSQL文を使用するカスタム・スクリプト。ユーザー・アカウントの更新プロビジョニング操作用に作成されたGroovyスクリプトのファイルのURLを入力します。このスクリプトは、アカウント属性フォームを更新した場合、ユーザー・アカウントを有効化/有効化した場合に呼び出されますファイルURLは次の書式で入力する必要があります: `/directoryName/fileName`。サンプル値: `/app/scripts/update_user.groovy` データベース・アプリケーション表統合によるスクリプトの詳細は、「Groovyを使用したデータベース・アプリケーション表(MSSQL)のカスタム・スクリプトの開発」を参照してください。
スクリプトの削除		プロビジョニング操作を実行するためにデフォルトのSQL文ではなく、カスタム・ストアド・プロシージャまたはSQL文を使用するカスタム・スクリプト。ユーザー・アカウントの削除プロビジョニング操作用に作成されたGroovyスクリプトのファイルのURLを入力します。このスクリプトは、アカウントを取り消すまたは削除した場合にコールされます。ファイルURLは次の書式で入力する必要があります: `/directoryName/fileName`。サンプル値: `/app/scripts/delete_user.groovy` データベース・アプリケーション表統合によるスクリプトの詳細は、「Groovyを使用したデータベース・アプリケーション表(MSSQL)のカスタム・スクリプトの開発」を参照してください .
データロード・スクリプト		プロビジョニング操作を実行するためにデフォルトのSQL文ではなく、カスタム・ストアド・プロシージャまたはSQL文を使用するカスタム・スクリプト。リコンシリエーション用に作成されたGroovyスクリプトのファイルのURLを入力します。コネクタによりデータ・ロード操作はGroovyスクリプトに委任され、情報(コネクタ・オブジェクト)をコールバック・ハンドラに渡す責任を負います。このスクリプトは、アカウント検索(完全データ・ロードなどの操作)を実行する場合に呼び出されますファイルURLは次の書式で入力する必要があります: `/directoryName/fileName`。サンプル値: `/app/scripts/full_data_load.groovy` データベース・アプリケーション表統合によるスクリプトの詳細は、「Groovyを使用したデータベース・アプリケーション表(MSSQL)のカスタム・スクリプトの開発」を参照してください。
リレーションシップ・データ・スクリプトの追加		プロビジョニング操作を実行するためにデフォルトのSQL文ではなく、カスタム・ストアド・プロシージャまたはSQL文を使用するカスタム・スクリプト。複数値属性の追加プロビジョニング操作用に作成されたGroovyスクリプト(アカウントの権限を含む)のファイルのURLを入力します。このスクリプトは、複数値の子属性を追加した場合に呼び出されます。ファイルURLは次の書式で入力する必要があります: `/directoryName/fileName`。サンプル値: `/app/scripts/add_mulval_attr.groovy` データベース・アプリケーション表統合によるスクリプトの詳細は、「Groovyを使用したデータベース・アプリケーション表(MSSQL)のカスタム・スクリプトの開発」を参照してください。
リレーションシップ・データ・スクリプトの削除		プロビジョニング操作を実行するためにデフォルトのSQL文ではなく、カスタム・ストアド・プロシージャまたはSQL文を使用するカスタム・スクリプト。複数値属性の削除(アカウントの権限を含む)プロビジョニング操作用に作成されたGroovyスクリプトのファイルURLを入力します。このスクリプトは、複数値の子属性を削除した場合に呼び出されます。ファイルURLは次の書式で入力する必要があります: `/directoryName/fileName`。サンプル値: `/app/scripts/remove_mulval_attr.groovy` データベース・アプリケーション表統合によるスクリプトの詳細は、「Groovyを使用したデータベース・アプリケーション表(MSSQL)のカスタム・スクリプトの開発」を参照してください。

「追加」をクリックして、オーケストレート済システムを作成します。

完了

ワークフローの最後のステップは「終了」で、オーケストレート済システムのエージェントをダウンロードするように求められます。エージェントをダウンロードしたら、間接統合のためのOracle Access Governance Agentの管理の手順を使用して、環境にエージェントをインストールおよび構成できます。

データ・ロードを実行する前にオーケストレート済システムをさらに構成するか、デフォルト構成を受け入れてデータ・ロードを開始するかを選択できます。次の中から1つ選択します。

システムでデータ・ロードを有効化する前にカスタマイズします
指定されたデフォルトで、データ・ロードのアクティブ化と準備を行います

構成後処理

中間スキーマJSONファイルの更新

エージェントのインストールが完了すると、中間スキーマJSONファイルであるschema.jsonがエージェント・ホストに作成されます。このファイルは、統合データベース内の表を、Oracle Access Governanceで表現されるスキーマにマップします。初期スキーマJSONファイルは、データ・ロード、UID、NAME、STATUSおよびPASSWORD (ユーザーが構成した場合)に対して有効化された基本属性を使用して作成されます。完全データ・ロード操作は、この初期スキーマJSONファイルを使用して実行でき、これらの基本属性のみのデータをロードします。次に、スキーマJSONファイルをさらに変更して、次のデータ・ロード操作にさらに属性を含めることができます。

ノート

エージェントを実行するオペレーティング・システム・ユーザーのスキーマJSONファイルに対する読取り/書込み権限が付与されていることを確認します。

schema.jsonの編集時に使用可能な構造およびオプションの詳細は、スキーマJSONファイル・リファレンスを参照してください。

Oracle Cloud Infrastructureドキュメント