Skip to content

docs: add fleet rollout details to Guardian enterprise deployment guide#2701

Open
milanwilliams wants to merge 5 commits into
mainfrom
milan/guardian-fleet-rollout
Open

docs: add fleet rollout details to Guardian enterprise deployment guide#2701
milanwilliams wants to merge 5 commits into
mainfrom
milan/guardian-fleet-rollout

Conversation

@milanwilliams

Copy link
Copy Markdown
Contributor

Summary

Enriches the Enterprise deployment guide section of the Guardian page (docs/guardian.mdx) with concrete fleet-rollout instructions, ported from semgrep/guardian-dev#53. This gives IT/security teams a copy-paste-ready path to standardize Guardian across a managed fleet.

Rather than adding a new competing heading, the content is folded into the existing MDM subsection (the built-in Claude Code / Cursor controls were already documented there), so there's one coherent section.

What's added

  • The minimal Claude Code managed-settings payload (extraKnownMarketplaces + enabledPlugins)
  • Two downloadable templates under docs/assets/guardian/, also inlined in <Accordion> blocks so the page is self-contained:
    • com.anthropic.claudecode.plist (Jamf)
    • semgrep-marketplace.mobileconfig (Iru)
  • An MDM platform table (Iru, Jamf), rollout tips, and Iru/Jamf step-by-step instructions

Notes / things to verify before fleet use

  • The managed-settings keys reflect Claude Code's plugin managed-settings format — worth a quick check against current Claude Code docs (flagged in the source PR too).
  • Download links unverified: this Mintlify site has no existing precedent for serving non-image files (.plist/.mobileconfig). The full contents are inlined as accordions as a reliable fallback; please confirm the /assets/guardian/* links resolve on the deploy preview.
  • The source calls it "Iru"; the guardian-dev PR description says "Iru (Kandji)". Kept "Iru" to match the source file.

🤖 Generated with Claude Code

Enrich the MDM subsection of the Guardian "Enterprise deployment guide"
with the concrete managed-settings payload, downloadable
com.anthropic.claudecode.plist and semgrep-marketplace.mobileconfig
templates (also inlined for copy-paste), and Iru and Jamf step-by-step
instructions. Ported from semgrep/guardian-dev#53.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mintlify

mintlify Bot commented Jul 11, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
semgrep-docs 🟢 Ready View Preview Jul 11, 2026, 12:47 AM

@khorne3

khorne3 commented Jul 13, 2026

Copy link
Copy Markdown
Collaborator

Hey @milanwilliams! The content looks great; what do you think about splitting this so that everything in the Enterprise deployment guide is on its own page?

@khorne3

khorne3 commented Jul 15, 2026

Copy link
Copy Markdown
Collaborator

@milanwilliams Here's the preview; let me know what you think!

Copy link
Copy Markdown
Contributor Author

@katie.horne That looks great! The only part is that I got the instructions wrong - it points our internal semgrep-marketplace, instead of the official Claude one.

I just opened a new PR to fix all the files here on the readme: semgrep/guardian-dev#75 if you wouldn't mind updating your PR to use the new content, I would appreciate it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants