Skip to main content

Welcome to the Cyara Knowledge Center

Search

Configuring for Database Encryption

Updated: tech writers Edited:

To enable database encryption, you need to make configuration changes to the Cyara Web Portal, Voice Scheduler, and Omni Scheduler configuration files.

Obtaining the Certificate Name and Thumbprint Values

Before you configure the Cyara Web Portal, Voice Scheduler, and Omni Scheduler configuration files, you need to obtain the values for the Certificate Name and Thumbprint fields.

  1. Open a Command Prompt and run the command: mmc.exe. A screen as shown below appears:

  2. Click File > Add/Remove Snap-in. A screen as shown below appears:

  3. Select Certificates and click the Add > button.
  4. Select the Computer account option in the following screen and click Next.

  5. Select the Local computer... option in the next dialog box:

  6. Click Finish and then click OK.
  7. Click Certificates (Local Computer) > Personal, then the Certificates folder, and then double-click on the certificate that was added. A screen as shown below appears:

  8. Click the Details tab and scroll down to the Subject field and note down the CN value:

  9. Scroll down and make a note of the Thumbprint value:

  10. Click OK.

Configuring the Cyara Web Portal

The Cyara Web Portal configuration is controlled by the contents of the web.config file, which is located in the physical folder of the Cyara Web Portal virtual folder (c:\Inetpub\wwwroot\CyaraWebPortal).

  1. In the web.config file, update the keys in the <EncryptionSettings.UniqueCertificateName> section with the values for those keys with the customer-specific details. 
    <!-- Database encryption settings. These settings are ignored unless database encryption is licensed. -->
<!-- EncryptionSettings.UniqueCertificateName - Distinguished name for the X.509 Certificate used with Database Encryption (e.g. "CN = CyaraPlatformEncryptionExample"). No default. -->
<add key="EncryptionSettings.UniqueCertificateName" value="CN = CyaraPlatformEncryptionExample" />

<!-- EncryptionSettings.CertificateThumbprint - Certificate thumbprint to use for encrypting (used with X509). (e.g. "6f 54 7c 48 87 bb 8f 8c 71 3f fb 50 f9 9b 5c 4c 8f dd 85 3f"). No default. -->
<add key="EncryptionSettings.CertificateThumbprint" value="‎6f 54 7c 48 87 bb 8f 8c 71 3f fb 50 f9 9b 5c 4c 8f dd 85 3f" />

<!-- EncryptionSettings.MachineCertificate - Whether to use the Local Computer key container (as opposed to the Current User key container). True will select the Local Computer key container. Defaults to True. -->
<add key="EncryptionSettings.MachineCertificate" value="True" />

<!-- EncryptionSettings.Cipher - The Cipher to use. Valid values are: None, X509, UTF8, AESplusX509. Defaults to None. -->
<add key="EncryptionSettings.Cipher" value="AESplusX509" />
  2. Save the web.config file with changes.

Configuring the Voice Scheduler

The Voice Scheduler configuration is controlled by the contents of the Cyara.Voice.Scheduler.exe.config file, which is located in the Voice Scheduler's install folder.

  1. In the Cyara.Voice.Scheduler.exe.config file, update the keys in the <EncryptionSettings.UniqueCertificateName> section with the values for those keys with the customer-specific details. 
    <!-- Database encryption settings. These settings are ignored unless database encryption is licensed. -->
<!-- EncryptionSettings.UniqueCertificateName - Distinguished name for the X.509 Certificate used with Database Encryption (e.g. "CN = CyaraPlatformEncryptionExample"). No default. -->
<add key="EncryptionSettings.UniqueCertificateName" value="CN = CyaraPlatformEncryptionExample" />

<!-- EncryptionSettings.CertificateThumbprint - Certificate thumbprint to use for encrypting (used with X509). (e.g. "6f 54 7c 48 87 bb 8f 8c 71 3f fb 50 f9 9b 5c 4c 8f dd 85 3f"). No default. -->
<add key="EncryptionSettings.CertificateThumbprint" value="‎6f 54 7c 48 87 bb 8f 8c 71 3f fb 50 f9 9b 5c 4c 8f dd 85 3f" />

<!-- EncryptionSettings.MachineCertificate - Whether to use the Local Computer key container (as opposed to the Current User key container). True will select the Local Computer key container. Defaults to True. -->
<add key="EncryptionSettings.MachineCertificate" value="True" />

<!-- EncryptionSettings.Cipher - The Cipher to use. Valid values are: None, X509, UTF8, AESplusX509. Defaults to None. -->
<add key="EncryptionSettings.Cipher" value="AESplusX509" />
  2. Save the Cyara.Voice.Scheduler.exe.config file.
  3. The Scheduler should appear in the list of Windows services as Cyara Voice Scheduler. Start the Cyara Voice Scheduler. Check the logs generated in the Voice Scheduler's "logs" folder and ensure that there are no errors.

Configuring the Omni Scheduler

The Omni Scheduler configuration is controlled by the contents of the Cyara.Scheduler.Host.exe.config file, which is located in the Omni Scheduler's install folder.

  1. In the Cyara.Scheduler.Host.exe.config file, update the keys in the <EncryptionSettings.UniqueCertificateName> section with the values for those keys with the customer-specific details. 
    <!-- Database encryption settings. These settings are ignored unless database encryption is licensed. -->
<!-- EncryptionSettings.UniqueCertificateName - Distinguished name for the X.509 Certificate used with Database Encryption (e.g. "CN = CyaraPlatformEncryptionExample"). No default. -->
<add key="EncryptionSettings.UniqueCertificateName" value="CN = CyaraPlatformEncryptionExample" />

<!-- EncryptionSettings.CertificateThumbprint - Certificate thumbprint to use for encrypting (used with X509). (e.g. "6f 54 7c 48 87 bb 8f 8c 71 3f fb 50 f9 9b 5c 4c 8f dd 85 3f"). No default. -->
<add key="EncryptionSettings.CertificateThumbprint" value="‎6f 54 7c 48 87 bb 8f 8c 71 3f fb 50 f9 9b 5c 4c 8f dd 85 3f" />

<!-- EncryptionSettings.MachineCertificate - Whether to use the Local Computer key container (as opposed to the Current User key container). True will select the Local Computer key container. Defaults to True. -->
<add key="EncryptionSettings.MachineCertificate" value="True" />

<!-- EncryptionSettings.Cipher - The Cipher to use. Valid values are: None, X509, UTF8, AESplusX509. Defaults to None. -->
<add key="EncryptionSettings.Cipher" value="AESplusX509" />
  2. Save the Cyara.Scheduler.Host.exe.config file.
  3. The Omni Scheduler should appear in the list of Windows services as Cyara Omni Scheduler. Start the Cyara Omni Scheduler. Check the logs generated in the Omni Scheduler's "logs" folder and ensure that there are no errors.
Was this article helpful?
0 out of 0 found this helpful
Return to top

Related articles

Comments

0 comments

Please sign in to leave a comment.