From e29adfdf1774923d223803dd02532abe1045726d Mon Sep 17 00:00:00 2001
From: Josune Cordoba <49480155+josunect@users.noreply.github.com>
Date: Wed, 29 Jan 2025 22:44:16 +0000
Subject: [PATCH] Add ambient warning about permissions (#855)

---
 content/en/docs/Features/ambient.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/content/en/docs/Features/ambient.md b/content/en/docs/Features/ambient.md
index a2ef49f7..2ab6f6d5 100644
--- a/content/en/docs/Features/ambient.md
+++ b/content/en/docs/Features/ambient.md
@@ -23,6 +23,10 @@ This badge indicates that Kiali has detected a ztunnel (the L4 component for Amb
 
 ![Ambient Control Plane](/images/documentation/features/ambient/ambient-control-plane.png)
 
+{{% alert color="warning" %}}
+For Kiali to detect Ambient, it needs to have access to the namespace were ztunnel is deployed. This is usually the istio namespace, but on platforms such as OpenShift, it may differ.
+{{% /alert %}}
+
 ### Ambient Namespace
 
 When a namespace is labeled with `istio.io/dataplane-mode=ambient` it is included in Ambient Mesh, and Kiali will show the Ambient badge on that Overview page namespace card: 
@@ -105,4 +109,4 @@ There is an additional display option, **Waypoint proxies** for the Ambient Mesh
 The waypoint proxies often serve as both the source and destination of traffic within the same workload, represented in the graph by bidirectional edges. 
 When you click on an edge, the summary panel will display the waypoint proxy as the destination workload. However, you can also view the waypoint as the source by clicking on the double arrow icon located to the left of the "From/To" labels in the summary panel.
 
-![bidirectional edges](/images/documentation/features/ambient/double-edges.png)
\ No newline at end of file
+![bidirectional edges](/images/documentation/features/ambient/double-edges.png)