Managing the TLS certificate - NICE DCV
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Managing the TLS certificate

NICE DCV automatically generates a self-signed certificate that's used to secure traffic between the NICE DCV client and NICE DCV server. By default, if no other certificate is installed, this certificate is used. The default certificate includes two files. They are the certificate itself (dcv.pem) and a key (dcv.key). For more information, please see Redirection clarifications with self-signed certificates.

When DCV client users connect to a server, they might receive server certificate warnings that they can act on to verify, before the connection is established.

If they are using a web browser to connect, the browser might warn client users about trusting the server's certificate and that they should contact the administrator to confirm the certificate authenticity.

Similarly, if they are using a Windows, Linux or macOS client, they might be advised to confirm a given certificate's fingerprint with the NICE DCV server administrator.

To verify the authenticity of their certificate fingerprints, run dcv list-endpoints -j and check the output against their certificate fingerprints.

You can replace the default NICE DCV certificate and its key with your own certificate and key.

When you generate your own certificate, select the certificate attributes that meet your specific needs. The CN (Common Name) attribute in most cases must match the public hostname of the host. You also might want to specify the SAN (Subject Alternative Name) attribute and set it to the IP address of the host.

For instructions on how to generate a certificate, see the documentation of your specific Certification Authority.

Important

If you use your own certificate and key, you must name your certificate dcv.pem and you must name the key dcv.key.

Windows NICE DCV server
To change the server's TLS certificate on Windows
  • Place the certificate and its key in the following location on your Windows NICE DCV server:

    C:\Windows\System32\config\systemprofile\AppData\Local\NICE\dcv\
Linux NICE DCV server
To change the server's TLS certificate on Linux
  1. Place the certificate and its key in the following location on your Linux NICE DCV server:

    /etc/dcv/
  2. Grant ownership of both files to the dcv user, and change their permissions to 600 (only the owner can read or write to them).

    $ sudo chown dcv dcv.pem dcv.key
    $ sudo chmod 600 dcv.pem dcv.key
Note

Beginning with NICE DCV 2022.0, if you update a certificate file while the NICE DCV server is running, the new certificate will be automatically reloaded. For previous versions of NICE DCV you will need to manually stop and restart the NICE DCV server.