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.dlllibcrypto-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.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:
(Optional) Redirect HTTP to HTTPS:
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:
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
