1. Unifyr Admin Academy
  2. Partner Portal
  3. Site Configuration

Custom Domain

Avatar
Audrey
Follow

Important

Suppliers are responsible for renewing their SSL Certificates when they are set to expire. Designated recipients will receive email notifications and a red banner will display at the top of your Unifyr One Admin account when it’s time to update the SSL Certificate. If the SSL Certificate is not updated by the expiration date, partners may be unable to access the partner portal. See the Update an Expiring SSL Certificate section below for instructions.

Overview

Unifyr One allows you to customize the web address that people will use to access your partner portal. This is called a Custom Domain.

Once set up, any communications that include a link will point to the new address. The original Unifyr One Portal address will continue to work.

Important

If you have SSO in place, please work with your Unifyr One team to make any domain changes. Do not make changes yourself.

Intended Audience: Channel Marketing Directors and Channel Operations Managers 

Prerequisites

Before you can configure the Custom Domain of your partner portal, you must have the following:

  • A chosen subdomain or domain that you control.  Typically this is a subdomain under your corporate domain. For example: partners.corporatedomain.com
  • An SSL Certificate which will cover the chosen URL. The certificate should be available in PEM format, as you will need to cut and paste the certificate body, private key, and certificate chain into the provided form.
  • Someone available to make DNS changes within your organization.

Contents

Click on the + to expand the instructions for the desired task.

Set Up a Custom Domain

The steps below explain how to define a branded URL in Unifyr One.

Before starting this procedure, ensure that you have met the prerequisites outlined in the Prerequisites section of this article. You will need information from your organization's webmaster to continue.

  1. Navigate to Partner Portal > Site Configuration.

  2. Click Settings.

    admin_site_config_settings.png
  3. Go to the Custom Domain tab in the left sidebar.

  4. In Custom Domain, provide this information:

    Parameter  Type  Description
    Custom Domain  Text

    [Optional] Enter the unique, user-friendly URL. Make sure it conforms to the prerequisites outlined in the Prerequisites section of this article.

    When you enter a valid Custom Domain URL, you will need to add information from your SSL/TLS certificate. An SSL Certificate provides critical data security and must be issued from a trusted Certificate Authority (CA).

    Note

    Typically, you will receive two files from the Certificate Provider - the Certificate File and the Certificate Chain. You should already have the Private Key from when you created the Certificate Request with your Provider.

    SSL/TLS Certificate

    The information in these three fields will be stored but not displayed after entry for security reasons. This is part of the validation token that will help keep the site secure.

    Certificate Body Text

    Enter the contents of the Certificate file.

    Copy and paste in all the text from the file, as shown:

    Certificate_Body_example.png
    Private Key Text

    Enter the contents of the Private Key file.

    A Private Key creates a digital signature that is used to secure and verify connections to your partner portal. It should have been provided when you made a Certificate Request to your Provider.

    Copy and paste in all the text from the file, as shown:

    Private_Key_example.png
    Certificate Chain Text

    Enter the content of the Certificate Chain file. 

    A Certificate Chain is a list of SSL certificates ordered by the issuing Certificate Authorities (CA). You may need to download it from your Certificate Provider or it may be issued with the Certificate. Typically, this file will include the Certificate Authority's name. 

    Copy and paste in all the text from the file.
    Expiry Notification Text

    Enter the email addresses that should receive notifications when your SSL certificate is approaching expiry.

    Use a comma separated list of addresses.

    For more information about the notification, see SSL Certificate Expiration Notification.
  5. Click Save. The domain URL is processed - this may take up to 30 minutes.

  6. Once the URL has populated, add its CNAME to the DNS settings for your domain. 

    This information will be available in Custom Domain > DNS Settings when the URL processing has completed.

    DNS_Settings.png

Edit a Custom Domain

Important

When you choose to edit the Custom Domain after you have set it up, your partner portal will no longer be available at the current domain.

The steps below explain how to update the branded URL in Unifyr One.

This procedure assumes that you have an available site on your Portal, set up with the steps in the How to Set Up a Custom Domain section of this article. You will need information from your organization's webmaster to continue.

  1. Navigate to Partner Portal > Site Configuration.

  2. Click Settings.

    admin_site_config_settings.png
  3. Go to Custom Domain in the left sidebar.

  4. Click Change next to the existing Custom Domain.

    change_custom_domain.png

  5. You're prompted to confirm that you wish to change the Custom Domain. If you click Continue, your partner portal will no longer be available at the current domain.

    Confirm_Custom_Domain_Change.png

    If you are prepared to make this change, click Continue.

    If you are not prepared to make this change, click Cancel.

  6. If you clicked Continue, complete the Certificate information for the new domain and reprocess the URL. For more information, see the How to Set Up a Custom Domain section of this article.

Add Recipients of SSL Certificate Expiration Notifications

You can designate who receives email notifications to update your SSL certificate when it's expiring:

  1. Navigate to Partner Portal > Site Configuration.

  2. Click Settings.

    admin_site_config_settings.png
  3. Click Custom Domain in the left sidebar.
  4. If you are setting up the Custom Domain for the first time, follow the steps in the How to Set Up a Custom Domain section of this article.
  5. If you already have a Custom Domain set up, click Update Certificate in the SSL/TLS Certificate area.
  6. In the Expiry Notification field, enter a comma-separated list of email addresses that will receive alerts when your certificate is approaching expiration.

For more information about the notifications, see SSL Certificate Expiration Notification.

Update an Expiring SSL Certificate

Suppliers are responsible for updating their expiring SSL certificates. 

When it’s time to update your expiring SSL Certificate, the Expiry Notification recipients will receive email notification. The Unifyr One Admin homepage also displays a banner advising of the expiration.

To update your SSL Certificate, follow these steps - you will need information from your organization's webmaster to continue:

  1. Navigate to Partner Portal > Site Configuration.

  2. Click Settings.

    admin_site_config_settings.png
  3. Go to Custom Domain in the left sidebar.
  4. In the SSL/TLS Certificate area, click Update Certificate.

  5. Update this information:

    You may need to work with your organization’s webmaster to obtain the information required to update the SSL Certificate.

    For more information about the fields, see the Setting Up a Custom Domain section of this article.

    • Certificate Body
    • Private Key
    • Certificate Chain

    Note

    The information in these three fields will be stored but not displayed after entry for security reasons. This is part of the validation token that will help keep the site secure.

  6. Click Save.

Training

Related Topics

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.