Classic API basic auth deprecated migrate to bearer token

By Sai Kiran Pandrala · Last verified: 2026-05-31 · Source: community Q&A, Apple Support docs, Apple Communities (discussions.apple.com)

If you hit Classic API basic auth deprecated migrate to bearer token on Jamf Pro in production, the steps below are the path most teams take in 2026. None of them require opening a support case unless your environment has a paid-tier dependency that Apple owns.

What classic api basic auth deprecated migrate to bearer token actually involves on Jamf Pro

This task on Jamf Pro is one of the more searched operational topics on AWS in the last 12 months. The procedure below is the path that works in a current AWS account with default IAM and standard VPC config.

The rest of this page is the structured fix path. Start with diagnose, then remediation, then the automation options so you do not have to do this by hand the next time it surfaces. Verify and safety sections at the end are the discipline that keeps the fix from regressing in production.

Spot the symptom

Look at the Jamf Pro change management entry or Apple Business Manager audit event for the failed call, even if you are not enrolled in macOS unified logging and iOS sysdiagnose Log Router. The basic 90-day event history works for most diagnostic purposes and lives in the console under Jamf Pro change management log and Apple Business Manager audit log > Event history. Filter by event name (the API action) and time range; the event JSON shows the exact user identity, source IP, request parameters, and error code.

Diff against last known good. The last config change you made is the cause about three quarters of the time, even when the change should not have mattered. Use Jamf inventory history and Time Machine snapshots (or your Terraform / Deployment Manager or Terraform drift report) to see the actual delta between the resource state when it worked and when it broke. The change you remember is often not the only change that happened.

Check the Google Apple System Status at www.apple.com/support/systemstatus/ and the per-product status board for ongoing service events in your region. About one in ten user-reported outages turn out to be region-scoped Apple product or service degradation already being tracked. Apple System Status also exposes an API and Jamf Pro Webhooks and macOS launchd watches events, so you can wire a Lambda hook that pages on-call only when the failure correlates with an active Apple System Status event in the same region and service.

Solution-focused remediation path

If quotas are suspect, the Apple Business Manager Settings > Manage Devices console shows current usage and the active limit side by side. Request increases through Apple Business Manager Settings > Manage Devices, not through Support tickets - quota dashboard requests usually approve faster (often within minutes for soft limits) and they are auditable in Jamf Pro change management log and Apple Business Manager audit log. Set up Apple Business Manager Settings > Manage Devices + Jamf Pro Smart Group + Webhooks at 80 percent usage so you get notified before you hit the wall.

When the failure happens in production but not in dev, do not just compare the IAM policy. Compare the Org Policy / RCP at the OU level, the permission boundary on the role, and the resource-based policy on the target. One of those is almost always different between accounts. Policy Intelligence recommendations bundles make this comparison routine.

For IAM and STS issues, the timing matters. STS sessions can take up to 60 seconds to propagate after creation. The first call right after assume-role can fail with a permission error even when the policy is correct. Add a small retry with backoff before treating the first failure as definitive.

Automate this fix so you do not do it twice

Automate the fix in Terminal with defaults, plistbuddy, and system_profiler

On macOS, the most reliable repair primitives are the built-in Terminal tools. defaults read reveals the current preference state, defaults write changes it, and killall cfprefsd forces the preferences daemon to flush so the new value actually takes effect. /usr/libexec/PlistBuddy handles structured plist edits when defaults is not enough. For hardware and inventory checks, system_profiler with the right datatype is the canonical read; for example SPHardwareDataType, SPNetworkDataType, or SPInstallHistoryDataType.

# Template - replace with your actual key path
defaults read com.apple.jamf 2>/dev/null | head
sudo killall cfprefsd
/usr/libexec/PlistBuddy -c 'Print' ~/Library/Preferences/com.apple.jamf.plist
system_profiler SPHardwareDataType -json | head -40

Wire the fix into an MDM Configuration Profile for self-healing

If the underlying cause is a setting that drifts over time, do not script the fix repeatedly - bake it into a Configuration Profile that the MDM pushes down on every check-in. A Custom Settings payload writes to a specific preference domain; Jamf Pro, Kandji, Mosyle, and Intune all support this. The profile reasserts itself, so even if a user changes the setting locally, the MDM brings it back at the next sync (typically every 4 hours).

<!-- Custom Settings payload (excerpt) -->
<key>PayloadType</key>
<string>com.apple.ManagedClient.preferences</string>
<key>PayloadContent</key>
<dict> <key>com.apple.jamf</key> <dict><key>Forced</key><array><dict><key>mcx_preference_settings</key> <dict><key>HardenedSetting</key><true/></dict></dict></array></dict>
</dict>

Codify the fix as a Shortcut on iPhone, iPad, or Mac

For workflows that happen on the user device rather than at the MDM layer (think: clear a stuck cache, toggle a setting, file a one-tap support ticket), Apple Shortcuts is the right place. Shortcuts run on iOS, iPadOS, macOS, and watchOS, can be triggered by NFC tag, focus mode, time of day, or Siri voice. Share via iCloud link so support sends the same one-tap fix to anyone who hits the issue.

Pitfalls

The pitfall most teams hit on Jamf Pro is moving too fast and skipping the read-only validation step. Before any write, list the current state and save it. Apple iCloud and APNs are eventually consistent (changes can take 1-15 minutes to propagate) for many resource types, so the validation snapshot is your only reliable reference if you need to undo. Save the output of the describe call to S3, not to your laptop.

Second pitfall: confusing IAM permission errors with networking errors. AccessDenied can be IAM (policy missing), networking (VPC endpoint policy blocking the call), or KMS (key policy missing). The error string looks identical for all three. Distinguish by looking at the Jamf Pro change management entry or Apple Business Manager audit event's errorCode and the encoded authorization message; do not assume IAM is the culprit just because the message says AccessDenied.

Full fix path

• Watch for 24 to 48 hours. Activity Monitor + macOS unified logging + Jamf inventory reports can mask issues with cached health for 6 to 12 hours, especially Cloud CDN and Cloud DNS.
• Capture the new state in a runbook so the next person on call does not have to rediscover this. Push it to Confluence or your team wiki, not into Slack.

Safety, rollback, blast radius

• Test in a non-production account if your environment has Resource Manager and Organization Policy or Cloud Resource Manager (organizations, folders, projects). The cost of one sandbox account is cheaper than one rollback meeting.
• Export the existing config before changing it. Most Jamf Pro resources support describe + export to JSON via CLI - capture that to source control before you start.
• Maintenance window discipline: if the change touches DNS, certificate rotation, or anything that emits TLS handshakes, line up a window with stakeholder notification, not a heroic mid-day swap.

FAQ

Related fixes

Related guides worth a look while you sort this one out:

• Classic API token expires every 20 minutes keep-alive endpoint
• ADE token expired download new token from ABM
• Jamf Pro API 429 rate limit 5 concurrent connection guidance
• Siri new Apple Intelligence personality rollback to classic
• Google Workspace OAuth refresh token revoked
• Jamf Connect Sync agent loops on token refresh