Getting Started with Cloud Workload Security

Overview

There are two types of monitoring that the Datadog Agent uses for Cloud Workload Security:

File Integrity Monitoring to watch for changes to key files and directories on hosts or containers in real-time.
Process Execution Monitoring to watch process executions for malicious activity on hosts or containers in real-time.

Requirements

Datadog Agent >= 7.27.0
Data collection is done using eBPF, so Datadog minimally requires platforms that have underlying Linux kernel versions of 4.15.0+ or have eBPF features backported. CWS supports the following Linux distributions:
- Ubuntu 18.04+
- Debian 10+
- Amazon Linux 2
- Fedora 26+
- SUSE 15+
- CentOS/RHEL 7.6+
- Custom kernel builds are not supported.

Installation

If you have not already, install the Datadog Agent (version 7.27+).

Add the following to the datadog section of the values.yaml file:

# values.yaml file
datadog:

# Add this to enable Cloud Workload Security
  securityAgent:
    runtime:
      enabled: true

# Add this to enable the collection of CWS network events, only for Datadog Agent version 7.36
      network:
        enabled: true

Restart the Agent.
Optional, if Cloud SIEM is checked Follow these instructions to collect audit logs for Kubernetes.

The following command can be used to start the Runtime Security Agent and system-probe in a Docker environment:

docker-runtime-security.sh

docker run -d --name dd-agent \
  --cgroupns host \
  --security-opt apparmor:unconfined \
  --cap-add SYS_ADMIN \
  --cap-add SYS_RESOURCE \
  --cap-add SYS_PTRACE \
  --cap-add NET_ADMIN \
  --cap-add NET_BROADCAST \
  --cap-add NET_RAW \
  --cap-add IPC_LOCK \
  --cap-add CHOWN \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v /proc/:/host/proc/:ro \
  -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \
  -v /etc/passwd:/etc/passwd:ro \
  -v /etc/group:/etc/group:ro \
  -v /:/host/root:ro \
  -v /sys/kernel/debug:/sys/kernel/debug \
  -v /etc/os-release:/etc/os-release \
  -e DD_RUNTIME_SECURITY_CONFIG_ENABLED=true \
  -e DD_RUNTIME_SECURITY_CONFIG_NETWORK_ENABLED=true \ # to enable the collection of CWS network events
  -e HOST_ROOT=/host/root \
  -e DD_API_KEY=<API KEY> \
  gcr.io/datadoghq/agent:7

For a package-based deployment, the Datadog package has to be deployed: run dkpg -i datadog-agent_7….deb

By default Runtime Security is disabled. To enable it, both the datadog.yaml and the system-probe.yaml files need to be adapted. Run the following commands to enable these configurations:

debian-runtime-security.sh

echo "runtime_security_config.enabled: true" >> /etc/datadog-agent/security-agent.yaml
echo "runtime_security_config.enabled: true" >> /etc/datadog-agent/system-probe.yaml
  
# For [Datadog Agent][1] version 7.36 only, to enable the collection of CWS network events
echo "runtime_security_config.network.enabled: true" >> /etc/datadog-agent/system-probe.yaml

systemctl restart datadog-agent

Once you apply the changes, restart both the Security Agent and the system-probe.

For a package-based deployment, the Datadog package has to be deployed: run yum/dnf install datadog-agent_7….rpm

fedora-centos-runtime-security.sh

echo "runtime_security_config.enabled: true" >> /etc/datadog-agent/security-agent.yaml
echo "runtime_security_config.enabled: true" >> /etc/datadog-agent/system-probe.yaml
  
# For [Datadog Agent][1] version 7.36 only, to enable the collection of CWS network events
echo "runtime_security_config.network.enabled: true" >> /etc/datadog-agent/system-probe.yaml
  
systemctl restart datadog-agent

Getting Started with Cloud Workload Security

Overview

Requirements

Installation

Further Reading