SIEM, Log Management, Security, Compliance, Server Monitoring and Uptime Monitoring Software
Table of Contents

Server Configuration

By default, the server runs unencrypted on port 21843. You can configure to server to run on TLS 1.2 and on the port of your choosing.

The configuration is implemented through the tcpserver.json file located in the programdata directory.

On Windows, the default location is:
C:\ProgramData\Corner Bowl\Server Manager\tcpserver.json

On Linux, the default location is:
/usr/share/corner-bowl/server-manager/tcpserver.json

In this Topic

How to Configure Encrypted Communications on Windows Installations

  • From the Windows Server that the Corner Bowl Server Manager Service is installed, use the Windows Certificate Manager to install a SSL certificate.
  • Once you have a valid SSL certificate installed, open a command prompt as Administrator.
  • Type:
    Notepad.exe
  • From Notepad, select File | Open.
  • Select:
    C:\ProgramData\Corner Bowl\Server Manager\tcpserver.json
  • Find TlsConfiguration | Enabled then set the value to true.
  • Find TlsConfiguration | Certificate then set the value to one of the following values found in the Windows Certificate Manager:
AttributeSample ValueSearch Order
Thumbprint1E2CCCC2461DFD3FD925CDA17E5DCAD17B95D94B1
Serial Number5C588F17F5225B9C4CE09E9D42E0DB943
Subject Distinguished NameCN=LocalhostName,OU=IT,O=\"Corner Bowl Software\",L=Kamas,S=Utah,C=US2
Subject NameLocalhostName4
Note
For information on how to create a self-signed certificate see:
  • Save your changes.
  • From the Windows Service Control Manager, restart the Corner Bowl Server Manager service.
Important
If you have configured the Management Console to save your password, the first time you login after either enabling or disabling TLS 1.2 you must wait for the connection to timeout.

How to Configure Encrypted Communications on Linux Installations

  • Install a SSL Certificate into the .Net Certificate Store. For more information see: Linux Server Installation
  • Once installed, add the certificate to your .Net Certificate Store using the Server Manager Command-Line Interface, for example:
cd /usr/bin/corner-bowl/server-manager 
/usr/bin/dotnet cbsmcli.dll -ic -f /etc/pki/CA/private/servercert.pfx
  • Using a text editor, open the /usr/share/corner-bowl/server-manager/tcpserver.json file.
  • Find TlsConfiguration | Enabled then set the value to true.
  • Find TlsConfiguration | Certificate then set the value to one of the following values found in the Windows Certificate Manager:
AttributeSample ValueSearch Order
Distinguished NameLocalhostName1
Note
For information on how to create a self-signed certificate see:
  • Save your changes.
  • From a command-prompt, restart the Daemon, for example:
sudo systemctl stop cbsmsrv 
sudo systemctl start cbsmsrv

How to Connect from the Management Console

  • Launch the Corner Bowl Management Console.
  • Configure the options accordingly, then click Login.
Important
If you have configured the Management Console to save your password, the first time you login after either enabling or disabling TLS 1.2 you must wait for the connection to first timeout before you have the opportunity to apply your updates.

Configuration File Reference (tcpserver.json)

AttributeDescriptionRange of ValuesDefault Value
HostThe hostname the Corner Bowl Server Manager Service is running.Any network routable hostname or IP address. Values must be wrapped with quotes."0.0.0.0"
PortThe port the Corner Bowl Server Manager Service is running.1 - 6534421843
IdleTimeoutA Int32 that specifies the maximum number of seconds allowed to pass between command packets. Once exceeded, the remote connection is closed.1 - 65344300
ReceiveTimeoutAn Int32 that specifies the amount of time, in seconds, that will elapse before a read operation fails.1 - 65344120
SendTimeoutAn Int32 that specifies the amount of time, in seconds, that will elapse before a read operation fails.1 - 65344120
TlsConfigurationEncapsulates the SSL/TLS 1.2 configuration properties.
EnabledA Boolean that specifies whether SSL/TLS 1.2 is enabled.true or falsefalse
CertificateA string that specifies the name of the X509Certificate used to authenticate.

On Windows, the Thumbprint is suggested, however, you can also specify the Serial Number, Subject Distinguished Name or Subject Name.

On Linux, the value must be the network routable hostname.

If specified, the value must be wrapped in quotes otherwise specify null without quotes.

null
AllowSelfSignedCertificateA Boolean value that specifies whether self-signed certificates are supported.true or falsetrue
CheckCertificateRevocationA Boolean value that specifies whether the certificate revocation list is checked during authentication.true or falsefalse
AllowCertificateChainErrorsA Boolean value that specifies whether the certificate chain is checked during authentication.true or falsetrue

Sample File Contents (tcpserver.json)

{
    "Host": "0.0.0.0", 
    "Port": 21843, 
    "IdleTimeout": 300, 
    "ReceiveTimeout": 120, 
    "SendTimeout": 120, 
    "TlsConfiguration":
    {
        "Enabled": false, 
        "Certificate": null, 
        "RequireRemoteCertificate": false, 
        "AllowSelfSignedCertificate": false, 
        "CheckCertificateRevocation": false, 
        "AllowCertificateChainErrors": false 
    }, 
}

Troubleshooting

If you are unable to connect to the service using TLS 1.2, you can view the services verbose output log for detailed information. The log file is located in the following path:

On Windows the location is:
C:\ProgramData\Corner Bowl\Server Manager\server.log

On Linux the location is:
/var/log/corner-bowl/server.log

Related Topics

Installation

Linux Server Installation

New-SelfSignedCertificate