Skip to content

Support SCEP automatic profile redistribution in Iru tutorial#532

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

Support SCEP automatic profile redistribution in Iru tutorial#532
tashian wants to merge 6 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 puts the SCEP profile's UUID in the certificate Subject's CN, the keychain label changes, and the agent's exact-match certificate lookup fails — the agent can never start after the first renewal.

Since Iru requires the CN to carry the profile identifier, the CN isn't a stable lookup key. This updates the tutorial to identify the certificate by stable DN components instead:

  • Enable Automatic profile redistribution in the SCEP profile steps so the enrollment certificate renews
  • SCEP profile Subject becomes CN=$PROFILE_UUID,OU=$BLUEPRINT_ID,L=step-agent-bootstrap
  • Agent Certificate value becomes mackms:ou=$BLUEPRINT_ID;l=step-agent-bootstrap;se=false;tag=
  • The SCEP library item and the agent Custom Profile must be assigned to the same Blueprint so $BLUEPRINT_ID renders identically in both

⚠️ Do not merge yet — this documents agent behavior that hasn't shipped: mackms: lookup by ou/l Subject components (today it only supports label/serial/keychain). Merge once the agent change is released.

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>
@tashian
tashian enabled auto-merge (squash) July 15, 2026 15:47
Iru requires the profile identifier in the CN, so the CN is not a
stable lookup key. Instead of copying the SCEP library item's UUID
into the agent profile, set stable OU/L components in the SCEP
Subject and have the agent search by those via mackms ou= and l=.

Requires the SCEP profile and the agent Custom Profile to be assigned
to the same Blueprint so $BLUEPRINT_ID renders identically in both.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@tashian
tashian marked this pull request as draft July 16, 2026 22:35
auto-merge was automatically disabled July 16, 2026 22:35

Pull request was converted to draft

Comment thread tutorials/connect-iru-to-smallstep.mdx Outdated
Comment thread tutorials/connect-iru-to-smallstep.mdx Outdated
Comment thread tutorials/connect-iru-to-smallstep.mdx Outdated
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