search

fleetdm / fleet

Open-source platform for IT, security, and infrastructure teams. (Linux, macOS, Chrome, Windows, cloud, data center)
https://fleetdm.com
Other
3.18k stars 435 forks source link

Website request: Add mTLS diagram showing the flow #24376

Open pboushy opened 7 hours ago

pboushy commented 7 hours ago

Goal

User story
As a Fleet Administrator,
I want to have a clear visual of how the mTLS functionality in Fleet works
so that there is no confusion on where mTLS is configured.

How?

Context

I requested the Fleetd Authentication page be created to detail how the client-side communicates with the server-side. It does a decent job detailing how the enrollment process and ongoing communication happen when mTLS is not involved, and it briefly mentions mTLS, but neither it nor Using mTLS show a good visual of what pieces use mTLS and how mTLS is designed.

I'd like one of the pages to be updated to clearly show the flows. Ideally this would be done via a mermaid diagram like in Fleetd Authentication for non-mTLS.

https://github.com/fleetdm/fleet/blob/0028e2ce3fdd0ff5e30a2cc901329b4511a3f450/articles/fleetd-authentication.md?plain=1#L107-L112

allenhouchins commented 7 hours ago

@phtardif1 - I don't think there are any action items here for SCs. The request is for a mermaid diagram and should come from the creator of the Using mTLS document as the subject matter expert or #g-digital-experience.

harrisonravazzolo commented 3 hours ago

Ah I see this now - it's a continuation of https://github.com/fleetdm/confidential/issues/8668. I'll raise it in engineering channel and follow.

harrisonravazzolo commented 3 hours ago

https://fleetdm.slack.com/archives/C019WG4GH0A/p1733351508623469