Update Jamf and macOS w/ Fleet and agent documentation#533
Conversation
|
|
| If you plan to use GitOps instead of the Fleet UI, skip this step and see the [GitOps section below](#gitops-configure-fleet-with-fleetctl) for the YAML-based alternative. | ||
| </div> | ||
| </Alert> | ||
| Fleet deploys certificates and configuration to devices using a configuration profile. You can download this from the Smallstep dashboard and upload it to Fleet. No need to build the payloads or paste certificate data by hand. |
There was a problem hiding this comment.
The PR description notes that the .mobileconfig from the web console currently still has to be tweaked manually for this flow to work — specifically (1) removing the Certificate key and (2) setting CAFingerprint to the SHA256 of the agent's root. That seems to contradict the "No need to build the payloads or paste certificate data by hand" instruction here (and the "bundles everything required" follow-up on line 147).
Should these steps document the manual Certificate removal and CAFingerprint change, or is the console expected to emit a ready-to-upload profile before this merges? Want to make sure we're not shipping instructions that won't work end-to-end yet.
(Note: the Jamf doc has the equivalent "no need to build the payloads by hand" claim on its line 136 — may warrant the same caveat if it applies there too.)
There was a problem hiding this comment.
The console is expected to fill the correct info. That change won't be online before this gets tested, though. So just manual for now, and this can be merged after.
For Jamf there's no need to change it, as it still uses SCEP in that case.
This PR takes the changes from #526, and builds on it by replacing the Fleet SCEP enrollment flow with an ACME enrollment flow backed by our Osquery extension. At the moment the
.mobileconfigin our web console has to be tweaked manually for this flow to work: 1)Certificateto be removed; 2)CAFingerprintto be set to the SHA256 of the agents root.Some iOS/ipadOS/tvOS references have been removed, as they seemed to be out of place in the current document. For those platforms we should either support plain SCEP (without the agent) or native ACME. It warrants an entirely new section or possibly even a page.
The updated Jamf docs have not been changed.