$ oc get route central -n stackrox
Red Hat Advanced Cluster Security for Kubernetes (RHACS) installs a set of services on your OpenShift Container Platform cluster. This section describes the installation procedure for installing Red Hat Advanced Cluster Security for Kubernetes on your OpenShift Container Platform cluster by using an Operator.
Before you install:
The Red Hat Advanced Cluster Security for Kubernetes Operator includes the following two custom resources:
Central
- The central resource is a logical grouping of the following services:
Central: Central is the Red Hat Advanced Cluster Security for Kubernetes application management interface and services. It handles data persistence, API interactions, and user interface (RHACS Portal) access. You can use the same Central instance to secure multiple OpenShift Container Platform or Kubernetes clusters.
Scanner: Scanner is a Red Hat-developed and certified vulnerability scanner for scanning container images and their associated database. It analyzes all image layers to check known vulnerabilities from the Common Vulnerabilities and Exposures (CVEs) list. Scanner also identifies vulnerabilities in packages installed by package managers and in dependencies for multiple programming languages.
SecuredCluster
- The secured cluster resource is a logical grouping of the following services:
Sensor: Sensor is the service responsible for analyzing and monitoring the cluster. It handles interactions with the OpenShift Container Platform or Kubernetes API server for policy detection and enforcement, and it coordinates with Collector.
Collector: Collector analyzes and monitors container activity on cluster nodes. It collects information about container runtime and network activity. It then sends the collected data to Sensor.
Admission Control: The admission controller prevents users from creating workloads that violate security policies in Red Hat Advanced Cluster Security for Kubernetes.
The following steps represent a high-level workflow for installing Red Hat Advanced Cluster Security for Kubernetes by using an Operator:
Install the Red Hat Advanced Cluster Security for Kubernetes Operator from OperatorHub in the cluster where you want to install Central.
Configure and deploy the Central
custom resource.
Generate and apply an init bundle.
Install the Red Hat Advanced Cluster Security for Kubernetes Operator in all clusters that you want to monitor.
Configure and deploy the SecuredCluster
custom resource in all clusters that you want to monitor.
Using the OperatorHub provided with OpenShift Container Platform is the easiest way to install Red Hat Advanced Cluster Security for Kubernetes.
You have access to an OpenShift Container Platform cluster using an account with Operator installation permissions.
You must be using OpenShift Container Platform 4.6 or later.
Navigate in the web console to the Operators → OperatorHub page.
Enter Advanced Cluster Security into the Filter by keyword box to find the Red Hat Advanced Cluster Security for Kubernetes Operator.
Select the Red Hat Advanced Cluster Security for Kubernetes Operator to view the details page.
Read the information about the Operator and click Install.
On the Install Operator page, keep the default values for Update channel, Installation mode, Installed namespace, and Approval strategy.
Click Install.
After the installation completes, navigate to Operators → Installed Operators to verify that the Red Hat Advanced Cluster Security for Kubernetes Operator is listed with the status of Succeeded.
The main component of Red Hat Advanced Cluster Security for Kubernetes is called Central. You can install Central on OpenShift Container Platform by using the Central
custom resource. You deploy Central only once, and you can monitor multiple separate clusters by using the same Central installation.
When you install Red Hat Advanced Cluster Security for Kubernetes for the first time, you must first install the |
You must be using OpenShift Container Platform 4.6 or later.
On the OpenShift Container Platform web console, navigate to the Operators → Installed Operators page.
Select the Red Hat Advanced Cluster Security for Kubernetes Operator from the list of installed Operators.
By default, OpenShift Container Platform lists the project as openshift-operator
. Select Project: openshift-operator → Create project.
You must install the Red Hat Advanced Cluster Security for Kubernetes |
Enter the new project name, for example, stackrox
, and click Create.
Under the Provided APIs section, select Create instance on the Central API.
Enter a name for your Central
custom resource and add any labels you want to apply. Otherwise, accept the default values for the available options.
Click Create.
If you are using the cluster-wide proxy, Red Hat Advanced Cluster Security for Kubernetes uses that proxy configuration to connect to the external services. |
After Central finishes installing, log in to the RHACS portal to verify the successful installation of Central.
On the OpenShift Container Platform web console, navigate to the Operators → Installed Operators page.
Select the Red Hat Advanced Cluster Security for Kubernetes Operator from the list of installed Operators.
Select the Central tab.
From the Centrals list, select stackrox-central-services
to view its details.
The Admin Credentials Info section lists the command you need to run to get the autogenerated password. Run the command to get your admin password.
Navigate to Networking → Routes.
Find the central Route and click on the RHACS portal link under the Location column.
Log in to the RHACS portal using the username admin and the autogenerated password.
When you create a Central instance, the Operator lists the following configuration options for the Central
custom resource.
Parameter | Description |
---|---|
|
Specify a secret that contains the administrator password in the |
|
By default, Central only serves an internal TLS certificate, which means that you need to handle TLS termination at the ingress or load balancer level. If you want to terminate TLS in Central and serve a custom server certificate, you can specify a secret containing the certificate and private key. |
|
Set this parameter to |
|
If the node selector selects tainted nodes, use this parameter to specify a taint toleration key, value, and effect for Central. This parameter is mainly used for infrastructure nodes. |
|
Set this to |
|
Use this parameter to specify a custom port for your load balancer. |
|
Use this parameter to specify a static IP address reserved for your load balancer. |
|
Set this to |
|
Set this to |
|
Use this to specify an explicit node port. |
|
If you want this component to only run on specific nodes, you can configure a node selector by using this parameter. |
|
Specify a host path to store persistent data in a directory on the host. Red Hat does not recommend using this. If you need to use host path, you must use it with a node selector. |
|
The name of the PVC to manage persistent data.
If no PVC with the given name exists, it will be created. The default value is |
|
The size of the persistent volume when created through the claim. This is automatically generated by default. |
|
The name of the storage class to use for the PVC. If your cluster is not configured with a default storage class, you must provide a value for this parameter. |
|
Use this paramter to override the default resource limits for the Central. |
|
Use this parameter to override the default resource requests for the Central. |
|
Use this parameter to specify the image pull secrets for the Central image. |
Parameter | Description |
---|---|
|
If you want this scanner to only run on specific nodes, you can configure a node selector by using this parameter. |
|
If the node selector selects tainted nodes, use this parameter to specify a taint toleration key, value, and effect for Scanner. This parameter is mainly used for infrastructure nodes. |
|
Use this parameter to override the default resource limits for the scanner. |
|
Use this parameter to override the default resource requests for the scanner. |
|
When enabled, the number of analyzer replicas is managed dynamically based on the load, within the limits specified. |
|
Specifies the maximum replicas to be used the analyzer autoscaling configuration |
|
Specifies the minimum replicas to be used the analyzer autoscaling configuration |
|
When autoscaling is disabled, the number of replicas will always be configured to match this value. |
|
If you want this component to only run on specific nodes, you can configure a node selector by using this parameter. |
|
If the node selector selects tainted nodes, use this parameter to specify a taint toleration key, value, and effect for ScannerDB. This parameter is mainly used for infrastructure nodes. |
|
Use this parameter to override the default resource limits for the scanner. |
|
Use this parameter to override the default resource requests for the scanner. |
|
If you do not want to deploy Scanner, you can disable it by using this parameter. If you disable Scanner, all other settings in this section have no effect. Red Hat does not recommend disabling Red Hat Advanced Cluster Security for Kubernetes Scanner. |
Parameter | Description |
---|---|
|
Additional Trusted CA certificates for the secured cluster to trust. This is typically used when integrating with services using a private certificate authority. |
|
Specify |
To create a secured cluster, you must create an init bundle. The secured cluster uses this bundle to authenticate with Central.
You can create an init bundle by using the the roxctl CLI or from the RHACS portal.
You can create an init bundle by using the RHACS portal.
Find the address of the RHACS portal based on your exposure method:
For a route:
$ oc get route central -n stackrox
For a load balancer:
$ oc get service central-loadbalancer -n stackrox
For port forward:
Run the following command:
$ oc port-forward svc/central 18443:443 -n stackrox
Navigate to https://localhost:18443/
.
On the RHACS portal, navigate to Platform Configuration → Integrations.
Under the Authentication Tokens section, click on Cluster Init Bundle.
Click New Integration.
Enter a name for the cluster init bundle and click Generate.
Click Download Kubernetes Secret File to download the generated bundle.
Store this bundle securely because it contains secrets. You can use the same bundle to create multiple secured clusters. |
You can create an init bundle by using the the roxctl
CLI.
You have configured the ROX_API_TOKEN
and the ROX_CENTRAL_ADDRESS
environment variables.
Run the following command to generate a cluster init bundle:
$ roxctl -e "$ROX_CENTRAL_ADDRESS" \
central init-bundles generate <cluster_init_bundle_name> \
--output-secrets cluster_init_bundle.yaml
Make sure that you store this bundle securely because it contains secrets. You can use the same bundle to set up multiple secured clusters. |
Before you install secured clusters, you must create the required resources.
You must have generated an init bundle.
Run the following command to create the resources:
$ oc create -f <init_bundle>.yaml \ (1)
-n <stackrox> (2)
1 | Specify the init bundle file name. |
2 | Specify the name of the project where you installed Central. |
You can install secured cluster services on your clusters by using the SecuredCluster
custom resource. You must install the secured cluster services on every cluster in your environment that you want to monitor.
To install Collector on systems configured with Unified Extensible Firmware Interface (UEFI) boot, you must use eBPF probes because kernel modules are unsigned, and the UEFI firmware cannot load unsigned packages. |
You must be using OpenShift Container Platform 4.6 or later.
You must have generated an init bundle and already created the required resources by using the init bundle.
On the OpenShift Container Platform web console, navigate to the Operators → Installed Operators page.
Select the Red Hat Advanced Cluster Security for Kubernetes Operator form the list of installed operators.
By default, OpenShift Container Platform lists the project as openshift-operator
. Select Project: openshift-operator → Create project.
You must install Red Hat Advanced Cluster Security for Kubernetes |
Enter the new project name as stackrox or some other name, and click Create.
Under the Provided APIs section, select Create instance on the Secured Cluster API.
Enter a name for your SecuredCluster
custom resource.
For Central Endpoint, enter the address and port number of your Central instance.
For example, if Central is available at https://central.example.com
, then specify the central endpoint as central.example.com:443
.
The default value of central.stackrox.svc:443
only works when you install secured cluster services and Central in the same cluster.
Accept the default values or configure custom values for the avilable options.
Click Create.
When you create a Central instance, the Operator lists the following configuration options for the Central
custom resource.
Parameter | Description |
---|---|
|
The endpoint of Central instance to connect to, including the port number.
If using a non-gRPC capable load balancer, use the WebSocket protocol by prefixing the endpoint address with |
|
The unique name of this cluster, which shows up in the RHACS portal. After the name is set by using this parameter, you cannot change it again. To change the name, you must delete and recreate the object. |
Parameter | Description |
---|---|
|
Specify |
|
Specify |
|
Specify |
|
If you want this component to only run on specific nodes, you can configure a node selector using this parameter. |
|
If the node selector selects tainted nodes, use this parameter to specify a taint toleration key, value, and effect for Admission Control. This parameter is mainly used for infrastructure nodes. |
|
Use this parameter to override the default resource limits for the admission controller. |
|
Use this parameter to override the default resource requests for the admission controller. |
|
Use this parameter to bypass the admission controller. |
|
Use one of the following values to specify if the admission controller must connect to the image scanner:
|
|
Use this parameter to specify the maximum number of seconds Red Hat Advanced Cluster Security for Kubernetes must wait for an admission review before marking it as fail open. |
Use image configuration settings when you are using a custom registry.
Parameter | Description |
---|---|
|
Additional image pull secrets to be taken into account for pulling images. |
Per node settings define the configuration settings for components that run on each node in a cluster to secure the cluster. These components are Collector and Compliance.
Parameter | Description |
---|---|
|
The method for system-level data collection. The default value is |
|
The image type to use for Collector. You can specify it as |
|
Use this parameter to override the default resource limits for Collector. |
|
Use this parameter to override the default resource requests for Collector. |
|
Use this parameter to override the default resource requests for Compliance. |
|
Use this parameter to override the default resource limits for Compliance. |
Parameter | Description |
---|---|
|
To ensure comprehensive monitoring of your cluster activity, Red Hat Advanced Cluster Security for Kubernetes runs services on every node in the cluster, including tainted nodes by default.
If you do not want this behavior, specify |
This configuration defines the settings of the Sensor components, which runs on one node in a cluster.
Parameter | Description |
---|---|
|
If you want Sensor to only run on specific nodes, you can configure a node selector. |
|
If the node selector selects tainted nodes, use this parameter to specify a taint toleration key, value, and effect for Sensor. This parameter is mainly used for infrastructure nodes. |
|
Use this parameter to override the default resource limits for Sensor. |
|
Use this parameter to override the default resource requests for Sensor. |
Parameter | Description |
---|---|
|
Additional trusted CA certificates for the secured cluster. These certificates are used when integrating with services using a private certificate authority. |
|
Set this to |
|
Allows specifying custom annotations for the Central deployment. |
|
Advanced settings to configure environment variables. |
|
Configures whether Red Hat Advanced Cluster Security for Kubernetes should run in online or offline mode. In offline mode, automatic updates of vulnerability definitions and kernel modules are disabled. |
After you complete the installation, navigate to the RHACS portal and run a few vulnerable applications to evaluate the results of security assessments and policy violations.
The sample applications listed in the following section contain critical vulnerabilities and they are specifically designed to verify the build and deploy-time assessment features of Red Hat Advanced Cluster Security for Kubernetes. |
Find the address of the RHACS portal based on your exposure method:
For a route:
$ oc get route central -n stackrox
For a load balancer:
$ oc get service central-loadbalancer -n stackrox
For port forward:
Run the following command:
$ oc port-forward svc/central 18443:443 -n stackrox
Navigate to https://localhost:18443/
.
Create a new project:
$ oc new-project test
Start some applications with critical vulnerabilities:
$ oc run shell --labels=app=shellshock,team=test-team \
--image=vulnerables/cve-2014-6271 -n test
$ oc run samba --labels=app=rce \
--image=vulnerables/cve-2017-7494 -n test
Red Hat Advanced Cluster Security for Kubernetes automatically scans these deployments for security risk and policy violations as soon as they are submitted to the cluster.
Navigate to the RHACS portal to view the violations.
You can log in to the RHACS portal by using the default username admin
and the generated password.