...
Admin access to the Kubernetes cluster.
Whitelisting Data Theorem IP’s to allow the Data Theorem’s analyzer to properly talks connect to the Kubernetes API.
Step 1: Generate the service account
In order to complete the onboarding process, you will need to execute a script on your machine . This script requires:
...
cluster-admin access to the Kubernetes cluster
...
...
in order to generate a new service account.
This service account will have read-only permissions and will allow Data Theorem to connect to the Kubernetes cluster API to analyze its configuration.
The script requires:
cluster-admin access to the Kubernetes cluster.
Python 3.7+.
View file | ||
---|---|---|
|
The script is written in Python. It works with Python 3.7+ on macOS and Linux.The script will:
Create a service account for Data Theorem.
Add a security audit role (with read-only access).
Link the security audit role to the service account.
Generate a kube config file for the previously generated service account.
Note |
---|
The script calls |
Onboarding Kubernetes cluster on Amazon (EKS)
First we you need to retrieve the role ARN of the Kubernetes cluster:
Go to the AWS Console
Go to EKS
On the left hand side, click on
Clusters
, underAmazon EKS
In the list of clusters, search for the cluster name you want to onboard and click on it
Then click on the
Configuration
tabFinally copy the
Cluster IAM Role ARN
...
Then run the script as follows:
Code Block | ||
---|---|---|
| ||
python3 datatheorem-k8s-onboarding.py -p aws -o <CONFIGdatatheorem_k8s_OUTPUTservice_PATH>account.yaml --rolearn <ROLE_ARN> |
Onboarding Kubernetes cluster on Azure (AKS)
In order to onboard the cluster, it must have the RBAC setting enabled. You can make sure of that by going to the Azure Console and:
Kubernetes Services
Search for the name of the cluster you want to onboard and click on it
Under
Settings
, click onCluster configuration
Role-based access control (RBAC)
must beEnabled
...
Code Block | ||
---|---|---|
| ||
python3 datatheorem-k8s-onboarding.py -p azure -o datatheorem_k8s_service_account.yaml |
...
Code Block | ||
---|---|---|
| ||
python3 datatheorem-k8s-onboarding.py -p gcp -o datatheorem_k8s_service_account.yaml |
Onboarding on-premise and others Kubernetes cluster
Code Block | ||
---|---|---|
| ||
python3 datatheorem-k8s-onboarding.py -p onprem -o datatheorem_k8s_service_account.yaml |
...
To complete the onboarding process, upload the service account file to the Data Theorem portal in the ASM setup section: https://www.securetheorem.com/cloud/asm-setup.
Start the flow using “Add source” and then “Kubernetes cluster”.