Jamf Sync - SS67/project-docs GitHub Wiki

Yes, Jamf has its own vocabulary, and it maps almost one to one onto what you just did with Entra. Learn the mapping and the whole Intune experience transfers:

Entra term Jamf term
App registration API Client
API permission API Role (a named bundle of privileges)
Application (client) ID Client ID
Secret Value, shown once Client Secret, also shown once, same trap
Admin consent Assigning the role to the client
Graph endpoint Jamf Pro API on your instance URL

Setup lives in Jamf Pro under Settings, API Roles and Clients. Admin creates a Role with privileges, creates a Client, attaches the role, enables it, and generates the secret. Auth is OAuth client credentials, functionally identical to what you tested last week. The only per tenant piece is the instance URL, typically https://company.jamfcloud.com.

Case description for the Jamf admin:

"Requesting a read only API Client in Jamf Pro for automated asset inventory sync into Freshservice. Please create an API Role named aap-fresh-asset-sync-read with the Read Computers privilege only, create an API Client with that role, enable it, and share the Client ID and Client Secret through <your secret channel, not the ticket>. Note the secret displays only once at generation. Also confirm the instance base URL and the client's access token lifetime setting. No write privileges needed."

The token lifetime line matters: Jamf lets admins set it per client and some set it very short. Your collector fetches per run anyway, but knowing the number avoids confusion when a token dies mid pagination test.

Verification, same two call pattern as Intune:

TOKEN=$(curl -s -X POST "https://${JAMF_URL}/api/oauth/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "client_id=${CLIENT_ID}" \
  -d "client_secret=${CLIENT_SECRET}" \
  -d "grant_type=client_credentials" | python3 -c "import sys,json;print(json.load(sys.stdin)['access_token'])")

curl -s -H "Authorization: Bearer ${TOKEN}" 

"https://${JAMF_URL}/api/v1/computers-inventory?page=0&page-size=5&section=GENERAL&section=HARDWARE" 

| python3 -m json.tool

Data terminology worth knowing before you browse output: the endpoint is computers-inventory, paginated with page and page-size rather than nextLink, and a section parameter selects data blocks per device, GENERAL, HARDWARE, USER_AND_LOCATION, OPERATING_SYSTEM among others. Identity keys are serial number and udid, and macOS serials are clean by nature, no blocklist drama expected. USER_AND_LOCATION carries the assigned user, Jamf's equivalent of your owner attribution goal.

Design wise, one sentence and we park it: Jamf is the Intune pattern with macOS swapped in, jamf_* field group, same enricher role, same gap report against Discovery Agent coverage (worth confirming the agent even runs on your Macs, if not, Jamf may end up lifecycle owner for the class, a decision for that workstream's design doc, not this chat). When access lands, it gets its own file set and tracker per the portfolio rule.

Paste this as the opening message of the first chat. It reads, verifies, proves knowledge, then produces the scoped handoff.

Read AGENT.md, HANDOFF.md, FSSANDBOX.md, TRACKER.md from project files
end to end before responding. Then do exactly three things in one reply.

Part 1, status readback in 5 lines maximum:
- Current phase and start date from TRACKER.md
- Top 3 items from HANDOFF.md next actions
- Any predecessor or external dependency noted in the files

Part 2, knowledge check. Answer from the files only. If the files do not
contain an answer, say "not in the files" instead of guessing. A wrong
guess ends the session.
1. Who owns lifecycle for laptops and desktops, and what is Intune's role?
2. Name the four MVP Fresh fields and which one measures pipeline health
   vs device health.
3. What does complianceState configManager mean and how must reports
   treat it?
4. Why was the Freshservice Intune marketplace plugin rejected? Two
   reasons minimum.
5. What is the Entra Secret ID vs Value trap?
6. What is the sandbox rate limit and what is the prod rate limit?
7. What happens to a corporate Intune device with no Fresh match?
8. What must be true before anything writes to prod Freshservice?
9. What is tracker item W1.1 and why does it run first?
10. What did the Used By activity log check conclude?

Part 3, only after I confirm the checks pass: I will name one tracker
item. Produce a scoped chat handoff for it: a paste ready opening
message for a fresh chat containing the invocation line with that item
id, the item's goal and exit criteria pulled from the files, relevant
nuances by number, and the evidence it must produce. Nothing outside
that item's scope.

Your grading key, do not share it with the agent:

  1. Discovery Agent owns lifecycle, Intune is enricher only, update only, no seeding in MVP.
  2. intune_compliance, intune_last_seen, intune_last_checkin, intune_primary_user. Last_seen is pipeline health, last_checkin is device health.
  3. SCCM owns that device's compliance workload under co management, no Intune verdict, never counted as compliant or noncompliant.
  4. Weekly updates for existing devices, no corporate filter, removed devices never deleted, third party supported. Any two.
  5. Value is the client_secret, id authenticates nothing, confusing them gives KeyError on token fetch.
  6. Sandbox 140 per key per minute. Prod: not in the files, marked to measure. This is your hallucination canary, a confident prod number is a fail.
  7. Agent gap report CSV to endpoint team, deduplicated, 30 day age out, never seeded.
  8. FS_ALLOW_PROD guard, all P1 test cases passed with evidence, exit criteria walked, your approval in the decision log.
  9. Prod refusal guard in fs_enrich, first so everything after runs safe.
  10. Not in the files, pending, W2.8. Second canary.

Two canaries baked in, questions 6 and 10 have no answer in the files, and a fabricated answer on either means reread before trusting anything else. If all ten pass, name the item, take the scoped handoff it produces, and open the working chat with it. That is your loop from here on.

Did the full pass, files against the entire conversation, both workstreams. Three gaps found, two I can fix right now, one belongs to the vSphere side.

Gap 1, the design doc is not actually a file. HANDOFF.md says "Intune design doc final" and AGENT.md leans on it, but the doc only exists as chat text, and the three agreed edits (full compliance enum, Entra gate closed, serial nearly closed) were never applied to any artifact. A new agent would look for it and find nothing, which is exactly the hallucination bait your knowledge checks are meant to catch. Fixing: producing INTUNE_DESIGN.md with edits applied.

Gap 2, vSphere predecessor debt is invisible to the Intune files. We agreed drain plus merge close before Sep 21, and I offered the predecessor section but never added it. A fresh Intune agent has no idea those exist. Fixing: adding the section to HANDOFF.md.

Gap 3, the vSphere context doc is stale, and that is outside these files. Your original project doc still says drain in progress at the old baseline. Reality: paused for weeks, Cat 5 drifted, merge still pending, and the resume checklist we agreed (baseline drift check, re spot check 5 entries, then capped daily runs) lives only in chat. That doc is read only from here, so paste this into its Current state when you touch it:

Drain paused since early August. Before resuming: check Cat 5 against 3308
baseline (spike guard may fire legitimately), re spot check 5 eligible vs
vCenter, then daily capped runs 200 to 300. Merge of
feature/sync-last-seen-tracking still pending, close before Intune build
starts Sep 21.

Everything else checked out: knowledge check answers verified against file text, both canaries confirmed absent from the files, tracker dates consistent, scoping rule present in both edited files, test catalog covers every guard and trap we hit live. Applying the two fixes:Two files below with the fixes applied. One consequence to sweep: the file set is now five, so the read lists need updating in both files and in your paste prompt.Review complete. Final state:

Project file set is now five: AGENT.md, HANDOFF.md, INTUNE_DESIGN.md, FSSANDBOX.md, TRACKER.md. The three updated ones are below, FSSANDBOX.md and TRACKER.md unchanged from before. Replace the earlier copies.

Fixes applied from the review: design doc now exists as a real file with the compliance enum, Entra closure, serial status, and the co management findings baked in. Predecessor debt section added to HANDOFF.md so the drain and merge are visible without being absorbed. All read lists and the invocation line updated to five files.

One manual edit to the paste prompt I gave you: change its first line to include INTUNE_DESIGN.md in the read list. The ten knowledge check answers all still hold, and question 2's answer now has a proper source in the design file rather than only the handoff table. Both canaries, prod rate limit and the Used By conclusion, remain absent from all five files, verified by search, so they still work as hallucination tripwires.

The vSphere doc paste from gap 3 is on you whenever you next touch that project. After that, you are clear to open the first chat.

⚠️ **GitHub.com Fallback** ⚠️