> For the complete documentation index, see [llms.txt](https://docs.opsmx.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opsmx.com/ssd/security-risk-and-prioritization/getting-started/integration-with-kubernetes-cluster/integrating-kube-detector.md).

# Integrating Kube Detector

The following steps provide instructions on how to integrate kube-detector in the cluster. Kube-detector can be integrated in two ways as listed below:  

* [In-cluster](#in-cluster)
* [Remote](#remote)

### **In-cluster:** 

In this method, you need to install the Kube Detector service in the cluster where the applications are running. 

{% hint style="info" %}
Choose this option if you do not wish to share your Kubernetes cluster’s kubeconfig file with Delivery Shield.
{% endhint %}

1. Create a new namespace in the target cluster by executing the command given below:

```
kubectl create ns <namespace>
```

2. Navigate to **Setup** > **Clusters**.
3. Click on the three vertical dots in the cluster details page as shown below:

<figure><img src="/files/h0DiqFQ5aGaenAaWT6y9" alt=""><figcaption></figcaption></figure>

4. Download the **In-cluster** file.
5. Edit the downloaded incluster file and update the new namespace value in the **ClusterRoleBinding** section as shown below:

![](https://lh7-us.googleusercontent.com/docsz/AD_4nXdp7b5zqjP03hWO95kopLNCs-pcL8708Fv5I34A1Hi7gdcTi4StY7OiyhY0pJ6GxYUDKxE3tGA7HEe0CxuSTmrwZLK_nAOM6ZXqzyIYrrc03vDitvqb_ox8aciRTTilUZNPUR14ZxmlL2VAaklPlGZC6PA?key=kukZZ60M_tCuFA03ihGwWw)

6. Add the namespace values that you want to monitor, in the kube-detector secret section of the downloaded remote file.&#x20;

<figure><img src="/files/6OOwV4uAToZsgc77QvIt" alt=""><figcaption></figcaption></figure>

7. Apply the file in the target cluster namespace by executing the command given below:

```
kubectl apply -f <Path to file> -n <namespace>
```

8. The Kubernetes cluster is successfully integrated with SSD. It starts collecting data for the services that are added in the namespaces and the applications appear in the Delivery Shield UI.

### **Remote:**&#x20;

In this method, you can install the Kube-detector service in the Delivery Shield namespace. If you select this method, your target cluster's kubeconfig file will be shared with Delivery Shield.

1. Navigate to **Setup** > **Clusters**.
2. Click on the three vertical dots in the cluster details page as shown below:

<figure><img src="/files/lA9m7iWQ6oeIAz79Usmw" alt=""><figcaption></figcaption></figure>

3. Click on the three vertical dots in the cluster details below and download the remote file.
4. Next, create a Kubernetes secret in the SSD namespace and store your target cluster's kubeconfig file in it using the following command:

{% code overflow="wrap" %}

```
kubectl create secret generic <Secret name> --from-file=<Path to Kubeconfig> -n <SSD Namespace>
```

{% endcode %}

5. Open the downloaded remote file, and update the following fields.&#x20;

* **secretName** - The name of the secret created in the previous step.
* **key** - The key in the secret that points to the kubeconfig data.&#x20;
* **path** - The value in the secret that points to the kubeconfig.

<figure><img src="https://lh7-us.googleusercontent.com/docsz/AD_4nXfhINlNpET3mIO298rkF5CYuYPOyqXL_b0UZnXI0Dce-HRRm2YeVfKQG5F20mBTC7RxnpyKyx4ltGWbeg_Kbsh7A_yfdMMXKZGHfQ3G0GUuUgXDIwQQ64j8X-DfSHY8ji1o32-VkD366LVr9Vtqd5rgreFg?key=kukZZ60M_tCuFA03ihGwWw" alt=""><figcaption></figcaption></figure>

4. Add the namespace values that you want to monitor, in the kube-detector secret section of the downloaded remote file.&#x20;

<figure><img src="https://lh7-us.googleusercontent.com/docsz/AD_4nXeaxTdtrakHO1ssFU8K8JWP4SbYe4t0q0TNxJb13DEJANBQ5yfjm9MKGUaIihpmby5uhdLvbcnzRr86DFH-1E15FM_V0JLnCeAswKhuy18cqdSudDP8W5hglxUu-Q8--EwuXU-lRZIhUmmDSBoKZa16uyI?key=kukZZ60M_tCuFA03ihGwWw" alt=""><figcaption></figcaption></figure>

5. Apply the kube-detector file in the SSD namespace by executing the command given below:

```
kubectl apply -f <Path to file> -n <namespace>
```

The Kubernetes cluster is now successfully integrated with SSD.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.opsmx.com/ssd/security-risk-and-prioritization/getting-started/integration-with-kubernetes-cluster/integrating-kube-detector.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.