Skip to end of banner
Go to start of banner

p.Whitelabel settings

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Whitelabel the portal with your own custom domain, logo, colors, SSL certificates and intercom support chat for your customers.

Phonism provides the capability to whitelabel the portal with your own custom domain, logo, colors, SSL certificates and intercom (https://www.intercom.com) support chat for your customers.

Assumptions and limitations:

  • VoIP devices have special requirements for SSL certificates.

  • Wildcard certificates are not allowed for device compatibility.

  • For the Admin Portal most SSL certificate authority works.

    • Example authorities: Symantec, NameCheap, Digicert

  • For the Phone Portal you must choose your SSL certificate authority wisely or you risk connectivity issues with your devices.

    • Endpoints have a set of pre-installed valid authorities by the manufacturer. Your certificate authority may not be supported from the factory by the manufacturer. This is device and firmware specific.

      • Refer to your devices' administration guide for a list of pre-installed authorities.

    • Phonism uses DigiCert “Secure Site OV” signed by issuer “DigiCert SHA2 Secure Server CA.”

      • To date, we have found this product to have the best compatibility among the devices we support.

WHITELABEL YOUR PORTAL THEME

Whitelabel customers have the ability to modify the portal theme with their own colors, logo, and favicon. 

In the example below, we are logged in as Hosted VoIP Provider, a whitelabel enabled service provider account.

image-20240730-232344.png

  1. Navigate to Account and click on the Whitelabel Settings tab.

  2. Click Choose File to upload your logo and favicon.

  3. Add your theme colors.

  4. Click Save.

image-20240730-232413.png

CUSTOMIZE PORTAL DOMAIN

A Canonical Name used to alias one name to another. This allows you to have your own URL, while it is pointing to app.xxxxx.phonism.com with xxxxx being your account name.

  1. Log in as an account-level user and navigate to the Account tab > Whitelabel Settings and scroll down to the Domains section.

  2. For each domain you want to whitelabel, do the following:

    • Update the DNS record for your custom CNAME to the unique URL provided.

    • Obtain an SSL certificate and paste the certificate body, private key, and bundle in the corresponding fields.

Instructions

  1. On a UNIX based system, go to the command line and run the commands below. Follow the prompt instructions to provide your organizational details.

openssl req -new -newkey rsa:2048 -nodes -keyout app-phonism.key -out app-phonism.csr

  1. Follow the prompt instructions to provide your organizational details.

  2. When prompted for the Common Name (domain name), type the fully qualified domain (FQDN) that uses your custom branded domain. In this example, we would use something like portal.awesomevoip.com.

  3. Note: Do not use any domain name with .phonism.com in it.

  4. After you finish this process, you will submit the *.csr file to the relevant Certificate Authority.

  5. They will send you back a certificate file and a certificate authority file (e.g CABundle).

  6. Once you receive those, you will upload the private key, certificate, and the CABundle file securely to the Phonism Whitelabel portal.

  •      Click Save.

  1. Open a support ticket to notify our team to complete the setup.

NEXT STEPS

  • After the support team has completed their setup you can begin pointing devices to your new URL.

  • Configuration generated by Phonism will use your custom CNAME.

  • Existing devices will be transitioned to the new CNAME next time a configuration change is made.

  • Phonism existing domains can still be used.

  • No labels