SOAP Authentication - j5 - 28.0 - Administration & Configuration - Hexagon PPM

j5 Maximo Integration Configuration

Administration & Configuration

It is necessary to set a SOAP Username and SOAP Password for the SOAP interface between j5 and Maximo. j5 will use these credentials to authenticate with Maximo when calling Maximo’s exposed web services. These credentials are not stored as raw text, but are encrypted within j5 configuration.

It is possible to configure the Maximo server with a trusted connection in which case the SOAP user name and password are not used. It this scenario, a dummy user name and password can be entered in order to proceed with setup.

If your SOAP connection uses HTTPS (recommended for security) and has a custom certificate chain (issued within your organization rather than part of the public trust network), you can use the Certificate Bundle configuration option to supply the required certificates. This should point to a local file containing a Base64-encoded X.509 certificate store in PEM format, with the full chain of certificates: the Root Certificate Authority, Intermediate Certificate Authority, and server certificate (in that order).

You can create such a file by:

  1. Navigating to the HTTPS URL in your web browser, and viewing the certificate chain

  2. Opening the Windows Certificate Store in the Microsoft Management Console Finding each relevant certificate, and selecting Action -> All Tasks -> Export....

  3. Save each certificate as a Base-64 encoded X.509 (.CER) file

  4. Create a new file in a text editor, and copy each of the contents of the other files into it

If your SOAP connection uses HTTPS, please ensure that the URLs linked to from its WSDL files also use HTTPS. If they use HTTP, you may encounter an "SSL Protocol Error" as j5 will attempt to communicate with HTTPS