Authentication and secure communication for Maximo integration

You must set up authentication to enable secure communication between IBM® Maximo®, IBM WebSphere® Cast Iron® Live, and IBM Analytics Solutions Manager on Cloud.

Authentication from Cast Iron Live to Maximo

An IBM WebSphere Cast Iron Live Secure Connector enables secure data transfer from Cast Iron Live to an IBM Maximo end point that is located behind a firewall. You must complete the following steps to enable a Secure Connector:
  1. Create a Secure Connector in Cast Iron Live.
  2. Download the Secure Connector configuration file and installer.
  3. Install the Secure Connector in the Maximo environment, behind the firewall.
  4. Configure the Secure Connector configuration file.
  5. Start the Secure Connector and verify communication.

For more information about installing and configuring a Secure Connector, see the IBM Redbook titled "Getting Started with IBM WebSphere Cast Iron Cloud Integration".

After the Secure Connector is enabled, in Cast Iron Live, configure authentication credentials in the properties of the Cast Iron project to enable project orchestrations to make HTTP requests to the REST API of IBM Maximo.

Authentication from Maximo to Cast Iron Live

By default, Maximo communicates securely with Cast Iron Live by using a DigiCert Global Root CA certificate. You must complete the following steps to import the certificate to the default truststore in IBM WebSphere Application Server:
  1. Log in to the IBM WebSphere Application Server Integrated Solutions Console and select Security > SSL Certificate and key management > Key stores and certificates.
  2. Click NodeDefaultTrustStore.
  3. Click Signer Certificates.
  4. Click Retrieve from port.
  5. Enter the Cast Iron Live Host name, SSL Port, and Alias of the web server. The Alias is factory supplied identity.
  6. Click Retrieve Signer Information and then click OK. The root certificate is added to the list of signer certificates.
  7. Restart the IBM WebSphere Application Server Integrated Solutions Console.

After the certificate is imported, use the Maximo end point definition to configure the end point and authentication credentials for accessing Cast Iron orchestrations that are exposed as REST services.

Authentication from Cast Iron Live to Analytics Solutions Manager on Cloud

To access the Analytics Solutions Manager on Cloud REST interface, in the Cast Iron projects that are used to integrate with IBM Maximo, you set the API key configurable property. The API key is supplied in the customer Welcome package.

Once the API key property is configured, Cast Iron orchestrations automatically set the key in the HTTP header.

Authentication from Analytics Solutions Manager on Cloud to Cast Iron Live

To access Cast Iron orchestrations that are exposed as REST services, in the solution configuration file (solutionconfiguration.xml), you set the Cast Iron Live credentials, end point URL, and Maximo write flag (to enable or disable writing to Maximo from Analytics Solutions Manager on Cloud).

Once the Cast Iron Live credentials, end point URL, and Maximo write flag are set, Analytics Solutions Manager on Cloud automatically sets the context variable for accessing Cast Iron Live.