Overview

This guide explains how to install and configure an SSL certificate on a Windows server using IntraWeb (built-in web server). This method uses a PFX file, which contains both the certificate and private key.


Requirements

Before proceeding, ensure you have:

  • A valid SSL certificate
  • The PFX file (.pfx)
  • The PFX password
  • IntraWeb application (version 15 or later)

Installation Steps

1. Locate the PFX File

After downloading your certificate bundle, you can usually find the .pfx file inside the extracted IIS folder.

Copy the .pfx file to:

  • The same directory as your application (.exe) (recommended), or
  • A directory accessible by the application

2. Install OpenSSL Libraries

Ensure the following OpenSSL DLL files are available:

  • libssl-1_1.dll
  • libcrypto-1_1.dll

Place them in the same directory as your application executable.


3. Configure SSL in IntraWeb

Update your ServerController configuration in Delphi:

 
IWServerController.SSLOptions.PFXFile := 'certificate.pfx';
IWServerController.SSLOptions.PFXPassword := 'your_password';
 

Make sure:

  • The file path is correct
  • The password matches the PFX file

4. Enable HTTPS

Configure your application to use HTTPS:

 
IWServerController.Port := 443;
 

(Optional) Redirect HTTP to HTTPS:

 
IWServerController.SSLOptions.NonSSLRequest := nsRedirect;
 

5. Restart the Application

Restart the IntraWeb server to apply the SSL configuration.


6. Test HTTPS Access

Open a browser and access your application using HTTPS:

 
https://your-domain.com or https://your-server-ip
 

Notes

  • Ensure your certificate matches the hostname or IP address being accessed
  • Some browsers may show warnings if the certificate does not match the access method
  • Firewall settings must allow traffic on port 443

Troubleshooting

SSL not working

  • Verify the PFX file path and password
  • Ensure OpenSSL DLL files are present
  • Confirm the application has been restarted

SSL initialization errors

  • Check OpenSSL version (must be 1.1.x)
  • Ensure DLL files are correctly loaded

Summary

To install an SSL certificate in IntraWeb:

  • Use a PFX file
  • Configure SSL in ServerController
  • Ensure OpenSSL libraries are available
  • Restart the application
Was this answer helpful? 766 Users Found This Useful (1208 Votes)