docs: correct the JumpCloud tutorial against the live consoles - #554
Merged
Conversation
Walked the JumpCloud Admin Portal and the Smallstep console and fixed
every step that did not match what an operator actually sees.
JumpCloud console:
- the account menu holding "My API Key" is at the bottom left of the
navigation sidebar, not the top right
- the certificate policy is named "Install Certificate", not
"Windows Install Certificate"
- Software Management > Add New offers "JumpCloud Private Repo", not
"Private Repository"
- the Commands page's "+ Command" button opens a three-option menu;
say to pick the plain "Command", and that Type defaults to Linux
- name the required "Command Name" field and suggest
"Configure Smallstep Agent"
- the launch field is labelled "Event", not "Launch Event"
- note that Windows commands run as PowerShell
Smallstep console:
- the connection form takes a Name/Alias; it was undocumented
- the Agents authority page exposes the SHA-1 fingerprint directly:
switch the Intermediate Fingerprint dropdown from sha256 to sha1.
Drop the step/openssl computation and the colon-stripping step.
- state that JumpCloud's "CA ThumbPrint" needs the intermediate
fingerprint even though its own tooltip says "root CA thumbprint"
(verified against a working policy)
- the intermediate issuer name is the authority name plus
" Intermediate CA"; the console has no "Intermediate CA common name"
field to read
- take the team slug from the console URL
Agent install and configuration:
- get the Windows MSI from releases.smallstep.com
- replace the jcagent.conf JSON parsing with JumpCloud's built-in
{{device.id}} command variable, which resolves to the same system ID
that %JumpCloudSystemID% resolves to in the SCEP subject
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YYBwHCnG1u3JziQVuZgKY5
The connection page shows the challenge masked, and the value is a 32-character hex string — not the UUID that also appears on that page. Say so, so an operator does not copy the wrong one. Show the SCEP URL in the form the console actually renders for JumpCloud. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01YYBwHCnG1u3JziQVuZgKY5
Cross-checked against the Intune, Workspace ONE, Iru, Mosyle and wireless tutorials: - "Smallstep UI" violates the error-level Branding vale rule, which swaps it for "Smallstep console". Two occurrences. - Add JumpCloud to the vale vocabulary, beside Jamf and Mosyle. - Both other capi: docs carry a pre-October-2024 caveat: teams created before then may have an issuer CA with no team name in it. It was missing here. - Link the Authority list, as every other tutorial does, and name the "Hosted Authorities" section — linked authorities have no fingerprint dropdown. - Borrow the wireless tutorial's stronger wording for the intermediate going into the Root store: it names the consequence, which is what makes the warning stick. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01YYBwHCnG1u3JziQVuZgKY5
|
|
joshdrake
marked this pull request as ready for review
September 4, 2026 23:16
dopey
approved these changes
Sep 4, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Walked both consoles — the JumpCloud Admin Portal and the Smallstep
console — and fixed every step that did not match what an operator
actually sees.
JumpCloud console
Configure Smallstep AgentSmallstep console
shown" and had the reader compute it with
steporopenssland stripcolons. The authority page has an Intermediate Fingerprint row with
a
sha256 / sha1 / md5dropdown and a copy button; the value isalready unbroken lowercase hex. Removed the CLI commands and the
colon-stripping step.
(The
stepcommand was also wrong —--sha1requires--insecure.)though JumpCloud's tooltip calls it a root thumbprint. Verified against
a working policy.
issuer name is the Authority Name plus
Intermediate CA.docs both carry, and linked the Authority list as every other tutorial
does.
Worth stating, so nobody copies the UUID that also appears on that page.
not finish loading on the tenant I checked; the URL is more robust
anyway.)
Agent install and configuration
releases.smallstep.com, per request.
Worth flagging in review: every other tutorial links
packages.smallstep.com/.../step-agent_amd64_latest.msi, so this isnow the only one pointing elsewhere. There is a reason — JumpCloud
Private Repo takes a specific versioned file, which a
_latestURLdoes not give you — but it is a deliberate divergence.
jcagent.confJSON parsing with JumpCloud's built-in{{device.id}}command variable, which resolves to the same system idthat
%JumpCloudSystemID%resolves to in the SCEP subject. Muchshorter, and no dependency on the agent config file's location or
shape. Quoted, so PowerShell does not try to execute the substituted id.
Conventions
would have failed CI).
going into the Root store — it names the consequence.
Related
copy the URL and challenge from.
Vale is not installed locally, so the substitution list was checked by
hand rather than run.
🤖 Generated with Claude Code
https://claude.ai/code/session_01YYBwHCnG1u3JziQVuZgKY5