Home Security Configuring HostedSuite for SSL

Configuring HostedSuite for SSL

Last updated on Apr 30, 2025

🔐 Configuring HostedSuite for SSL

Secure HostedSuite with SSL (Secure Sockets Layer) to enable encrypted access via https://. This guide is for IT administrators and HostedSuite managers.

✅ Prerequisites

  • Admin access to DNS and server settings

  • A valid SSL certificate for your domain

  • Access to HostedSuite installation folder

  • Ability to edit configuration files with admin rights

Step 1: Choose a Domain Name & Purchase SSL Certificate

  1. Decide on a subdomain (e.g., console.abccorp.com) for the HostedSuite console.

  2. Purchase a standard SSL certificate (e.g., from GoDaddy or DigiCert) for that domain.

📝 The domain name and certificate must match exactly.

Step 2: Configure DNS

Update DNS settings to point your new subdomain to the HostedSuite server’s IP address.

Example:
If your server IP is 192.168.0.21 and your domain is console.abccorp.com, create an A record to link them.

Step 3: Export the SSL Certificate to a PFX File

  1. On a Windows PC, open Manage Computer Certificates.

  2. Find the installed SSL certificate under Personal > Certificates.

  3. Right-click → All Tasks → Export.

  4. Select Yes, export the private key.

  5. Choose Personal Information Exchange (.PFX).

  6. Enable "Export all extended properties" and set a password.

  7. Save the file (e.g., evo-console.pfx).

🔗 Useful resources:

Step 4: Configure HostedSuite to Use the SSL Certificate

  1. Copy the .pfx file to the HostedSuite server (e.g., C:\Program Files (x86)\Evo\HostedSuite\Bin).

  2. Stop the HostedSuite service.

  3. Run Notepad as Administrator and open:
    C:\Program Files (x86)\Evo\HostedSuite\Bin\HostedSuiteServer.exe.config

  4. Locate:

    <appSettings>
  <add key="SslCertificatePath" value="" />
  <add key="SslCertificatePassword" value="" />
</appSettings>

  5. Add the full path and password:

    <appSettings>
  <add key="SslCertificatePath" value="C:\Program Files (x86)\Evo\HostedSuite\Bin\evo-console.pfx" />
  <add key="SslCertificatePassword" value="your_password_here" />
</appSettings>

  6. Save the file.

Step 5: Restart & Use the Secure URL

  1. Start the HostedSuite service.

  2. Use the new secure URL:
    https://your-domain-name:21483
    Example: https://console.abccorp.com:21483

⚠️ All operators must use this new HTTPS link.

🛠 Troubleshooting

Problem: Page doesn’t load

  • Try ping your-domain.com to confirm DNS resolution.

  • Check firewall or port settings (ensure 21483 is open).

Problem: SSL security warning

  • Ensure the domain in the browser exactly matches the SSL certificate.
    (e.g., console.abccorp.com ≠ consoel.abccorp.com)

Problem: Page keeps spinning

  • Check logs at:
    C:\Program Files (x86)\Evo\HostedSuite\Logs\HostedSuite-Server.log

  • Look for incorrect password or certificate errors.

Need Help?

Contact support and provide:

  • Your domain name

  • Screenshot of the error

  • HostedSuite server logs (if available)