Skip to content

Correct the agent certificate label in the Intune macOS tutorial - #578

Merged
tashian merged 1 commit into
mainfrom
carl/eff-1128-docs-intune-macos-tutorial-agent-settings
Nov 11, 2026
Merged

tashian merged 1 commit into
mainfrom
carl/eff-1128-docs-intune-macos-tutorial-agent-settings

Conversation

@tashian

@tashian tashian commented Nov 11, 2026

Copy link
Copy Markdown
Member

Problem

In step 5 of the Intune macOS tutorial, the sample Smallstep Agent Settings profile sets the Certificate value to mackms:label=$PROFILE_IDENTIFIER;se=false;tag=.

$PROFILE_IDENTIFIER is a Jamf variable. Intune does not replace it. The Mac gets the text as it is. The agent cannot find a certificate with that label, and it stops at startup with exit code 78 (EX_CONFIG).

Change

  • Use mackms:label=step-agent-bootstrap;se=false;tag=. This label is the common name in the SCEP profile of step 4. The profile that the Smallstep console makes uses the same label.
  • Replace the two fixed sample PayloadUUID values with placeholders. Tell the reader to make new UUIDs with uuidgen.
  • Add one sentence that says why the label must agree with the SCEP profile.

Test

vale shows 0 errors for the file. The warnings are the same as before this change.

Not in this change

connect-workspace-one-to-smallstep-macos.mdx also uses $PROFILE_IDENTIFIER. That page tells the reader to adjust the value. I did not change it, because I did not test the value with Workspace ONE.

Linear: EFF-1128

🤖 Generated with Claude Code

The sample agent settings profile used the variable $PROFILE_IDENTIFIER
in the Certificate value. Only Jamf replaces this variable. Intune sends
the text as it is, and then the agent cannot find its bootstrap
certificate and does not start.

Use the label step-agent-bootstrap. This is the common name in the SCEP
profile of the same tutorial.

Replace the fixed sample PayloadUUID values with placeholders, and tell
the reader to make new UUIDs with uuidgen.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@tashian
tashian marked this pull request as ready for review November 11, 2026 03:12
@tashian
tashian requested a review from a team as a code owner November 11, 2026 03:12
@tashian
tashian merged commit b40c3ee into main Nov 11, 2026
4 checks passed
@tashian
tashian deleted the carl/eff-1128-docs-intune-macos-tutorial-agent-settings branch November 11, 2026 17:02
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.

3 participants