Comment on page
Connect Deployed Agents to SaaS Management Using Helm (K8s)
You can also connect to the SaaS Management using only Helm values. This is relevant e.g. in a GitOps scenario where you deploy also the Helm chart from your Git repo.
Follow these steps to connect your agents to the management:
Check the "I deployed an agent" box, the Central Management box will become enabled.
The best-practice recommendation is to create an individual profile in the WebUI for each of your open-appsec deployments. Examples for "deployments" would be e.g.:
- K8s deployment using HELM or installation tool (consisting of one or multiple open-appsec agents)
- redundant deployment using Docker on two or more virtual machines (each having it's own agent) protecting the same web assets
- redundant embedded deployment on one or multiple redundant Linux machines protecting the same web assets
Security-wise this makes sure that only policies for those assets which are protected by specific agents are enforced on those agents (by linking the Assets to only the relevant profile(s)), in addition to having a separate tokens per each deployment and all associated agents.
In addition this approach provides the flexibility of being able to configure various settings available on profile-level individually per each deployment, if required.
In the Getting Started page, click Manage and choose Kubernetes Profile, you will get to the profile page:
NGINX Kubernetes Ingress Profile Example
In the "sub type" field select either NGINX or Kong depending on what kind of open-appsec agent/deployment you want to connect.
NGINX Kubernetes Ingress Profile Example
Choose the relevant option to decide whether you want to edit assets and policies via the WebUI or locally in a declarative way (using CRDs or configuration files). If you choose a declarative option you can still view the configuration in the WebUI in read-only mode.
Kubernetes management mode
In the top-right of the WebUI click on "Enforce" to enforce the policy.
In the WebUI go to the Profile you created in the step above and copy the token.
In order to connect to the management you need to run
helm upgrade command as follows:helm upgrade {open-appsec-helm-release-name} open-appsec-k8s-nginx-ingress-latest.tgz \
-n {open-appsec-namespace} \
--reuse-values \
--set appsec.mode="managed" \
--set appsec.agentToken={token}
open-appsec-helm-release-name - replace with the name of the currently installed open-appsec-helm release, you can get this by using the following command which will show all currently installed helm releases helm list -Aopen-appsec-namespace - replace with the namespace of your open-appsec deploymenttoken - replace with the token you copied from the Profile in the WebUI. --reuse-values - This tells Helm to reuse all Helm values you configured when originally deploying the open-appsec helm chart.
Note that when doing the Helm deployment declaratively from a central Git repo using some GitOps CD tool you need to replace this to specify explicitly all the specific Helm values you require.Once you performed the instructions, after about two minutes, you will see a green notification bar in the Web UI. Your open-appsec agents are now connected to the management!