Skip to content
plugboard.appRequest a demo

Running the desk

Apple Manager

Two panels on the device page, fed by Apple School Manager or Apple Business Manager. No route of its own and no module gate: configure the connectors and the panels appear.

Apple Manager is not a device manager. It is the record of what your organisation bought, what cover it holds, and which MDM it is assigned to. Your Jamf, Kandji or Mosyle still owns the device’s behaviour: OS, battery, last check-in, who has it.

Two questions, answered by two connectors sharing one set of credentials:

QuestionConnectorPanel
Is this iPad still covered?Apple School / Business ManagerWarranty
Did we buy it, on what order, and is it pointed at the right MDM?Apple School / Business Manager (devices)Enrolment

Apple Manager answers this from the purchase record, with the school’s Apple School or Business Manager credentials. Apple GSX can also look up coverage, but only for a school that holds an Apple service account (Authorised Service Provider or Self Servicing Account).

The device page shows the status (active, expired or unknown), the date cover runs out, the plan name, and whether accidental damage is covered.

Two limits:

It knows only devices bought into your organisation. A device a parent bought at a retail store is not in Apple Manager, and comes back unknown rather than uncovered. That is deliberate: sitting beside the Dell, Lenovo and HP warranty connectors, this one has to be able to say “not mine” quietly.

Accidental damage is inferred, not reported. Apple exposes no flag for it. The difference between AppleCare+ (which covers a dropped iPad) and the older AppleCare Protection Plan (which does not) lives only in the plan’s description text. Getting it wrong in the cautious direction means somebody checks manually; the other direction means a family is told a repair is free when it is not.

A device with several coverage records (an original plan, a renewal, a cancelled one) is resolved by dropping the cancelled ones and taking the latest end date of what remains.

The organisation’s own record of the device: order and purchase details, and the MDM server it is assigned to. Where a device is enrolled to the wrong MDM, or to none, the device page can point it at the right one.

One API account covers both connectors. In Apple School Manager or Apple Business Manager: Preferences, then API. Create an API account, upload a public key, and Apple returns a Key ID.

Client IDSCHOOLAPI.<uuid> or BUSINESSAPI.<uuid>
Key IDReturned when you upload the public key
Private keyThe EC private key, PEM-encoded

All three are secrets and are held in the encrypted store. There is no base URL to configure: Apple’s hosts are fixed, and offering an editable one would put a tenant-supplied URL in front of a signed credential for no benefit.

The connection test mints a token and reads nothing. That proves the Client ID, the Key ID and the private key all agree.

Apple runs the same API on two hosts with two scopes. Which pair you enable depends on which Apple Manager your organisation actually holds:

Apple School ManagerApple Business Manager
Who has itSchools and districtsBusinesses, and some independent schools
Warranty connectorapple-school-managerapple-business-manager
Enrolment connectorapple-school-manager-enrolmentapple-business-manager-enrolment

Enable the pair that matches. Enabling both pairs against one set of credentials does not work, because the credentials are issued against one organisation, on one host.

Each pair counts as one integration against your connector allowance, because it is one Apple Manager account answering two questions.

SymptomCause
invalid_client on the connection testUsually the private key. A key pasted with literal \n instead of real line breaks is the commonest way this is misconfigured
Connection test passes, every serial comes back unknownThe wrong pair is enabled: School credentials against the Business host, or the reverse
One device comes back unknown, the rest are fineIt was not bought into your organisation. Check the reseller put it into your Apple Manager
Coverage says active but the plan looks wrongSeveral records exist. The latest end date wins and cancelled plans are ignored

Apple GSX is the repair-side integration and needs a service provider account. Dell, Lenovo and HP warranty connectors answer the same coverage question for their own hardware. A school with a mixed fleet runs several, and the device page asks whichever one owns that serial.