Metarget Save

Metarget is a framework providing automatic constructions of vulnerable infrastructures.

Project README

1 Introduction

Metarget = meta- + target, a framework providing automatic constructions of vulnerable infrastructures, used to deploy simple or complicated vulnerable cloud native targets swiftly and automatically.

1.1 Why Metarget?

During security researches, we might find that the deployment of vulnerable environment often takes much time, while the time spent on testing PoC or ExP is comparatively short. In the field of cloud native security, thanks to the complexity of cloud native systems, this issue is more terrible.

There are already some excellent security projects like Vulhub, VulApps in the open-source community, which pack vulnerable scenes into container images, so that researchers could utilize them and deploy scenes quickly.

However, these projects mainly focus on vulnerabilities in applications. What if we need to study the vulnerabilities in the infrastructures like Docker, Kubernetes and even Linux kernel?

Hence, we develop Metarget and hope to solve the deployment issue above to some extent. Furthermore, we also expect that Metarget could help to construct multilayer vulnerable cloud native scenes automatically.

1.2 Install Vulnerability!

In this project, we come up with concepts like installing vulnerabilities and installing vulnerable scenes. Why not install vulnerabilities just like installing softwares? We can do that, because our goals are security research and offensive security.

To be exact, we expect that:

metarget cnv install cve-2019-5736 will install Docker with CVE-2019-5736 onto the server.
metarget cnv install cve-2018-1002105 will install Kubernetes with CVE-2018-1002105 onto the server.
metarget cnv install kata-escape-2020 will install Kata-containers with CVE-2020-2023/2025/2026 onto the server.
metarget cnv install cve-2016-5195 will install a kernel with DirtyCoW into the server.

It's cool, right? No more steps. No RTFM. Execute one command and enjoy your coffee.

Furthermore, we expect that:

with Metarget's help, ethical hackers are able to deploy simple or complicated cloud native targets swiftly and learn by hacking cloud native environments.
metarget appv install dvwa will install a DVWA target onto our vulnerable infrastructure.
metarget appv install thinkphp-5-0-23-rce --external will install a ThinkPHP RCE vulnerability with NodePort service onto our vulnerable infrastructure.

You can just run 5 commands below after installing a new Ubuntu and obtain a multi-layer vulnerable scene:

./metarget cnv install cve-2016-5195 # container escape with dirtyCoW
./metarget cnv install cve-2019-5736 # container escape with docker
./metarget cnv install cve-2018-1002105 # kubernetes single-node cluster with cve-2018-1002105
./metarget cnv install privileged-container # deploy a privileged container
./metarget appv install dvwa --external # deploy dvwa target

RCE, container escape, lateral movement, persistence, they are yours now.

More awesome functions are coming! Stay tuned :)

Note:

This project aims to provide vulnerable scenes for security research. The security of scenes generated is not guaranteed. It is NOT recommended to deploy components or scenes with Metarget on the Internet.

2 Installation

2.1 Requirements

Ubuntu 16.04 or 18.04 (recommended)
- for some cases (e.g. new kernel vulnerabilities) specific Ubuntu distributions are needed
- you can read the note for specific vulnerabilities (prompted by an asterisk (*)) for details
Python >= 3.6 (Python 2.x is unsupported!)
pip3

2.2 From Source

Clone the repository and install requirements:

git clone https://github.com/brant-ruan/metarget.git
cd metarget/
pip3 install -r requirements.txt

Begin to use Metarget and construct vulnerable scenes. For example:

./metarget cnv install cve-2019-5736

2.3 From PyPI

Currently unsupported.

3 Usage

Metarget needs to be run as root.

It is recommended to add --verbose option when debugging.

3.1 Basic Usage

usage: metarget [-h] [-v] subcommand ...

automatic constructions of vulnerable infrastructures

positional arguments:
  subcommand     description
    gadget       cloud native gadgets (docker/k8s/...) management
    cnv          cloud native vulnerabilities management
    appv         application vulnerabilities management

optional arguments:
  -h, --help     show this help message and exit
  -v, --version  show program's version number and exit

Run ./metarget gadget list to see cloud native components supported currently.

3.2 Manage Cloud Native Components

usage: metarget gadget [-h] subcommand ...

positional arguments:
  subcommand  description
    list      list supported gadgets
    install   install gadgets
    remove    uninstall gadgets

optional arguments:
  -h, --help  show this help message and exit

3.2.1 Case: Install Docker with Specified Version

Run:

./metarget gadget install docker --version 18.03.1

If the command above completes successfully, 18.03.1 Docker will be installed.

3.2.2 Case: Install Kubernetes with Specified Version

Run:

./metarget gadget install k8s --version 1.16.5

If the command above completes successfully, 1.16.5 Kubernetes single-node cluster will be installed.

Note:

Usually, lots of options need to be configured in Kubernetes. As a security research project, Metarget provides some options for installation of Kubernetes:

  -v VERSION, --version VERSION
                        gadget version
  --cni-plugin CNI_PLUGIN
                        cni plugin, flannel by default
  --pod-network-cidr POD_NETWORK_CIDR
                        pod network cidr, default cidr for each plugin by
                        default
  --taint-master        taint master node or not

Metarget supports deployment of multi-node cluster. If you want to add more nodes into the cluster, you can copy tools/install_k8s_worker.sh script and run it on each worker nodes after the successful installation of single-node cluster.

3.2.3 Case: Install Kata-containers with Specified Version

Run:

./metarget gadget install kata --version 1.10.0

If the command above completes successfully, 1.10.0 Kata-containers will be installed.

Note:

You can also specify the type of kata runtime (qemu/clh/fc/...) with --kata-runtime-type option, which is qemu by default.

3.2.4 Case: Install Linux Kernel with Specified Version

Run:

./metarget gadget install kernel --version 5.7.5

If the command above completes successfully, 5.7.5 kernel will be installed.

Note:

Currently, Metarget installs kernels in 2 ways:

apt
if apt package is not available, download *.deb remotely from Ubuntu and try to install

After successful installation of kernel, reboot of system is needed. Metarget will prompt to reboot automatically.

usage: metarget cnv [-h] subcommand ...

positional arguments:
  subcommand  description
    list      list supported cloud native vulnerabilities
    install   install cloud native vulnerabilities
    remove    uninstall cloud native vulnerabilities

optional arguments:
  -h, --help  show this help message and exit

Run ./metarget cnv list to see vulnerable scenes related to cloud native components supported currently.

3.3.1 Case: CVE-2019-5736

Run:

./metarget cnv install cve-2019-5736

If the command above completes successfully, Docker with CVE-2019-5736 will be installed。

3.3.2 Case: CVE-2018-1002105

Run:

./metarget cnv install cve-2018-1002105

If the command above completes successfully, Kubernetes with CVE-2018-1002105 will be installed。

3.3.3 Case: Kata-containers Escape

Run:

./metarget cnv install kata-escape-2020

If the command above completes successfully, Kata-containers with CVE-2020-2023/2025/2026 will be installed。

3.3.4 Case: CVE-2016-5195

Run:

./metarget cnv install cve-2016-5195

If the command above completes successfully, kernel with CVE-2016-5195 will be installed。

usage: metarget appv [-h] subcommand ...

positional arguments:
  subcommand  description
    list      list supported application vulnerabilities
    install   install application vulnerabilities
    remove    uninstall application vulnerabilities

optional arguments:
  -h, --help  show this help message and exit

Run ./metarget appv list to see vulnerable scenes related to cloud native applications supported currently.

Note:

Before deploying application vulnerable scenes, you should install Docker and Kubernetes firstly. You can use Metarget to install Docker and Kubernetes.

3.4.1 Case: DVWA

Run:

./metarget appv install dvwa

If the command above completes successfully, DVWA will be deployed as Deployment and Service resources in current Kubernetes.

Note:

You can specify --external option, then the service will be exposed as NodePort, so that you can visit it by IP of the host node (By default, the type of service is ClusterIP).
You can specify --host-net option, then the appv will share the host network namespace.
You can specify --host-pid option, then the appv will share the host pid namespace.

3.5 Manage Vulnerable Cloud Native Target Cluster

Developing, currently not supported.

4 Scene List

If there is an asterisk (*) following the name of one vulnerable scene, you need to read the note related to it below the whole table for further details.

Name	Class	Type	CVSS 3.x	Writeup*
cve-2018-15664	docker	container_escape	7.5
cve-2019-13139	docker	command_execution	8.4	link
cve-2019-14271	docker	container_escape	9.8	link
cve-2020-15257	docker/containerd	container_escape	5.2	link
cve-2019-5736	docker/runc	container_escape	8.6
cve-2019-16884	docker/runc	container_escape	7.5
cve-2021-30465*	docker/runc	container_escape	7.6	link
cve-2017-1002101	k8s	container_escape	9.6	link
cve-2018-1002105	k8s	privilege_escalation	9.8
cve-2018-1002100	k8s/kubectl	container_escape	5.5
cve-2019-1002101	k8s/kubectl	container_escape	5.5
cve-2019-11246	k8s/kubectl	container_escape	6.5
cve-2019-11249	k8s/kubectl	container_escape	6.5
cve-2019-11251	k8s/kubectl	container_escape	5.7
cve-2019-11253	k8s	denial_of_service	7.5
cve-2019-9512	k8s	denial_of_service	7.5
cve-2019-9514	k8s	denial_of_service	7.5
cve-2019-9946	k8s	traffic_interception	7.5
cve-2020-8554	k8s	man_in_the_middle	5.0
cve-2020-10749	k8s/kubernetes-cni	man_in_the_middle	6.0
cve-2020-8555	k8s	server_side_request_forgery	6.3
cve-2020-8557	k8s	denial_of_service	5.5
cve-2020-8558	k8s	exposure_of_service	8.8
cve-2020-8559	k8s	privilege_escalation	6.8
cve-2021-25741	k8s	container_escape	8.1
cve-2016-5195	kernel	container_escape	7.8
cve-2016-8655	kernel	privilege_escalation	7.8
cve-2017-6074	kernel	privilege_escalation	7.8
cve-2017-7308	kernel	container_escape	7.8	link
cve-2017-16995	kernel	privilege_escalation	7.8
cve-2017-1000112	kernel	container_escape	7.0	link
cve-2018-18955	kernel	privilege_escalation	7.0
cve-2020-14386	kernel	container_escape	7.8
cve-2021-3493	kernel	privilege_escalation	7.8	link
cve-2021-4204	kernel	privilege_escalation	-
cve-2021-22555	kernel	container_escape	7.8
cve-2022-0185	kernel	container_escape	8.4
cve-2022-0492	kernel	container_escape	7.8	link
cve-2022-0847	kernel	container_escape	7.8	link
cve-2022-0995*	kernel	privilege_escalation	7.1
cve-2022-25636*	kernel	privilege_escalation	7.8
cve-2022-23222	kernel	privilege_escalation	7.8
cve-2022-27666*	kernel	privilege_escalation	7.8
kata-escape-2020	kata-containers	container_escape	6.3/8.8/8.8
cap_dac_read_search-container	config	container_escape	-	link
cap_sys_admin-container	config	container_escape	-
cap_sys_ptrace-container	config	container_escape	-
cap_sys_module-container	config	container_escape	-	link
privileged-container	config	container_escape	-	link
k8s_backdoor_daemonset	config	persistence	-	link
k8s_backdoor_cronjob	config	persistence	-	link
k8s_shadow_apiserver	config	persistence	-	link
k8s_node_proxy	config	privilege_escalation	-	link
mount-docker-sock	mount	container_escape	-	link
mount-host-etc	mount	container_escape	-
mount-host-procfs	mount	container_escape	-	link
mount-var-log	mount	container_escape	-	link

Note:

Currently writeups are in Chinese.
It is recommended to add --verbose option when debugging.
You might find that some kernel vulnerabilities are marked as privilege_escalation, while others container_escape. The essential difference is the payload (get a shell with high privilege or escape first).
- Thanks to default security mechanisms (e.g. Seccomp, Capabilities) in containers, some kernel vulnerabilities may be hard or almost not to exploit.
- Hence, vulnerabilities are marked as container_escape if we could reproduce the whole process with Metarget, others temporarily marked as privilege_escalation.
For cve-2021-30465, after cnv install cve-2021-30465 (which installs Docker),
- you'd better install a K8s manually, for exploitation (e.g. cnv install cve-2018-1002105 or gadget install k8s --version 1.16.5 with Metarget).
For kernel vulnerabilities below, Ubuntu 21.10 is needed to run Metarget (tested):
- cve-2022-0995
- cve-2022-25636
- cve-2022-27666

These scenes are mainly derived from other open-source projects:

Vulhub
DVWA

We express sincere gratitude to projects above!

Metarget converts scenes in projects above to Deployments and Services resources in Kubernetes (thanks to kompose).

To list vulnerable scenes related to cloud native applications supported by Metarget, just run：

./metarget appv list

Note:

For the deployment of Confluence's vulnerability CVE-2019-3396, you may refer to Vulhub, while the address of PostgreSQL should be cve-2019-3396-db, not db in Vulhub.

5 DEMO

6 Development Plan

deployments of basic cloud native components (docker, k8s)
integrations of vulnerable scenes related to cloud native components
integrations of RCE scenes in containers
automatic construction of multi-node cloud native target cluster
integrations of other cloud native vulnerable scenes (long term)

7 Maintainers

8 Contribution

One of Metarget's goals is to facilitate more rapid construction of vulnerable environments when vulnerabilities occur. Also, it could be used to construct all the integrated vulnerable scenes whenever you want.

To keep Metarget up-to-date, the vulnerable scenes lists (both cnv and appv) will be maintained.

YAML is used in Metarget to describe & integrate vulnerable scenes. Currently, scenes in two layers, cnv (in vulns_cn/) and appv (in vulns_app/), are supported.

Maintenance from the community is appreciated and welcome. Hope that we can gather and share our knowledge and researches in the context of Metarget, and promote the development of cloud native security.

Currently, you can contribute to Metarget in two ways:

Submit YAML files of new cloud native vulnerabilities (cnv).
Submit YAML files of new cloud native application vulnerabilities (appv).

Please see CONTRIBUTING.md for details.

9 Collaboration (Contact us at [email protected])

We eagerly welcome collaboration with universities, research institutions, and other academic entities! Metarget is dedicated to being an ideal experimental platform for cutting-edge research in the field of cloud-native security. We believe that cloud-native security will be a forefront topic in the future of network security, and Metarget provides an ideal research environment for this.

Through our robust and flexible framework, you can delve into the security challenges of cloud-native environments, discover and explore innovative solutions, and contribute your expertise and findings to the entire industry's development.

Metarget offers the following distinctive support to collaborators:

Diverse experimental scenarios: Utilize Metarget to effortlessly build various vulnerable cloud-native target environments, covering a spectrum of experiment scenarios from simple to complex.
Support for multiple versions of Kernel, Kubernetes, and other cloud-native components: Metarget consistently updates to support the latest versions of components, ensuring that you can use the latest technologies in your experiments.
Customization of Ubuntu versions: We will tailor Ubuntu versions based on your experimental requirements, providing you with a more flexible experimental environment configuration.
Automatic generation of multi-node cloud-native clusters: Metarget offers the functionality to automatically create multi-node cloud-native target clusters, enhancing the realism and depth of your research.
...

Joining Metarget provides you with comprehensive technical support and abundant collaboration opportunities, allowing you to explore the forefront of cloud-native security and contribute your unique insights to the future development of network security. We look forward to your participation in collectively shaping a new chapter in cybersecurity research!

10 About Logo

It is not a Kubernetes, but a vulnerable infrastructure with three gears which could not work well (vulnerable) :)

10 License

Metarget is licensed under Apache License 2.0. See LICENSE for the full license text.

11 Events

KCon 2021 Arsenal

URL: http://kcon.knownsec.com/2021/#/arsenal

OpenInfra Days Asia 2021

Topic: Metarget: Auto-construction of Vulnerable Cloud Native Infrastructure
Video: https://www.youtube.com/watch?v=43UvCHjn8wA
PPT: OID-Asia-2021-Metarget.pdf

OpenInfra Days China 2021

Topic: Metarget：构建云原生基础设施靶场
PPT: OID-China-2021-Metarget.pdf

CCF BDTC 2021

Topic: 构建云原生基础设施靶场

Reference in Paper (IEEE TPS-ISA 2021)

Paper: Security Challenges in the Container Cloud
PDF: TPS21.pdf

CSDN Cloud Native Security Summit 2022

Topic: 攻方视角：从开源靶场看云原生安全
PPT: CSDN云原生安全技术峰会-2022-攻方视角：从开源靶场看云原生安全.pdf

Reference in Paper (IC2E 2022)

Paper: PACED: Provenance-based Automated Container Escape Detection
PDF: IC2E-2022.PACED.pdf

CIS 2022

Topic: Metarget: 云原生安全研究与自动化
URL: https://cis.freebuf.com

Metarget Joins CNCF Landscape

URL: https://landscape.cncf.io/?selected=metarget

Open Source Agenda is not affiliated with "Metarget" Project. README Source: Metarget/metarget

Stars

998

Open Issues

Last Commit

2 weeks ago

Repository

Metarget/metarget

License

Apache-2.0

Open Source Agenda Badge

<a href="https://www.opensourceagenda.com/projects/metarget"><img src="https://www.opensourceagenda.com/projects/metarget/reviews/badge.svg" alt="Open Source Agenda"></a>

Submit Review Review Your Favorite Project

Submit Resource Articles, Courses, Videos

Submit Article Submit a post to our blog

From the blog

Dec 11, 2022

How to Choose Which Programming Language to Learn First?

From the blog

Dec 11, 2022

Metarget Save

1 Introduction

1.1 Why Metarget?

1.2 Install Vulnerability!

2 Installation

2.1 Requirements

2.2 From Source

2.3 From PyPI

3 Usage

3.1 Basic Usage

3.2 Manage Cloud Native Components

3.2.1 Case: Install Docker with Specified Version

3.2.2 Case: Install Kubernetes with Specified Version

3.2.3 Case: Install Kata-containers with Specified Version

3.2.4 Case: Install Linux Kernel with Specified Version

3.3 Manage Vulnerable Scenes Related to Cloud Native Components

3.3.1 Case: CVE-2019-5736

3.3.2 Case: CVE-2018-1002105

3.3.3 Case: Kata-containers Escape

3.3.4 Case: CVE-2016-5195

3.4 Manage Vulnerable Scenes Related to Cloud Native Applications

3.4.1 Case: DVWA

3.5 Manage Vulnerable Cloud Native Target Cluster

4 Scene List

4.1 Vulnerable Scenes Related to Cloud Native Components

4.2 Vulnerable Scenes Related to Cloud Native Applications

5 DEMO

6 Development Plan

7 Maintainers

8 Contribution

9 Collaboration (Contact us at [email protected])

10 About Logo

10 License

11 Events

KCon 2021 Arsenal

OpenInfra Days Asia 2021

OpenInfra Days China 2021

CCF BDTC 2021

Reference in Paper (IEEE TPS-ISA 2021)

CSDN Cloud Native Security Summit 2022

Reference in Paper (IC2E 2022)

CIS 2022

Metarget Joins CNCF Landscape

Open Source Agenda Badge

From the blog

How to Choose Which Programming Language to Learn First?

From the blog

How to Choose Which Programming Language to Learn First?