Last updated on April 27, 2017

SSL configuration

This article provides the instructions to configure Appspace to use HTTPS for all user and device communications, using one of the following options:


Prerequisites

  • IIS Management Console installed.
  • A valid SSL certificate (.crt file or .pfx file) from a trusted Certificate Authority (CA).
  • Windows Server user credentials with local administrator privileges.
  • Appspace user credentials with a Portal Administrator role.

Option 1: Configure Your SSL Certificate Within Appspace

  1. From the Appspace menu, select System > Configuration.

  2. Select the Site tab and click the browse button to upload your SSL certificate. Click Save.


  3. In the Confirmation window, click Yes.

  4. The system should automatically detect a change to the Appspace settings and prompt you with a notification at the top of the page. Click the “Click Here” link.

  5. You will automatically be taken to the Apply Configuration tab. To finish applying the changes to the system settings, enter your Windows server credentials and click Apply.


    Warning

    The username and password should be your Windows server administrator credentials or an account with local administrator privileges to make and apply changes to server settings. This is NOT your Appspace on-premises server administrator credentials or your Appspace Cloud user credentials.

  6. In the Confirmation window, click Yes to restart your Appspace on-premises server. You should see a message indicating the Appspace server’s restart progress.

  7. If successful, you should be presented with an Information window confirming the update. Click OK to complete the process.

    Note

    You can confirm the changes in security settings by opening a web browser on a separate workstation and logging into Appspace using https in the address bar. All users accessing Appspace should now be securely encrypted with the HTTPS protocol.


Option 2: Complete Certificate Request with a SSL Certificate (.crt file)

  1. To install the SSL certificate, open IIS and select the root server node from the left pane. Double-click the Server Certificates icon under the IIS group.


  2. Under Actions, click the Complete Certificate Request link.


  3. Click the file browse button and locate your SSL certificate (.crt) file on the server.


  4. Change the file type filter to all (*.*) and select the SSL certificate.


  5. Key in the Appspace on-premises server domain name in the Friendly name field and click OK.


    Note

    Appspace must have a valid unique domain name.

  6. The installed SSL certificate should be visible under Server Certificates.


  7. In the left pane, expand Sites and select Default Web Site. Under Actions on the right side, click Bindings.


  8. In the Site Bindings dialog box, click the Add button.


  9. In the Add Site Binding dialog box, select https under Type. Select the SSL certificate based on the friendly name set in Step 5 and click OK to add the binding.


    Note

    You can confirm the changes in security settings by opening a web browser on a separate workstation and logging into Appspace using https in the address bar. All users accessing Appspace should now be securely encrypted with the HTTPS protocol.


Option 3: Import an SSL cert using a Personal Information Exchange file (.pfx)

  1. To install the SSL certificate, open IIS and select the root server node from the left hand side navigation tree. Double Click the Server Certificates icon under the IIS group.


  2. Under Actions, Click the Import link.


  3. Click the file browse button and locate your SSL certificate (.pfx) file on the server.


  4. Select the SSL certificate and click Open.


  5. Key in the password. (provided with the certificate)


  6. The installed SSL certificate will be visible under Server Certificates.


  7. In the left pane, expand Sites and select Default Web Site. Under Actions on the right side, click Bindings.


  8. In the Site Bindings dialog box, click the Add button.


  9. In the Add Site Binding dialog box, select “https” under Type. Select the SSL certificate and click OK to add the binding. All users accessing Appspace are now securely encrypted with the HTTPS protocol.

    Note

    Confirm the changes in security settings by logging into Appspace using https in the address bar from a a web browser on a separate workstation.