Getting Started

Before installing the Surfly appliance make sure that you have the following information handy:

• the domain name under which the appliance should run
• a certificate with complete certificate chain which is valid for domainname.com and *.domainname.com
• DNS is configured in such way that both domainname.com and *.domainname.com point to the same IP address

Note

DNS configuration can be achieved by creating the following A records:

"" A 1.2.3.4
"*" A 1.2.3.4

Note

For example, if you want to install Surfly on https://cobrowsing.yourwebsite.com, the following domain names and more should be covered by the certificate:

• https://cobrowsing.yourwebsite.com
• https://ws.cobrowsing.yourwebsite.com
• https://session.cobrowsing.yourwebsite.com
• https://google-com-p.cobrowsing.yourwebsite.com
• https://bing-com-p.cobrowsing.yourwebsite.com
• …

Make sure that the certificate is in *.pem format and has the following structure:

-----BEGIN RSA PRIVATE KEY-----
    (Your Private Key)
-----END RSA PRIVATE KEY-----

-----BEGIN CERTIFICATE-----
    (Your Primary SSL certificate)
-----END CERTIFICATE-----

-----BEGIN CERTIFICATE-----
    (Your Intermediate certificate)
-----END CERTIFICATE-----

Caution

Wildcard certificate is only valid for one level of subdomains. For example, the wildcard certificate *.cobrowsing.domainname.com is valid for ws.cobrowsing.domainname.com, but not for session.ws.cobrowsing.domainname.com

Tip

Use sslcheck to verify that the certificate is valid. Usage example: sslcheck verify -c <path to the certificate>

Before the installation can be started, you need to be registered in our deployment system. In order to do that, please send us your domain name. In response you will get a CLIENT_ID and a CLIENT_SECRET.