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

j5 Maximo Integration Configuration

Language
English (United States)
Product
j5
Search by Category
Administration & Configuration
j5 Version
2019

A SOAP Username and SOAP Password are required for the SOAP interface between j5 and Maximo. j5 uses these credentials to authenticate with Maximo when calling Maximo’s exposed web services. These credentials are encrypted within the j5 configuration.

You can configure the Maximo server with a trusted connection. If this is the case, the SOAP user name and password are not used - use a dummy user name and password to proceed with the 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).

To create such a file:

  1. Navigate to the HTTPS URL in your web browser. View the certificate chain.

  2. Open the Windows Certificate Store in the Microsoft Management Console. Find each relevant certificate, and select 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 the contents of the other files into it.

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