In this section:
Overview
Security analytics is dependent on centralized Syslog aggregation, with the expectation that the Syslog communication is secured. The primary Syslog security threats to address are:
- Masquerade
- Modification
- Disclosure
To eliminate these threats, RFC 5425 defines a TLS Transport Mapping for Syslog. This feature supports the RFC 5425-compliant transport option in addition to the existing UDP, TCP, and RELP Syslog remote protocols.
The SBC is enhanced to:
- broadcast Syslog traffic to multiple Syslog servers
- support three Syslog servers per event log type
- offer support for the Linux logs
The SBC supports the Rsyslog method of sending event messages to the Syslog server with the following capabilities:
- Using Transport Layer Security (TLS) as a secure transport medium supported over TCP. The SBC adds the TLS to the existing event logs and the Linux logs.
- Spooling to reduce message loss: When the connection to the Syslog server is down, the SBC spools the log entries locally to reduce message loss for all log types. The supported protocols include TCP, RELP, and TLS over TCP.
- Broadcasting to the three Syslog servers
- Sending additional Linux logs to Syslog servers: This allows for the new configuration to configure the specific
/var/log/
files to transfer over Syslog. It captures the Linux session console logs and transfers it through the Syslog.
The new Linux log option sends the Linux session console logs to the user's console real-time to any Syslog server configured. The SBC writes the new console logs real-time to the newly created files in a new directory on the SBC: /var/log/session/session.*
files and pushes it to the Syslog Server.
The Linux logs include the following:platformAuditLog
- Platform Linux Audit log messagesconsoleLog
- Console activity messagessftpLog
- internal-sftp messageskernLog
- kernel messagesuserLog
- user-level messagesdaemonLog
- system daemon messagesauthLog
-
auth and authpriv
- security/authorization messagessyslogLog
- internally generated by syslog messagesntpLog
- NTP subsystem messagescronLog
- clock daemon messagesfipsLog
- fips messages
- Validating IPv4/IPv6 to the Rsyslog remote host fields to prevent adding the invalid format IP address in the Remote Host Server fields.
Supporting TLS for Rsyslog
The TLS is a new transport medium that uses Rsyslog service and ensures secure communication between the SBC (acting as a client to the Syslog server) and the Syslog server.
The SBC sends the system, debug, trace, accounting, security, audit, and the Linux logs, (including the existing Platform Audit logs) to the remote Syslog server securely using TLS over TCP.
Rsyslog process logs very quickly and has enriched security features. It accepts inputs and delivers the results to the desired destinations.
To support this service, the SBC provisions a new TLS protocol type and the required certificate details, which is summarized as follows:
- Provisioning of Syslog server CA Certificate details and Client Certificates. The user can create and store the certificates using the PKI interface
- Provisioning of Rsyslog TLS profile
- Provisioning of the remote host TLS protocol type
The SBC acts as a TLS Client and establishes a TLS connection towards the Syslog server. The SBC and Syslog server authenticate each other using certificates.
Certificate Provisioning
The SBC requires certificates for TLS communication using Rsyslog. The SBC adds these generated certificates to the rsyslog.conf
file to allow communication through TLS over TCP or RELP.
The SBC can either create Certificates internally or import the externally created certificates.
The configuration of Rsyslog service to use TLS on each server requires three certificates: the CA certificate, the server certificate and the server key set in rsyslog.conf
The SBC creates the certificates by generating the RSA key pairs and Certificate Signing Request (CSR) locally on the SBC, export the CSR and import the signed certificate generated by the CA.
Alternatively, the SBC generates the RSA key pair and CSR externally, then import the private key and the signed certificate to the SBC.
SBC-provisioned Certificates
The SBC generates certificates using the PKI interface, and after copying it, creates new commands to generate specific certificates to support TLS using Rsyslog.
To generate the PKI certificate, refer to Generating PKI Certificates
This interface simplifies the certificates and keys managing process and provides more security since the private key never leaves the SBC system.
Generating Certificates for TLS
To enable Rsyslog communication over TLS:
- Create the client certificate and server CA certificates in a certification store using PKI interface provided in the system/security.
- After creating the certificates, create Rsyslog TLS profile.
- After creating Rsyslog TLS profile, configure
syslogRemoteProtocol
astls-tcp.
To generate the certificate using Rsyslog for TLS:
- The SBC application generates and install RSA key pairs and generate a Certificate Signing Request (CSR) on the SBC.
Create a configuration object to store the locally generated RSA Key Pair:
set system security pki certificate <certName> type local-internal
Generate Key pair and CSR for submission to a Certificate Authority (CA):
request system security pki certificate <certName> generateCSR csrSub <csrSub> keySize <keySize>
- Contact the Certificate Authority (CA) to request certificate using the generated CSR. This is external to the SBC.
- Copy the generated CSR into a file named
csrToBeSigned.csr
- Generate the local Certificate as
localCert.pem
and the remote Certificate asrootCA.der
. Usingopenssl
commands on the CA run the following:
Generate the
rootCA.key
openssl genrsa -out rootCA.key 2048
Generate RSA private key for
rootCA.key
openssl genrsa -des3 -out rootCA.key 2048
Generate
rootCA.pem
file:openssl req -x509 -new -nodes -key rootCA.key -sha256 -days 1024 -out rootCA.pem
Generate the
localCert.pem
file:openssl x509 -req -in csrToBeSigned.csr -CA rootCA.pem -CAkey rootCA.key -CAcreateserial -out localCert.pem -days <no_days> -sha256
Generate the
rootCA.der
file from the localCert.pem
fileopenssl x509 -outform der -in localCert.pem -out rootCA.der
- Copy the generated CSR into a file named
Once Certificate Authority issues the certificates, place the certificate in the SBC directory: /opt/sonus/external
and install the certificates on the SBC using the following commands:
set system security pki certificate <loal_cert_name> fileName <local_pem_filename> state enabled set system security pki certificate <remote_cert_name> fileName <remote_der_filename> type remote state enabled
The following three Certificates are added to the rsyslog.conf
file to support TLS communication, these are generated from the existing local and remote Certificates already copied to the SBC:
<machine-cert>.pem
<machine-key>.key
<ca-cert>.pem
Externally-provisioned Certificates
Externally-provisioned certificates follows the same steps as mentioned in the SBC-provisioned Certificates. The only difference being that Step one is configured on an external Server to the SBC
Support to Broadcast to Three Syslog Servers
The ACL rules support the number of acknowledged messages received to the SBC. The ACK message count is predominantly dependent on the SBC platform as a result of the CPS that SBCs can support. The ACL rule has a credit Rate set to 1200 packets per second, which limits the number of messages that the SBC can receive.
The following example describes the worst case Credit Rate required, on an SBC7000 which supports 1350 cps
1350 cps * 2 call detail records (start/stop) * 3 Servers = 8100 pkt/sec + additional logs.
This results in an approximate credit rate of up to 10,000 pkts/sec in the worst case scenario.
The credit rate is calculated as: Calculated SBCs CPS * 2 (start/stop record) * 3 (remote servers) + approx. 25% for all other logs types.
Support for Spooling
The SBC supports spooling for all log types, including event logs and the Linux Logs only. It provides a buffer for all log types on a local SBC client.
The SBC spooling support is summarized as follows:
- When the SBC loses the connection to the remote Server, it uses the allocated buffer.
- Each log type is allocated a 50 MB buffer per server configured.
- The
rsyslog.conf
file is updated appropriately to support spooling for all log types. - A new secure spooling directory is created, with root only access, to buffer the log messages.
- The spool files are plain text and not encrypted, but only readable by root.
- The spool files use the SBC's common partition and write to the path
/home/log/spool
. Spooling does not use the DRBD partition, and there is no need to replicate the data using DRBD as Syslog service is always running to send out logs even when the SBC is standby.
- When the connection is re-established, the SBC clears the buffer, and the message logging continues as usual.
Spooling reduces message loss but does not guarantee the server receives all the messages. However, when re-establishing the connection to the server, the SBC sends some duplicate messages to the server when the spooling is configured.
For Spooling, the SBC allocates all the log types a fixed spooled buffer size of 50 MB per configured server.
The SBC supports 17 log types (with a fixed buffer size) with spooling and hence uses up to 850 MB per server configured. When the SBC configures all the three Servers, the total spooled allocation is up to 2.55 GB. If the buffer is filled during the time that the connection is down, the logs are lost.
For spooling, the SBC detects the connection status using Connection Orientated protocol types TCP and RELP.
The SBC supports spooling for the following protocol types:
- TCP
- RELP
- TLS over TCP
Spooling is not supported for UDP because the Rsyslog service cannot detect, if the connection is down.
To keep the amount of message loss to a minimum, use the Spooling feature to configure the latest version of Rsyslog on the SBC. The SBC supports the following new and updated packages/libraries which indicate the minimum package/library versions required.
New/Updated packages are:
rsyslog_8.40.0-1~bpo9+1_amd64.deb
rsyslog-gnutls_8.40.0-1~bpo9+1_amd64.deb
rsyslog-relp_8.40.0-1~bpo9+1_amd64.deb
Data sent to Management Port
The Rsyslog service sends its messages to the Syslog servers on the management interface. With the introduction of three servers for the Rsyslog service, the amount of data the SBC sends on the Management Port increases. However, the Management Ports for each SBC platform have physical limitations.
The worst case scenario message size that can be sent on an SBC 52x0:
450 cps * 2 call detail records (start/stop) * approx. 2k per record * 3 Servers = 5.4 MB/sec + additional logs
This does not include the additional ACKs received for TCP and RELP.
The following table indicates for each SBC platform the potential data usage on the Management port for the Rsyslog service configured with the maximum three servers:
Figure 1: Data sent to Management Port
Platform | Calls Per Second (CPS) | Data Rate MBs/Sec | Management Port Size | No of Management Ports |
---|---|---|---|---|
SBC SWe | 150 | +1.8 MB/sec | Configurable | 1 |
SBC 51x0 | 150 | +1.8 MB/sec | 100 MB | 2 |
SBC 52x0 | 450 | +5.4 MB /sec | 100 MB | 2 |
SBC 5400 | 750 | +8.4 MB/sec | 100MB | 4 |
SBC 7000 | 1350 | +16.2 MB/sec | 1 GB | 2 |