These instructions apply to Gateway version 1.8 and newer. |
An error occurs because the Gateway server does not trust the certificate for EcoStruxure IT.
Cause
For security reasons, the EcoStruxure Gateway validates that the certificate used to secure communication between EcoStruxure IT and the Gateway was issued by a well known trusted certificate authority. An error occurs when you use a TLS/SSL interception proxy, which is indistinguishable to the Gateway from a man-in-the-middle attack.
If your organization uses a TLS/SSL interception proxy to inspect the encrypted network communications between the Gateway and EcoStruxure IT, the Gateway must be configured to trust the certificate authority that the TLS/SSL interception proxy uses to issue certificates.
SECURITY WARNING: Only install CA certificates that you and your organization trust. Never install certificates that were obtained from an untrusted source.
Solution
Obtain the correct certificate, and add it to the EcoStruxure Gateway trust store.
You can either obtain the correct certificate directly from your organization's IT department or from a trusted system that has the correct certificate already installed.
Note: The web browser on the system the Gateway software was installed on may already have the certificate installed. See How to locate a certificate used by the web browser.
How to locate a certificate used by the web browser
- From the Gateway server, try to reach the EcoStruxure IT registration endpoint. Go to:
https://us.struxureon.com/ingester/v2/test/registration
IMPORTANT: If the URL returns a connection error, stop here. Contact your IT department to get the root certificate your proxy is using. You can then resume and import that certificate.If this test URL returns {"status":"UNREGISTERED"} your browser can successfully reach the endpoint.
-
Click the lock in the address bar of the browser and view the certificate used by us.struxureon.com. Note the certification path.
- In the Windows Control Panel, go to Internet Options > Content > Certificates.
-
Click Trusted Root Certification Authorities. Select the certificate used by us.struxureon.com.
-
Click Export.
-
Select the Base-64 encoded X.509 (.CER) option in the export.
-
Name the certificate the name shown in the Issued By column.
Add certificate to EcoStruxure Gateway trust store
- Log in to the Gateway user interface and go to Cloud Connectivity > Add root certificate.
- Click Import certificate… and then choose the certificate you exported.
-
Click Add certificate.
Note: To view or remove certificates in the Gateway, go to Settings > Trust Store.
Important: You should manually restart the Gateway service after adding or removing certificates.
Comments
0 comments
Please sign in to leave a comment.