Custom SSL Branding

Please note this feature is available for partners subscribed to Enterprise plans only.

Customize IT Glue to match the look and feel of your company's branding. When sharing public IT Glue documents with your users, make your company instantly recognizable by branding them with your company logo as well as a custom secured URL.

By default, your account displays the IT Glue domain name. You can brand your documentation with your own logo and custom URL so that “mycompany.itglue.com” (for EU partners, “mycompany.eu.itglue.com”) becomes “docs.mycompany.com”

Prerequisites

  • You must have Administrator or Manager access to IT Glue.

Instructions

  1. Sign in to IT Glue and navigate to Account.

    Account_select.png

  2. In the Settings section select the Branding tab.

  3. Enter the domain name you wish to use in the Fully Qualified Domain Name box. (Example: docs.yourcompany.com)

    Custom_SSL_Branding.png

    Important - DNS change required for partners with existing custom FQDN

    If your IT Glue account had a custom Fully Qualified Domain Name prior to the release of Custom SSL support (2018-10-31), your custom URL previously had a CNAME DNS record pointing to subdomain.itglue.com (or subdomain.eu.itglue.com for our EU data center partners). After clicking the "Enable SSL" button, we will present you with DNS settings required to perform the URL validation and SSL certificate provisioning. Please ensure to update your previous CNAME DNS record to this new value.

  4. Click Save. You will see a message indicating that the SSL Certificate is pending the creation of the validation DNS records.

    SSL_Status_Pending.png
  5. Go to your DNS control panel. You will need to enter your specific DNS and Validation DNS information into your DNS control panel. Create two CNAME records using the DNS Information and Validation DNS Mapping, respectively, from the previous step.

    Note: The above step must be completed within 72 hours of requesting the custom domain in IT Glue, otherwise a timeout error will be displayed.


  6. Once you have updated your DNS settings, AWS will automatically detect these updates and begin the SSL certificate propagation process. Please note this propagation process may take up to 24 hours.

    AWS__SSL_Certification_Blue.png

  7. Return to Account > Settings > Branding to verify the status of your SSL certificate setup. You will see the following message when completed, as well as an email notifying you of successful SSL certificate generation.

    SSL_Valid_New.png

Possible Configuration Failures

Below are possible reasons for the SSL certificate failing to be created, in which case an email indicating the failure will be triggered:

  • SSL certificate has expired. Check your DNS settings, then remove and re-add your custom domain.
  • Validation time-out error. Validation of the required DNS settings timed out since they were not created in time. Please remove and re-add your custom domain.
  • Certificate Authority Authentication (CAA) Error. This will happen if your FQDN contains a DNS record that denies Amazon Web Services from creating an SSL certificate. Please either configure your CAA records to handle such errors by removing them, or configuring them as guided here.
  • Inactive certificate. Please contact IT Glue support for assistance.
  • SSL certificate revoked. Please contact IT Glue support for assistance.
  • SSL certificate generation failed. Please contact IT Glue support for assistance.
Note on our custom SSL implementation:


Only public document URLs will be loaded outside of an iframe at this time. While using your custom URL, all other app functionality relies on presenting content inside an iframe. Please note the following:

  • The iframe is secure, as all underlying connections are also secure
  • Only public documents will currently display a full URL
  • While end users signing in to IT Glue can use the custom URL, please note that full URLs will not be displayed in the browser address bar, only your base custom URL
  • For use within your organization, we recommend using your IT Glue subdomain in order to retain visibility of complete address bar URLs
  • It is not possible to set up Single Sign-On using your custom URL. Please use your IT Glue subdomain for setting up SSO/SAML functionality

Interface Branding

Customize the look of your interface by adding your own company logo to replace the IT Glue logo in the top menu bar. Also, you can optionally hide the IT Glue branded footer.

  1. After entering your custom URL, scroll down the page to the Interface Branding section.

    interface_branding_5.png

  2. Click on Choose File and select your company logo. Your logo will be displayed.

    SSL_File_Uplod_3.png

  3. Click Hide Footer if you want to disable the IT Glue branded footer.

    Interface_branded.png
Was this article helpful?
9 out of 15 found this helpful
Have more questions? Contact us