CPQ構成のOracle IDCS OAuthサポート

25Cリリース以降、Oracle CommerceはCPQ構成用のOracle IDCS OAuth統合をサポートしています。

この機能により、強化されたセキュリティが提供され、CPQとの統合パターンが標準化されます。

有効化のステップ

CPQ構成のネイティブ統合に対して IDCS OAuthを有効にするには:CPQ構成のネイティブ統合に対して IDCS OAuthを有効にするには:

  1. APIを介したIDCS OAuth統合の有効化: updateCloudConfiguration APIを使用して、IDCS OAuthを有効にします。
    API: PUT /ccadmin/v1/merchant/cloudConfiguration
    ペイロード:
    {
    "CPQConfigIDCSEnabled": true
    }




  2. セルフサービスCPQ統合の構成:
    • 「設定」-> Oracle Integrationに移動
    • 統合ドロップダウンから「セルフサービスCPQ」を選択
    • IDCS統合の詳細を入力

CPQ構成のSSEベースの統合に対して IDCS OAuthを有効にするには:

  1. 管理コンソールで構成のネイティブ統合を有効にします。
    1. 管理コンソールにログイン
    2. ナビゲーション: 「設定」-> Oracle Integrations
    3. ドロップダウンから「CPQ構成(ネイティブ)」を選択
    4. 統合の有効化 

ノート: 「構成のプレビュー」セクションまたは「本番構成」セクションを構成しないでください。

  1. CPQセットの適切なスコープを使用して、IDCSで付与タイプがクライアント資格証明である機密アプリケーション (クライアント・アプリケーション)を作成します。 CPQでは、CPQ REST APIにアクセスするための次のスコープがサポートされています: api、/api、<hosturl>/api、および<hosturl>api。 アプリケーションをアクティブ化します。 アプリケーションのクライアントIDおよびクライアント・シークレットを記録します。 IDCSアプリケーションの作成の詳細は、「Oracle Identity Cloud Serviceの管理」を参照してください。
  2. この「ドキュメント」の「統合センターを使用したOAuthプロバイダ統合の構成(Oracle CPQ 22D以降)」の項の指示に従って、CPQでOAuthプロバイダを設定します。 「ドキュメント」のステップに従ってテナント署名証明書の設定を完了し、インバウンドREST APIコール中にアクセス・トークンを検証します。 クライアント・アプリケーションCX Commerceの「構成」タブの「一般情報」セクションから、クライアントIDおよびクライアント・シークレットを使用します。 上記のドキュメントのクライアント・アプリケーション構成およびOpenID Connectは、統合に必要ないため無視してください。
  3. 次のSSE環境変数の登録: 次のコマース管理doCreateExtensionVariable REST APIを使用したCPQ_IDCSENABLED、IDCS_CLIENTIDおよびIDCS_CLIENTSECRET。 IDCS OAuthを使用するには、CPQ_IDCSENABLEDをtrueに設定する必要があります。
  4. 「管理コンソール」->「設計」->「開発者」」タブから、cpq-configurator-app-store.zipの25.7.0バージョンをダウンロードします。 次のアクションを実行します:
    • Unzipします
    • config.jsonを編集し、idcsHostname変数およびidcsCPQAppScope変数を更新して、IDCSホストおよびCPQのアプリケーション・スコープを参照
    • npmインストールの実行
    • zipを作成します。
  5. コマース管理doSSEFileUploadMultipart REST APIを使用して、zipされたSSEをSSEサーバーにアップロードします。

ヒントと考慮事項

  • 両方が構成されている場合、ネイティブ構成のIDCS OAuthが「ネイティブ構成用のCPQ OAuth」よりも優先されます。
  • SSEベースの構成統合が機能するには、CPQ構成(iFrame)またはCPQ構成(ネイティブ)のいずれかを有効にする必要があります。