[{"id":"4bcfd3b8-df96-95b6-72d4-de7753988243","label":"Summary","body":{"version":1,"type":"doc","content":[{"type":"paragraph","content":[{"type":"text","text":"Phonism provides the capability to white label the portal with your own custom domain, logo, colors, SSL certificates and Intercom ("},{"type":"text","text":"https://www.intercom.com","marks":[{"type":"link","attrs":{"href":"https://www.intercom.com/"}},{"type":"underline"}]},{"type":"text","text":") support chat for your customers."}]},{"type":"paragraph","content":[]}]}},{"id":"702e279e-b03a-cbbf-8e4d-b751d3788cb8","label":"Configuration","body":{"version":1,"type":"doc","content":[{"type":"heading","attrs":{"level":2},"content":[{"type":"text","text":"Whilelabelling Portal Theme"}]},{"type":"paragraph","content":[{"type":"text","text":"White Label customers have the ability to modify the portal theme with their own colors, logo, and favicon."},{"type":"hardBreak"},{"type":"text","text":"In the example below, we are logged in as "},{"type":"text","text":"Hosted Voip Provider","marks":[{"type":"strong"}]},{"type":"text","text":", a white label enabled service provider account."}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"type":"external","width":820,"height":617,"url":"https://phonism.atlassian.net/wiki/download/attachments/1470595132/8cacc43e-0533-4986-93fc-26ac82351fac.png?version=1&modificationDate=1656947197208&cacheVersion=1&api=v2"}}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Navigate to "},{"type":"text","text":"\"Account\"","marks":[{"type":"strong"}]},{"type":"text","text":" and click on the "},{"type":"text","text":"\"Whitelabel Settings\" ","marks":[{"type":"strong"}]},{"type":"text","text":"tab."}]}]}]},{"type":"mediaSingle","attrs":{"width":50,"layout":"center"},"content":[{"type":"media","attrs":{"type":"external","width":1171,"height":1232,"url":"https://phonism.atlassian.net/wiki/download/attachments/1470595132/1263c7da-715d-4781-acbb-2cde2756cc4e.png?version=1&modificationDate=1656947226185&cacheVersion=1&api=v2"}}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Upload your Logo and Favicon by clicking "},{"type":"text","text":"\"Choose File\".","marks":[{"type":"strong"}]}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"type":"external","width":608,"height":90,"url":"https://phonism.atlassian.net/wiki/download/attachments/1470595132/d92e38ca-1e4c-4876-818b-a5b76afd9402.png?version=1&modificationDate=1656947269941&cacheVersion=1&api=v2"}}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Add your desired theme colors. You can see an example of where the colors are used in the images above."}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"type":"external","width":789,"height":148,"url":"https://phonism.atlassian.net/wiki/download/attachments/1470595132/741558ac-165c-41fb-b9d4-6ea096f90dd6.png?version=1&modificationDate=1656947299434&cacheVersion=1&api=v2"}}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Click "},{"type":"text","text":"\"Save\" ","marks":[{"type":"strong"}]},{"type":"text","text":"at the bottom of the page."}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"type":"text","text":"Customizing Portal Domain"}]},{"type":"paragraph","content":[{"type":"text","text":"A Canonical Name used to alias one name to another. This allows you to have your own URL, while it is pointing to "},{"type":"text","text":"app.xxxxx.phonism.com","marks":[{"type":"link","attrs":{"href":"http://app.xxxxx.phonism.com/"}}]},{"type":"text","text":" with xxxxx being your account name."}]},{"type":"orderedList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Login as an Account-level User and navigate to the Account tab > Whitelabel Settings and scroll down to the Domains section."}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"type":"external","width":667,"height":125,"url":"https://phonism.atlassian.net/wiki/download/attachments/1470595132/70041d76-a7a4-456d-83bd-470ab5398dae.png?version=1&modificationDate=1656947364995&cacheVersion=1&api=v2"}}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"type":"external","width":552,"height":439,"url":"https://phonism.atlassian.net/wiki/download/attachments/1470595132/f74816d0-9111-4fef-b8fd-a5f5112fa27f.png?version=2&modificationDate=1656947394749&cacheVersion=1&api=v2"}}]},{"type":"paragraph","content":[]},{"type":"paragraph","content":[{"type":"text","text":"2. For each domain you want to whitelabel, do the following:"}]},{"type":"paragraph","content":[{"type":"text","text":" a. Update the DNS record for your custom CNAME to the unique URL provided."}]},{"type":"paragraph","content":[{"type":"text","text":" i.e.g. "},{"type":"text","text":"app.hvp.com","marks":[{"type":"code"}]},{"type":"text","text":" should resolve to "},{"type":"text","text":"app.hosted-voip-provider.phonism.com","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"type":"text","text":" b. Obtain an SSL certificate and paste the certificate body, private key, and bundle in the corresponding fields."}]},{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"aura-panel","parameters":{"macroParams":{"params":{"value":"JTdCJTIyc3R5bGVzJTIyJTNBJTIyJTdCJTVDJTIyYm9keSU1QyUyMiUzQSU3QiU3RCUyQyU1QyUyMmhlYWRlciU1QyUyMiUzQSU3QiU3RCUyQyU1QyUyMmhlYWRsaW5lJTVDJTIyJTNBJTdCJTdEJTJDJTVDJTIyYmFzZSU1QyUyMiUzQSU3QiU1QyUyMmJveFNoYWRvdyU1QyUyMiUzQSU3QiU1QyUyMnNoYWRvd3MlNUMlMjIlM0ElNUIlN0IlNUMlMjJjb2xvciU1QyUyMiUzQSU1QyUyMnJnYmEoMCUyQyUyMDAlMkMlMjAwJTJDJTIwMC4wOCklNUMlMjIlMkMlNUMlMjJ4JTVDJTIyJTNBMCUyQyU1QyUyMnklNUMlMjIlM0ExJTJDJTVDJTIyYmx1ciU1QyUyMiUzQTElMkMlNUMlMjJzcHJlYWQlNUMlMjIlM0EwJTdEJTJDJTdCJTVDJTIyY29sb3IlNUMlMjIlM0ElNUMlMjJyZ2JhKDAlMkMlMjAwJTJDJTIwMCUyQyUyMDAuMTYpJTVDJTIyJTJDJTVDJTIyeCU1QyUyMiUzQTAlMkMlNUMlMjJ5JTVDJTIyJTNBMSUyQyU1QyUyMmJsdXIlNUMlMjIlM0EzJTJDJTVDJTIyc3ByZWFkJTVDJTIyJTNBMSU3RCU1RCU3RCUyQyU1QyUyMmJvcmRlclJhZGl1cyU1QyUyMiUzQSU3QiU1QyUyMnJhZGl1cyU1QyUyMiUzQTQlN0QlMkMlNUMlMjJiYWNrZ3JvdW5kQ29sb3IlNUMlMjIlM0ElN0IlNUMlMjJjb2xvciU1QyUyMiUzQSU1QyUyMiUyM2ZmZmZmZiU1QyUyMiU3RCU3RCU3RCUyMiUyQyUyMnRhYiUyMiUzQTAlN0Q="},"_parentId":{"value":"392759514"}},"macroMetadata":{"macroId":{"value":"87449672-2904-4881-b85a-1f07a23ffeb7"},"schemaVersion":{"value":"1"},"placeholder":[{"data":{"url":"https://aura.cloudanvil.net/images/aura-macro-icon.png"},"type":"icon"}],"title":"Aura - Panel"}},"layout":"default","localId":"2e917756-42a2-4213-a3b9-cfa9b93b4701"},"content":[{"type":"paragraph","content":[{"type":"text","text":"Instructions","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"On a UNIX based system, go to the command line and run the commands below.Follow the prompt instructions to provide your organizational details."}]},{"type":"codeBlock","attrs":{},"content":[{"type":"text","text":"openssl req -new -newkey rsa:2048 -nodes -keyout app-phonism.key -out app-phonism.csr"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Follow the prompt instructions to provide your organizational details."}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"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 "},{"type":"text","text":"portal.awesomevoip.com","marks":[{"type":"link","attrs":{"href":"http://portal.awesomevoip.com/"}}]}]}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"type":"text","text":"Do not use any domain name with .phonism.com in it"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"After you finish this process, you will submit the *.csr file to the relevant Certificate Authority."}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"They will send you back a certificate file and a certificate authority file (e.g CABundle)."}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Once you receive those, you will upload the private key, certificate, and the CABundle file securely to the Phonism Whitelabel portal."}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"type":"text","text":"You must save your private key data in a secure location. Once uploaded to Phonism it is not possible for us to provide the private key back to you."}]}]}]},{"type":"paragraph","content":[{"type":"text","text":" c. Hit Save"}]},{"type":"paragraph","content":[{"type":"text","text":"3. Open a Support Ticket to notify our team to complete the setup."}]},{"type":"heading","attrs":{"level":2},"content":[{"type":"text","text":"Next Steps"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"After the Support team has completed their setup you can begin pointing devices to your new URL."}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Configuration generated by Phonism will use your custom CNAME."}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Existing devices will be transitioned to the new CNAME next time a configuration change is made."}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Our existing domains can still be used."}]}]}]}]}},{"id":"ee276dd4-0963-c61d-7a31-f808e2f84acf","label":"Assumptions & Limitations","body":{"version":1,"type":"doc","content":[{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"type":"text","text":"VoIP devices have special requirements for SSL certificates!"}]}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"type":"text","text":"Wildcard certificates are not allowed for device compatibility!"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"For the "},{"type":"text","text":"Admin Portal","marks":[{"type":"strong"}]},{"type":"text","text":" nearly any SSL certificate authority will work just fine."}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Example authorities: Symantec, NameCheap, Digicert"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"For the "},{"type":"text","text":"Phone Portal","marks":[{"type":"strong"}]},{"type":"text","text":" you must choose your SSL certificate authority wisely else you risk connectivity issues with your devices."}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"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."}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Refer to your devices' administration guide for a list of pre-installed authorities."}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"Phonism uses DigiCert “Secure Site OV” signed by issuer “DigiCert SHA2 Secure Server CA”."}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"To date, we have found this product to have the best compatibility among the devices we support"}]}]}]}]}]}]}]},{"type":"paragraph","content":[]}]}}] |