Skip to content

Commit

Permalink
Update CWS setup instructions for host based installation
Browse files Browse the repository at this point in the history
  • Loading branch information
lebauce committed Apr 6, 2023
1 parent f924b37 commit aa4d4be
Showing 1 changed file with 54 additions and 32 deletions.
86 changes: 54 additions & 32 deletions content/en/security/cloud_workload_security/getting_started.md
Original file line number Diff line number Diff line change
Expand Up @@ -118,24 +118,30 @@ docker run -d --name dd-agent \

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 `security-agent.yaml` and the `system-probe.yaml` files need to be adapted. Run the following commands to enable these configurations:
By default Cloud Workload Security is disabled. To enable it, both the `security-agent.yaml` and the `system-probe.yaml` files need to be adapted as follows:

{{< code-block lang="bash" filename="debian-runtime-security.sh" >}}
1. Copy security-agent and system-probe example configurations:

echo "runtime_security_config.enabled: true" >> /etc/datadog-agent/security-agent.yaml
echo "runtime_security_config.enabled: true" >> /etc/datadog-agent/system-probe.yaml

systemctl restart datadog-agent
```shell
sudo -u dd-agent install -m 0640 /etc/datadog-agent/system-probe.yaml.example /etc/datadog-agent/system-probe.yaml
sudo -u dd-agent install -m 0640 /etc/datadog-agent/security-agent.yaml.example /etc/datadog-agent/security-agent.yaml
```

{{< /code-block >}}
2. Edit both `/etc/datadog-agent/security-agent.yaml` and `/etc/datadog-agent/system-probe.yaml` to set the enable flag to `true`:

For [Datadog Agent][1] version 7.36 only, to enable the collection of CWS network events:
```yaml
runtime_security_config:
## @param enabled - boolean - optional - default: false
## Set to true to enable Cloud Workload Security (CWS).
#
enabled: true
```

```shell
echo "runtime_security_config.network.enabled: true" >> /etc/datadog-agent/system-probe.yaml
```
3. Restart the Datadog agent.

Once you apply the changes, restart both the Security Agent and the system-probe.
```shell
sudo service restart datadog-agent
```

[1]: https://app.datadoghq.com/account/settings#agent/kubernetes
{{% /tab %}}
Expand All @@ -144,22 +150,30 @@ 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`

By default Runtime Security is disabled. To enable it, both the `security-agent.yaml` and the `system-probe.yaml` files need to be adapted. Run the following commands to enable these configurations:
By default Cloud Workload Security is disabled. To enable it, both `security-agent.yaml` and `system-probe.yaml` files need to be adapted as follows:

{{< code-block lang="bash" filename="fedora-centos-runtime-security.sh" >}}
1. Copy security-agent and system-probe example configurations:

echo "runtime_security_config.enabled: true" >> /etc/datadog-agent/security-agent.yaml
echo "runtime_security_config.enabled: true" >> /etc/datadog-agent/system-probe.yaml
```shell
sudo -u dd-agent install -m 0640 /etc/datadog-agent/system-probe.yaml.example /etc/datadog-agent/system-probe.yaml
sudo -u dd-agent install -m 0640 /etc/datadog-agent/security-agent.yaml.example /etc/datadog-agent/security-agent.yaml
```

systemctl restart datadog-agent
2. Edit both `/etc/datadog-agent/security-agent.yaml` and `/etc/datadog-agent/system-probe.yaml` to set the enable flag to `true`:

{{< /code-block >}}
```yaml
runtime_security_config:
## @param enabled - boolean - optional - default: false
## Set to true to enable Cloud Workload Security (CWS).
#
enabled: true
```

For [Datadog Agent][1] version 7.36 only, to enable the collection of CWS network events:
3. Restart the Datadog agent.

```shell
echo "runtime_security_config.network.enabled: true" >> /etc/datadog-agent/system-probe.yaml
```
```shell
sudo service restart datadog-agent
```

[1]: https://app.datadoghq.com/account/settings#agent/kubernetes
{{% /tab %}}
Expand All @@ -168,22 +182,30 @@ echo "runtime_security_config.network.enabled: true" >> /etc/datadog-agent/syste

For a package-based deployment, the Datadog package has to be deployed. Install the package with your package manager.

By default Runtime Security is disabled. To enable it, both the `security-agent.yaml` and the `system-probe.yaml` files need to be adapted. Run the following commands to enable these configurations:
By default Cloud Workload Security is disabled. To enable it, both `security-agent.yaml` and `system-probe.yaml` files need to be adapted as follows:

{{< code-block lang="bash" filename="host-runtime-security.sh" >}}
1. Copy security-agent and system-probe example configurations:

echo "runtime_security_config.enabled: true" >> /etc/datadog-agent/security-agent.yaml
echo "runtime_security_config.enabled: true" >> /etc/datadog-agent/system-probe.yaml
```shell
sudo -u dd-agent install -m 0640 /etc/datadog-agent/system-probe.yaml.example /etc/datadog-agent/system-probe.yaml
sudo -u dd-agent install -m 0640 /etc/datadog-agent/security-agent.yaml.example /etc/datadog-agent/security-agent.yaml
```

systemctl restart datadog-agent
2. Edit both `/etc/datadog-agent/security-agent.yaml` and `/etc/datadog-agent/system-probe.yaml` to set the enable flag to `true`:

{{< /code-block >}}
```yaml
runtime_security_config:
## @param enabled - boolean - optional - default: false
## Set to true to enable Cloud Workload Security (CWS).
#
enabled: true
```

For [Datadog Agent][1] version 7.36 only, to enable the collection of CWS network events:
3. Restart the Datadog agent.

```shell
echo "runtime_security_config.network.enabled: true" >> /etc/datadog-agent/system-probe.yaml
```
```shell
sudo service restart datadog-agent
```

[1]: https://app.datadoghq.com/account/settings#agent/kubernetes
{{% /tab %}}
Expand Down

0 comments on commit aa4d4be

Please sign in to comment.