フェーズ 2 での IBM Sterling Order Management System Software デベロッパーズ・ツールキットとの統合

Sterling Intelligent PromisingSterling Order Management System Software デベロッパーズ・ツールキットと統合するために、統合プロパティー、JWT プロパティー、および公開鍵を構成します。

手順

  1. Developer_toolkit/compose/docker/integration.properties ファイルで以下のプロパティーを構成して、 IBM® Sterling Order Management System Software デベロッパーズ・ツールキットをセットアップします。 詳しくは、 Integrated Developer Toolkit 環境のセットアップを参照してください。
    IV_ENABLE=Y
    IV_TENANTID=default
    IV_CLIENTID=DEFAULT
    IV_SECRET=DEFAULT
    IV_BASEURL=https://<SIPHOSTNAME>/inventory
    IV_ENDPOINTURL=${IV_BASEURL}/${IV_TENANTID}/v1
    
  2. V2 モードを有効にするには、システム管理 (SMA) で以下のセットアップ・プロパティーを構成します。
    iv_integration.IVApiVersion=v2
    iv_integration.nodeAvailability.apiUrl=/v2/availability/node/
    iv_integration.networkAvailability.cached.apiUrl=/v2/availability/network/
    iv_integration.nodeAvailability.cached.apiUrl=/v2/availability/node/
    iv_integration.reservations.apiUrl=/v2/reservations/
  3. JWT 認証を有効にするには、 customer_overrides ファイルで以下のプロパティーを設定します。
    iv_integration.authentication.mode=JWT
    

    デフォルトでは、JWT 認証は Sterling Order Management System Software デベロッパーズ・ツールキットで無効になっています。

  4. JWT 鍵を生成します。
    Sterling Intelligent Promising への着信要求はすべて、署名された JWT によって認証されます。 この JWT は、 Sterling Order Management System Software で構成された秘密鍵を使用して署名され、 Sterling Intelligent Promisingで構成された公開鍵を使用して検証されます。 IBM Sterling Order Management System Software デベロッパーズ・ツールキットは、独自の秘密鍵と公開鍵のペアを使用して、デフォルトで JWT 鍵を生成できます。 セットアップまたはアップグレードの後、公開鍵は yfs.jwt.create.public.key.save Dir プロパティーで定義されたディレクトリーで使用可能になります。 このプロパティーが定義されていない場合、ファイルは、 sandbox.cfg ファイルに定義されている HOME_DIR ロケーション (製品のインストール・ロケーション) に保存されます。 秘密鍵が鍵ストアにインポートされます。
    • Sterling Order Management System Software がアプリケーション・サーバー JVM を介して Sterling Intelligent Promising と通信している場合、デフォルトでは、公開鍵は Docker ランタイム [om-appserver]・コンテナー内の /opt/ssfs/runtime に生成されます。
    • ランタイム・コンテナーから実行している統合サーバー JVM を介して Sterling Order Management System SoftwareSterling Intelligent Promising と通信している場合、デフォルトでは、公開鍵は Docker ランタイム [om-runtime] ・コンテナー内の /opt/ssfs/runtime に生成されます。
    • 抽出したコンテナーから実行している統合サーバー JVM を介して Sterling Order Management System SoftwareSterling Intelligent Promising と通信している場合、デフォルトで公開鍵が <Developer_toolkit>/runtimeに生成されます。
  5. この公開鍵を OMS ゲートウェイで構成します。 詳しくは、 公開鍵を使用した JWT 発行者シークレットの作成を参照してください。
    注:
    • Sterling Order Management System Software が独自の秘密鍵と公開鍵のペアを使用して JWT を生成する場合、異なる JVM の使用順序に応じて、JVM ごとに公開鍵と秘密鍵のペアが存在する可能性があります。 各 JVM は、指定されたフォルダーまたはデフォルトの場所に独自の公開鍵を生成します。 これらの公開鍵は、同じ鍵 ID を使用して生成されます。これは、秘密鍵のインポート時に使用される別名用語です。 認証を確実に成功させるには、 Sterling Intelligent Promisingで公開鍵を構成するときに、どの公開鍵にも鍵 ID を使用しないでください。

次のタスク

Order Hub を使用して Sterling Intelligent Promising インベントリー・データを表示する場合は、接続を構成し、 system_overrides.properties ファイルにプロパティーを追加する必要があります。

詳しくは、 Sterling Intelligent Promisingへの接続の構成を参照してください。