Oracle CX (Sales)統合の前提条件

オーケストレート済システムを統合および構成する前に、次の前提条件を満たしてください。

ステップ1: データ・ロールおよびセキュリティ・プロファイルの作成

オーケストレート済システムを構成する前に、サービス・アカウントを作成し、Oracle Access Governanceとの統合に必要な権限を付与します。

必須ロール:
  • ITセキュリティ・マネージャ・ジョブ・ロール(ORA_FND_IT_SECURITY_MANAGER_JOB)
  • 人材管理統合スペシャリスト(ORA_HRC_HUMAN_CAPITAL_MANAGEMENT_INTEGRATION_SPECIALIST_JOB))
  1. Oracle Fusion Cloud Applicationsとサインインします。
  2. 「自分の企業」→「設定および保守」に移動します。
  3. ページの右側にある「タスク」アイコンを選択します。
  4. 「検索」を選択し、「データ・ロールおよびセキュリティ・プロファイルの管理」を選択します。
  5. セキュリティ・プロファイルがないHuman Capital Management Integration Specialistジョブ・ロールを検索します。
  6. 「+作成」を選択します
    • データ・ロールの名前を入力します。たとえば、<ServiceAccountName>-DataRoleです。
    • 継承するHuman Capital Management Integration Specialistジョブを選択します。
    • 「OK」を選択します。
  7. 「次へ」を選択します。
  8. セキュリティ・コンテキスト・ページで、セキュリティ・プロファイル構成全体のリストで「すべて表示」を選択します。
  9. 「次へ」を選択して確認し、「送信」を選択します。
  10. 作成したデータ・ロールを検索します。これで、「Security Profile Assigned」列が選択されています。
  11. 「完了」を選択します。

次に、サービス・アカウントを作成し、このデータ・ロールをサービス・アカウントに割り当てます。

ステップ2. サービス・アカウントの作成およびデフォルト・ロールの付与

オーケストレート済システムで接続を構成する場合は、サービス・アカウントを使用します。このサービス・アカウントは、デフォルトのOracle Fusion Cloud Applicationsロールおよび権限を使用するか、カスタム・ロールを使用して設定できます。

ステップ2.1 Oracle Fusion Cloud Applicationsでのサービス・アカウントの作成

ITセキュリティ・マネージャ・ジョブ・ロール(ORA_FND_IT_SECURITY_MANAGER_JOB)が必要です。

  1. Oracle Fusion Cloud Applicationsへのサインイン。
  2. 「ナビゲータ」から、「ツール」→「セキュリティ・コンソール」に移動します。
  3. 「ユーザー」→「ユーザー・アカウントの追加」を選択します。
  4. ユーザー情報の必須フィールドに入力します。
  5. 「保存してクローズ」を選択します。ステータスが「アクティブ」であることを確認します。
  6. ユーザーを選択し、「編集」を選択します。

ステップ2.2サービス・アカウントへのロールの追加

  1. 「ロールの追加」ボタンを選択します。
  2. デフォルト・ロールをアカウントに1つずつ割り当てます。
    • 統合スペシャリスト(ORA_FND_INTEGRATION_SPECIALIST_JOB)
    • アプリケーション実装コンサルタント(ORA_ASM_APPLICATION_IMPLEMENTATION_CONSULTANT_JOB)
    • 営業管理者(ORA_ZBS_SALES_ADMINISTRATOR_JOB)
  3. ステップ1で作成したデータ・ロールを割り当てます。ステップ1: データ・ロールおよびセキュリティ・プロファイルの作成を参照してください。
  4. 「保存してクローズ」を選択します。
  5. アカウントを検索し、必要なロールが割り当てられていることを確認します。
  6. サインインして、新しいサービス・アカウントの作成を確認します。

ステップ2.3カスタム・ロールを使用した権限の付与- 最小権限の原則

デフォルトのOracle Fusion Cloud Applicationsロールおよび権限のかわりに権限を使用して、サービス・アカウントのカスタム・ロールを設定します。これは、サービス・アカウントに必要なファイングレイン権限のみを構成することによって、最小権限の原則に準拠します。

カスタム・ロールを作成する手順は、次のとおりです。
  1. 「共通- ジョブ・ロール」カテゴリのOracle Fusion Cloud Applicationsロールを作成します。
  2. 機能セキュリティ・ポリシーのトレイン・ストップに権限を追加します。「権限の付与」のリストを参照してください。
  3. 正しいデータセットのデータ・セキュリティ・ポリシーをカスタム・ロールに付与します。正しいデータ・セキュリティ・ポリシーを付与しない場合、一部のデータが返されない可能性があります。APIコールは失敗しません(200 OK)。ただし、データ・セキュリティ・ポリシーが省略されている場合、カウントは0になります。
  4. ステップ1で作成したデータ・ロール(ORA_HRC_HUMAN_CAPITAL_MANAGEMENT_INTEGRATION_SPECIALIST_JOB)を割り当てます。ステップ1: データ・ロールおよびセキュリティ・プロファイルの作成を参照してください。

ステップ2.4カスタム・ユーザーへの権限の付与

デフォルトのロールを使用するかわりにカスタム・ロールを作成し、必要なファイングレイン権限のみを付与することで、最小限の権限を確保します。データ・ロールORA_HRC_HUMAN_CAPITAL_MANAGEMENT_INTEGRATION_SPECIALIST_JOBを権限とともに割り当てます。

ノート

適切なデータセット(たとえば、/workers)へのアクセスを有効にするには、必要なデータ・セキュリティ・ポリシーを付与し、関連するロールに関連付ける必要があります。正しいデータ・セキュリティ・ポリシーが構成されていない場合、APIコールは失敗しません(200 OK)。ただし、レスポンスにはデータが含まれません(カウントは0になります)。詳細は、データ・セキュリティ・ポリシーを参照してください。
エンドポイント/機能性 機能セキュリティ・ポリシーの権限
/userAccounts

権限名: RESTサービスの使用- ユーザー・アカウント

権限コード: PER_REST_SERVICE_ACCESS_USER_ACCOUNTS_PRIV

/workers

権限名: RESTサービスの使用- 就業者

権限コード: PER_REST_SERVICE_ACCESS_WORKERS_PRIV

/userAccounts LOV

RESTサービスの使用- ユーザーおよびロール値リスト

PER_REST_SERVICE_ACCESS_USERS_AND_ROLES_LOVS_PRIV

ステップ2.5「アクセス制御データのリフレッシュ」ジョブの実行

サービス・アカウントを構成した後、アクセス制御データ・ジョブを実行する必要があります。このジョブは、デフォルトで1時間ごとに実行されるか、手動で実行するように選択できます。ジョブを実行するには:
  1. 「ツール」→「スケジュール済プロセス」に移動します。
  2. アクセス・コントロール・データのリフレッシュを検索します。
  3. 「新規プロセスのスケジュール」を選択します。
  4. ジョブ名として「アクセス制御データのリフレッシュ」を選択し、わかりやすい説明を入力します。
  5. 必要に応じて、[完全リフレッシュ]または [増分リフレッシュ]を選択します。
  6. 「OK」を選択します。
  7. 「送信」を選択します。プロセスID番号をコピーします。
  8. 「ユーザーおよびロールの同期プロセス」を実行して、最新のユーザーおよびロール定義を取得します。詳細は、Run User and Roles Synchronization Processを参照してください。

OCI IAMによる認証および認可

OCI IAMを使用して、Oracle Access GovernanceでOracle CX (Sales)を認証および認可します。

前提条件

OAuthを使用してOracle CX (Sales)を認可するには、次の前提条件を満たす必要があります。
  • サービス・アカウントを作成し、Oracle Access Governanceとの統合に必要な権限を付与します。
  • Oracle Fusion Cloud Applicationsアプリケーションがホストされているのと同じアイデンティティ・ドメインで構成が実行されていることを確認します。

アクセス証明書とキー

セキュアな認証と互換性のために、信頼できる認証局(CA)によって発行された証明書をPEM形式で使用するか、OCI証明書サービスを利用して証明書を効率的に生成および管理します。

  1. 信頼できる認証局をPEM形式で使用します。
  2. パブリック証明書を取得するには、トークンを発行して署名するようにアイデンティティ・ドメインが構成されていることを確認します。
    1. 「アイデンティティとセキュリティ」で、「ドメイン」を選択します。
    2. 「設定」タブで、署名証明書へのアクセスを有効にします。

FAインスタンスのOCI IAMドメインへの信頼できるパートナ証明書としての証明書のインポート

  1. 「アイデンティティとセキュリティ」に移動し、「ドメイン」を選択します。
  2. Oracle Fusion Cloud Applicationsサービス・インスタンスのコンパートメントを検索して選択し、ドメインを選択します。
  3. 「セキュリティ」タブを選択します。
  4. 「信頼できるパートナ証明書」セクションに移動し、「証明書のインポート」を選択します。
  5. キーストア・ファイル証明書別名の生成時に指定した別名を入力します
  6. .cerファイルをインポートします。
  7. 「インポート」を選択します。

結果: 正しい詳細がSHA-1サムプリント、SHA-256サムプリント、証明書開始日および証明書終了日とともに表示されることを確認します。

統合機密タイプ・アプリケーションの作成

  1. 「アイデンティティとセキュリティ」に移動し、「ドメイン」を選択します。
  2. 必要なドメインを選択します。
  3. 「統合アプリケーション」タブを選択します。
  4. 「アプリケーションの追加」を選択します。
  5. 「機密アプリケーション」タイルを選択し、「ワークフローの起動」を選択します。
  6. 「詳細」ページで、次を入力します:
    1. 機密アプリケーションの名前と説明を入力します。
    2. 「送信」を選択します。

OAuthの構成の編集

  1. 「OAuth構成」タブを選択します。
  2. 「OAuth構成の編集」を選択します。
  3. クライアント構成: 「今すぐこのアプリケーションをクライアントとして構成します」を選択します。
  4. 権限付与タイプの有効化: 「クライアント資格証明」、「JWTアサーション」および「リフレッシュ・トークン」権限付与タイプを選択します。
  5. 「クライアント・タイプ」オプションとして「信頼済」を選択します。
  6. 以前に使用した証明書をインポートします。
  7. 「許可された操作」として「代理」を選択します。
  8. 「ネットワーク・ペリメータ」を選択して、サインイン試行を特定のIPまたは範囲に制限するか、「任意の場所」を選択します。
  9. 「トークン発行ポリシー」で、「すべて」を選択します。
  10. スコープ構成
    1. 「リソースの追加」トグルを有効化
    2. 「スコープの追加」を選択します
    3. Oracle Fusion Cloud Applicationsアプリケーション参照を選択します。
      ノート

      スコープがリストされていない場合は、「Oracle Cloud Services」タブから、Oracle Fusion Cloud Applicationsインスタンスがこのドメインに登録されているかどうかを確認します。
  11. 「送信」を選択します。
  12. アプリケーションをアクティブ化します。「アクション」アイコンを選択して、「アクティブ化」を選択します。ステータスは、[非アクティブ]から [アクティブ]に変更する必要があります。

認可の機密OAuthアプリケーション詳細のフェッチ

  1. 作成した機密OAuth統合アプリケーションを開きます。
  2. 「OAuth構成」タブを選択します。
  3. 「一般情報」セクションで、「クライアントID」および「クライアント・シークレット」をコピーして保存します。
  4. 「リソース」セクションで、アプリケーション・スコープをコピーして保存します。

資格証明を格納するOCI Vaultの作成

このステップは、統合設定時にOCI Vaultを使用する場合にのみ実行します。Oracle Access Governanceでは、OCI Vault and Secret Managementサービスを使用して、パスワード、クライアント・シークレット、秘密キーなどの機密値を格納します。

Oracle Access Governanceインスタンスが構成されているBasic認証資格証明のOracle Cloud Infrastructure (OCI)ボールト、暗号化キーおよびシークレットを作成します。

この方法は、セキュアな資格証明管理に推奨されます。必要なアクセス権があることを確認します。
  • ターゲット・コンパートメントにボールト、キーおよびシークレットを作成する権限。
  • シークレットの暗号化にキーを使用する権限。
  1. テナンシ管理者としてのOracle Cloud Infrastructure Consoleへのサインイン。
  2. ナビゲーション・メニューを開き、「Identity & Security」→「Key Management & Secret Management」を選択します。
  3. Create a vault.
  4. ボールトがアクティブ状態の場合は、暗号化キーを作成します。「マスター暗号化キーの作成」を参照してください。
  5. ナビゲーション・メニューから、「アイデンティティとセキュリティ」、「シークレット管理」の順に選択します。
  6. 「シークレットの作成」を選択します。
  7. シークレットを作成するコンパートメントを選択します。
  8. わかりやすいシークレット名を入力します。たとえば、agcs-cx-vaultです。
  9. ボールト・コンパートメントとボールト名を選択します。
  10. 暗号化キー・コンパートメントを選択します。
  11. 「暗号化キー」フィールドで、作成したキーを選択します。
  12. 「手動シークレット生成」を選択します。
  13. シークレットの内容:
    • Basic認証を使用する必要がある場合は、次のように入力します。
      {
        "adminUser": "<your-admin-username>",
        "adminPassword": "<your-admin-password>"
      }
    • OAuthの場合は、OAuth前提条件を実行し、詳細を入力します:
      {
        "adminUser": "admin@example.com",
        "domainURL": "https://idcs-<tenant>.example.com",
        "clientId": "<client-id>",
        "clientSecret": "<varname><this-is-not-the-secret></varname>",
        "privateKey": "<varname>&lt;this-is-not-the-secret&gt;</varname>",
        "alias": "my-signing-key",
        "scope": "urn:opc:idm:__myscopes__"
      }
      パラメータ詳細
  14. 「シークレットの作成」を選択します。
  15. にテナンシのOCIDおよびシークレットOCIDを入力します。これにより、コンソールで必要なIAMポリシーが生成されます。シークレットの詳細を確認するには、シークレット詳細の表示を参照してください。
  16. ボールトを作成したOracle Access Governanceテナンシのルート・コンパートメントの正確な文をコピーします。