Create a new HTTPS connection configuration - j5 - 30 - Connectors & Integration - Hexagon

j5 GE Proficy Connector Configuration
ft:locale
en-US
Product
j5
Search by Category
Connectors & Integration
j5 Version
30

You only need to create a new HTTPS connection configuration when there is another HTTPS connection configured. If no other HTTPS connection is needed, don't create a new HTTPS connection node and just enter the connection details on the standard HTTPS Connection Configuration node.

  1. Right-click the HTTPS Connection Configuration node in the j5 System Management Console and select New HTTPS Connection Configuration. A dialog box appears.

  2. Enter a name for the connection (for example, Proficy) and select OK. A new connection node appears.

  3. Enter the connection details:

Configuration point

Description

Authentication Type

Select OAuth

Base URL

Enter the base URL parameter. This is the fully qualified domain name to connect to the GE Proficy Web endpoints (for example, https://proficy.example.com).

Certificate Bundle Filename

If your GE Proficy connection uses HTTPS (recommended for security) and has a customer certificate chain (issued within your organization rather than part of the public trust network), you can use this setting to supply the required certificates.

Browse to the SSL certificate for j5 to connection to GE Proficy using HTTPS or enter the path to the location of the file.

For more information, see Certificate bundle configuration

The certificate bundle configuration needs to point to a local file containing a Base64-encoded X.509 certificate store in PEM format, with the full chain of certificates: Root Certificate Authority, Intermediate Certificate Authority, and server certificate (in that order).

To create such a file:

  1. Go 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.

Ensure that all the URLs use HTTPS. If they use HTTP, you will encounter an SSL Protocol Error because j5 will attempt to communicate with HTTPS.

Client ID

Enter the OAuth Client ID that j5 will authenticate with.

Client Secret

Enter the OAuth Client Secret that j5 will authenticate with.

OAuth Authorization URL

Enter the URL for the authorization endpoint for the OAuth Server. This normally ends with /uaa/oauth/token.

OAuth Scopes

When required, enter a comma-separated list of the scopes that are needed.