Skip to content

Support SCEP automatic profile redistribution in Iru tutorial#532

Open
tashian wants to merge 2 commits into
mainfrom
carl/eff-433-iru-smallstep-device-identity-documentation-for-profile
Open

Support SCEP automatic profile redistribution in Iru tutorial#532
tashian wants to merge 2 commits into
mainfrom
carl/eff-433-iru-smallstep-device-identity-documentation-for-profile

Conversation

@tashian

@tashian tashian commented Jul 15, 2026

Copy link
Copy Markdown
Member

Describe your changes:

The Iru (Kandji) tutorial's agent configuration only works while SCEP certificate renewal is off. When Automatic profile redistribution is enabled on the SCEP library item, Iru appends the SCEP library item's UUID to the certificate Subject, the keychain label changes, and the agent's exact-match certificate lookup fails — the agent can never start after the first renewal.

This updates the tutorial so the documented configuration works with renewal enabled:

  • Enable Automatic profile redistribution in the SCEP profile steps, and explain how it changes the issued certificate's Common Name (step-agent-bootstrap <uuid>, single space before the UUID)
  • Add a step to copy the SCEP library item's UUID (the last path segment of its Iru URL)
  • Include the UUID in the agent's mackms: certificate label, with the exact-match caveat
  • Make the ordering dependency explicit: the SCEP library item must exist before the agent Custom Profile
  • Warn against using $PROFILE_UUID in the agent's Custom Profile (it renders that profile's own UUID, not the SCEP item's) and against deleting/recreating the SCEP library item (new UUID breaks enrolled devices)

Verified with vale and markdown-link-check, and rendered locally via pnpm dev.

Related links/other PRs/issues:

EFF-433

Thank you!

🤖 Generated with Claude Code

With Iru's automatic profile redistribution enabled, the SCEP library
item's UUID is appended to the certificate Subject, so the agent's
keychain lookup label must include it. Without this, the agent's
exact-match certificate lookup fails after the first renewal and the
agent cannot start.

- Enable automatic profile redistribution in the SCEP profile steps
- Add a step to copy the SCEP library item's UUID from its URL
- Include the UUID in the agent's mackms: certificate label
- Require creating the SCEP profile before the agent Custom Profile
- Warn against $PROFILE_UUID in the agent profile and against
  recreating the SCEP library item

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@tashian tashian requested a review from a team as a code owner July 15, 2026 01:49
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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.

1 participant