Configuring OAS for SSL

Using SSL with any OAS Web product as well as the REST API is fully supported.

You must first install an SSL Certificate on your server for the domain name(s) that you intend to use, for example “https://hmi.myserver.com:58726”. Once the certificate is installed properly on the server, check Use SSL and select the installed certificate from the dropdown menu.

IoT Web HMI Dashboard start services dialog

Node Name:
When not using SSL, this should remain as localhost. But when using SSL, this Node Name field should be set to the exact domain name (e.g. myapp.mydomain.com) configured in your certificate.

Port:
This defaults to 58725, but you can set this to anything you prefer, as long as the computer and network firewalls will allow clients to reach this machine on that port. We also suggest using a different port number when switching to SSL to avoid confusion when testing different methods and configurations.

SSL Certificate (host:issuer):
This dropdown will be populated with all certificates installed in the computer. Choose the proper certificate and click REGISTER. You will be asked if you want to proceed since it will require the OAS services to be restarted.

NOTE: If you are using the REST API and changing any port or SSL configurations, be sure to restart the OAS Framework 4.5 Service as well. If this service does not appear on your OAS Service Control utility, no further action is required.

Obtaining an SSL Certificate

Purchasing and installing an SSL certificate is outside of the scope of the OAS product. For more information on Windows and Certificates, see the following article.

During development, you may not have the final domain name that you will be using in production, but you would still like to test SSL communications. Many developers employ self-signed certificates. For more information, see this article.

 

 



More: