Files
netbird-docs/src/pages/manage/control-center/index.mdx
T
Eduard Gert 4f29fccbdf Document Agent Network in Control Center (#1050)
* Document Agent Network in Control Center

* Note that Control Center access is needed for Agent Network edits
2026-10-16 14:22:30 +02:00

141 lines
7.3 KiB
Plaintext

import {Note} from "@/components/mdx"
import {HashRedirect} from "@/components/HashRedirect"
export const description =
'Control Center provides a topological view of your NetBird network, visualizing access relationships between peers, users, groups, and networks. Edit policies in place, or stage larger changes with Draft Mode.'
<HashRedirect
map={{
"editing-policies-from-the-graph": "/manage/control-center#edit-nodes",
}}
/>
# Visualize Remote Access with Control Center
Control Center is a topological view in the NetBird dashboard that visualizes who can access what across your environment. It maps **Peers**, **Users**, **Groups**, and **Networks** to the resources they can reach and shows the access control policies that permit those connections.
<Note>
**Availability**: NetBird Cloud (all plans) and self-hosted.
</Note>
<Note>
**Permissions:** The Admin and Network Admin user roles can make changes from Control Center, in the live view and
in Draft Mode. The exception is installing placeholder peers in a draft, which creates a setup key and is therefore
not available to Network Admins. Learn more about [user roles](/manage/team/user-roles).
</Note>
## How It Helps
- **Faster audits:** Confirm a device, group, or network's effective access at a glance.
- **Quicker troubleshooting:** Follow the policy path that grants access to a resource.
- **Safer changes:** Click through to the exact policy to refine sources, destinations, or ports without hunting across pages.
## Views
### Peers View
Use this to understand what a specific machine can reach.
<p>
<img src="/docs-static/img/manage/control-center/control-center-peer-view.png" alt="Control Center Peer View"
className="imagewrapper-big"/>
</p>
- Click the peer node, then search or choose another peer from the dropdown to switch focus.
- The graph shows the peer's access control policy nodes and the reachable resources.
- Click a policy chip to open the standard policy editor. Changes you save are reflected in the graph immediately.
### Users View
Use this view to see what resources a specific user can access.
<p>
<img src="/docs-static/img/manage/control-center/control-center-user-view.png"
alt="Control Center User View" className="imagewrapper-big"/>
</p>
- Click the user node, then search or choose another user from the dropdown to switch focus.
- The graph shows the users peers, access control policy nodes and the reachable resources.
- Click a peer to switch focus only to that specific peer.
- Click a policy chip to open the standard policy editor. Changes you save are reflected in the graph immediately.
### Groups View
Use this to validate team-level access.
<p>
<img src="/docs-static/img/manage/control-center/control-center-groups-view.png"
alt="Control Center Groups View" className="imagewrapper-big"/>
</p>
- Click a group node, then search or choose from the dropdown to switch groups.
- The layout shows which resources that group can reach and via which policies.
- View-only for topology here; create or delete groups in the Groups section outside Control Center. Group-based access is the recommended way to manage permissions.
Common checks:
- Confirm that "DevOps" can reach RDS on TCP 5432, or that "Support" only reaches SSH on TCP 22.
### Networks View
Use this to see who can access resources in your routed [networks](/manage/networks).
<p>
<img src="/docs-static/img/manage/control-center/control-center-network-view.png"
alt="Control Center Network View" className="imagewrapper-big"/>
</p>
- Toggle **All Networks** or select a specific network.
- The network node shows its resources. Connecting lines display the port allowed by the policy and which groups have access.
- Click any policy chip to edit it in the standard editor. NetBird Networks and routing peers enable access to private subnets and IP resources.
### Agent Network
When [Agent Network](/agent-network) is enabled for your account, the **Peers**, **Users**, and **Groups** views also show its providers and agent policies, so you can see which groups can reach which AI providers. You can edit providers and agent policies from the canvas and build new ones in Draft Mode. See [Agent Network in Control Center](/agent-network/control-center).
## Focus Mode
When the graph gets busy, focus a single node to see only what is connected to it. Right-click a node and choose **Focus**, or press `F` and then select the node.
<p>
<img src="/docs-static/img/manage/control-center/control-center-focus-context-menu.png" alt="The right-click menu on a policy node with the Focus option highlighted"
className="imagewrapper-big"/>
</p>
Everything unrelated dims, leaving only the focused node and its connections highlighted. A "Focusing on" pill at the top of the canvas shows what is in focus; close it to return to the full view.
<p>
<img src="/docs-static/img/manage/control-center/control-center-focus-active.png" alt="Focus Mode active on a group node, with unrelated nodes dimmed and the Focusing on pill shown at the top of the canvas"
className="imagewrapper-big"/>
</p>
## Edit Nodes
Control Center is not just a viewer. In the live view you can make changes in place, like editing a policy or changing a peer's group assignments:
- **Edit a policy:** Click an access control policy chip in any view to open the standard policy editor. You can change the usual policy fields as documented in [Access Control](/manage/access-control/manage-network-access), including sources, destinations, protocols, ports, and posture checks. The dashboard asks you to confirm a live change; once confirmed, it applies immediately.
- **Create new components:** Creating policies, groups, and other components happens in **Draft Mode** or on their regular dashboard pages, not in the live view.
For changes that span several components, **Draft Mode** lets you stage the whole set on a working copy of the canvas, review the exact API requests, and deploy everything as one batch. See [Plan and Deploy Changes with Draft Mode](/manage/control-center/draft-mode).
## Quick Start
1. Open **Control Center** in the NetBird dashboard.
2. Pick a tab: **Peers**, **Users**, **Groups**, or **Networks**.
3. Click a node to focus, then follow the policy chips to the target resource.
4. Click a policy chip to edit it, then save. The graph updates right away.
## Use Cases
- **Sanity-check a team:** In **Groups** view, select a group and verify the resources and ports granted by its policies match your intent. Adjust policies in place if needed.
- **Prepare a change:** In **Networks** view, review which groups reach a sensitive subnet before tightening ports or destinations.
- **Investigate access:** In **Peers** view, confirm why a host can reach a database by following the policy path and port labels, then narrow the rule if required.
- **MSPs:** Switch tenants in the MSP portal to repeat the same checks per customer environment.
## Related Docs
- [Manage network access with Groups and Access Policies](/manage/access-control/manage-network-access)
- [Apply posture checks to policies](/manage/access-control/posture-checks)
- [Networks and routing peers](/manage/networks)
- [MSP portal overview](/manage/for-partners/msp-portal)
- [Agent Network in Control Center](/agent-network/control-center)