Configuring a connection to Sterling Intelligent Promising

For Order Hub to be able to connect to and display inventory data from Sterling Intelligent Promising, your Sterling Intelligent Promising tenant must accept the JWT from IBM® Sterling Order Management System Software. You can open a case with IBM Support to configure your Sterling Intelligent Promising tenant.

Procedure

  1. Retrieve the jwtId and OMS public key to send to the IBM Support team.
    1. Open the following file. 
      om-appserver:/opt/ibm/wlp/usr/servers/defaultServer/dropins/smcfs.ear/lib/properties.jar/system_overrides.properties
    2. Note the value of the yfs.yfs.jwt.create.claims.jwtId.value property. During the set up of the developer toolkit, this JWT value is set up for you. This value will need to be provided to IBM support. If this property is not defined in system_overrides.properties, you should set this value to be in the format of oms-<DTK_ID>. For example, if the DTK_ID in devtoolkit_docker/compose/docker/integration.properties is set to buc-12345, then add yfs.yfs.jwt.create.claims.jwtId.value=oms-buc-12345 in system_overrides.properties.
    3. Note the value of the yfs.yfs.jwt.create.pk.alias property. This value will be used as the -alias value in the keytool command. If this property is not defined in system_overrides.properties, the default key being used is oms-default-jwt.
    4. Go to the following directory. 
      om-appserver:/var/oms/keystore
    5. Run the following command to export the OMS public key. 
      keytool -export -keystore key.jks -alias replace_jwt_pk_alias  | openssl x509 -inform der -pubkey -noout
      where:
      • The value for -alias (replace_jwt_pk_alias) is the value that you noted from the yfs.yfs.jwt.create.pk.alias property in step 1.c.
      • The password for key.jks is: secret4ever.
      Note:

      If you want to replace the default key pair, you can set the yfs.yfs.jwt.create.pk.alias=<key alias> property in system_overrides.properties.

  2. Open a case with IBM Support and provide the jwtId and the OMS public key.
  3. Add the following properties to the system_overrides.properties file.
    • yfs.yfs.jwt.create.algorithm=RS256
    • yfs.yfs.jwt.create.claims=ivTenantId,envId,jwtId
    • yfs.yfs.jwt.create.claims.ivTenantId.value=<IV tenant ID>
    • yfs.yfs.jwt.create.claims.envId.value=<DTK ID>
    • yfs.yfs.jwt.create.pk.alias=<key alias>
    • yfs.yfs.jwt.create.claims.jwtId.value=oms-<DTK ID>