How to set capability bounding sets in Docker

Introduction

Docker has become a popular choice for containerizing applications, but managing the security and control of these containers is crucial. This tutorial will guide you through the process of understanding and configuring capability bounding sets in Docker, empowering you to enhance the security and control of your Docker-based applications.

Skills Graph

%%%%{init: {'theme':'neutral'}}%%%% flowchart RL docker(("`Docker`")) -.-> docker/SystemManagementGroup(["`System Management`"]) docker/SystemManagementGroup -.-> docker/info("`Display System-Wide Information`") docker/SystemManagementGroup -.-> docker/system("`Manage Docker`") docker/SystemManagementGroup -.-> docker/login("`Log into Docker Registry`") docker/SystemManagementGroup -.-> docker/logout("`Log out from Docker Registry`") docker/SystemManagementGroup -.-> docker/version("`Show Docker Version`") subgraph Lab Skills docker/info -.-> lab-411602{{"`How to set capability bounding sets in Docker`"}} docker/system -.-> lab-411602{{"`How to set capability bounding sets in Docker`"}} docker/login -.-> lab-411602{{"`How to set capability bounding sets in Docker`"}} docker/logout -.-> lab-411602{{"`How to set capability bounding sets in Docker`"}} docker/version -.-> lab-411602{{"`How to set capability bounding sets in Docker`"}} end

Understanding Docker Capabilities

Docker capabilities are a security feature that allow you to grant or restrict specific privileges to a container. Capabilities are a Linux kernel feature that provide a finer-grained control over the permissions granted to a process, rather than the traditional all-or-nothing approach of the root user.

In the Linux kernel, there are over 30 different capabilities that can be granted or restricted. Some examples include:

CAP_NET_ADMIN: Allows the container to perform network-related operations, such as configuring network interfaces, setting up firewalls, and managing routing tables.
CAP_SYS_ADMIN: Grants a wide range of system administration privileges, including mounting file systems, loading kernel modules, and performing other low-level system operations.
CAP_CHOWN: Allows the container to change the ownership of files and directories.

By default, Docker containers are granted a limited set of capabilities, which helps to reduce the attack surface and potential security risks. However, in some cases, you may need to grant additional capabilities to your container to enable certain functionalities.

graph TD A[Linux Kernel] --> B[Capabilities] B --> C[CAP_NET_ADMIN] B --> D[CAP_SYS_ADMIN] B --> E[CAP_CHOWN] B --> F[Other Capabilities] C --> G[Network Management] D --> H[System Administration] E --> I[Ownership Changes]

Table 1: Common Docker Capabilities

Capability	Description
`CAP_NET_ADMIN`	Allows the container to perform network-related operations.
`CAP_SYS_ADMIN`	Grants a wide range of system administration privileges.
`CAP_CHOWN`	Allows the container to change the ownership of files and directories.

Understanding Docker capabilities is crucial for securing your containers and ensuring that they have the appropriate level of access to system resources.

Configuring Capability Bounding Sets

To configure the capability bounding set for a Docker container, you can use the --cap-add and --cap-drop options when starting the container.

The --cap-add option allows you to add one or more capabilities to the container's bounding set, while the --cap-drop option allows you to remove one or more capabilities from the container's bounding set.

Here's an example of how to start a container with the CAP_NET_ADMIN capability added and the CAP_SYS_ADMIN capability dropped:

docker run --cap-add=NET_ADMIN --cap-drop=SYS_ADMIN -it ubuntu:22.04 /bin/bash

In this example, the container will have the CAP_NET_ADMIN capability, which allows it to perform network-related operations, but the CAP_SYS_ADMIN capability, which grants a wide range of system administration privileges, will be removed.

You can also view the current capability bounding set of a running container using the docker inspect command:

docker inspect <container_id> | grep "CapBnd"

This will display the current capability bounding set for the specified container.

graph TD A[Docker Container] --> B[Capability Bounding Set] B --> C[--cap-add=NET_ADMIN] B --> D[--cap-drop=SYS_ADMIN] C --> E[CAP_NET_ADMIN] D --> F[CAP_SYS_ADMIN]

Table 1: Common Docker Capability Bounding Set Options

Option	Description
`--cap-add=<capability>`	Adds the specified capability to the container's bounding set.
`--cap-drop=<capability>`	Removes the specified capability from the container's bounding set.

Configuring the capability bounding set for your Docker containers is an important step in securing your applications and reducing the attack surface.

Practical Applications of Capability Bounding

Capability bounding sets in Docker can be used in a variety of practical scenarios to enhance the security and isolation of your containers.

Running Untrusted Applications

When running untrusted or potentially malicious applications in a container, you can use capability bounding sets to limit the privileges granted to the container. For example, you can drop the CAP_SYS_ADMIN capability to prevent the container from performing sensitive system administration tasks.

docker run --cap-drop=SYS_ADMIN -it untrusted-app /bin/bash

Securing Sensitive Services

If your container is running a sensitive service, such as a database or a web server, you can use capability bounding sets to restrict the container's access to only the necessary system resources. This helps to reduce the attack surface and minimize the potential impact of a security breach.

docker run --cap-drop=CHOWN --cap-drop=SETUID --cap-drop=SETGID -it secure-service /bin/bash

Compliance and Regulatory Requirements

In some industries, such as healthcare or finance, there may be specific compliance or regulatory requirements regarding the privileges granted to applications. Capability bounding sets can be used to ensure that your Docker containers meet these requirements and adhere to the necessary security standards.

graph TD A[Docker Container] --> B[Capability Bounding Set] B --> C[Untrusted Applications] B --> D[Sensitive Services] B --> E[Compliance Requirements] C --> F[Limit Privileges] D --> G[Restrict Access] E --> H[Meet Security Standards]

Table 1: Example Capability Bounding Set Configurations

Use Case	Capabilities to Drop
Untrusted Applications	`CAP_SYS_ADMIN`, `CAP_SETUID`, `CAP_SETGID`
Sensitive Services	`CAP_CHOWN`, `CAP_SETUID`, `CAP_SETGID`
Compliance Requirements	`CAP_SYS_ADMIN`, `CAP_MKNOD`, `CAP_AUDIT_WRITE`

By understanding and configuring the capability bounding sets for your Docker containers, you can enhance the security and isolation of your applications, meet compliance requirements, and reduce the potential attack surface.

Summary

By the end of this tutorial, you will have a comprehensive understanding of Docker capabilities and how to configure capability bounding sets. You will learn practical applications for managing these capabilities, enabling you to improve the security and control of your Docker-based applications.