Skip to main content

Checking Apple Profile Compatibility (16.4+)

What

FileWave Central 16.4 adds profile compatibility information for Apple profiles. It uses Apple’s published device-management definitions to show which platforms, operating-system versions, and enrollment types support each payload and setting before you deploy the profile.

Version boundary: The Compatibility view and checker described here require FileWave Central and FileWave Server 16.4 or later.

When/Why

Check compatibility while planning or reviewing a profile that will target different Apple platforms, operating-system versions, or enrollment methods. The results can expose requirements that are easy to miss in the payload editor, including settings that require Automated Device Enrollment (ADE), supervision, User Approved MDM, or a newer operating system.

Compatibility data is planning guidance, not deployment proof. The results are based on Apple’s official profile definitions and do not replace a pilot deployment on representative devices.

How

Open compatibility information for a profile

  1. In FileWave Central, create or open an Apple profile.
  2. Open the profile properties and select Compatibility.
  3. Review the operating systems and enrollment types reported for the profile’s payloads and settings.

Check a target combination

  1. Select the Apple Platform you intend to manage.
  2. Enter the target operating-system Version.
  3. Select the applicable Enrollment Type.
  4. Select Check.
  5. Review the result for every payload and setting in the profile.

Run the check again for each materially different device group. A profile that is compatible with a supervised Mac enrolled through ADE may not have the same result for an iPhone, iPad, Apple Vision Pro, or a device enrolled through another method.

Interpret the results

Result or requirementWhat to do
Supported for the selected platform, version, and enrollment typeContinue with a pilot deployment. Compatibility does not confirm that certificates, identifiers, dependencies, or service-side configuration are correct.
Requires ADE, supervision, or User Approved MDMConfirm that every target device meets that enrollment requirement. Split the deployment when the target group contains mixed enrollment types.
Introduced in a newer operating systemRaise the target OS requirement or avoid that setting for older devices. Do not assume older systems will enforce an unknown key.
Removed or unavailable on the selected platformRemove the incompatible setting or build a separate profile for the affected platform or OS range.
Compatibility information unknownReopen the profile and retry the check while Central has a working Server connection. If the result remains unknown, use Apple’s published definition for that payload and contact FileWave Support before relying on the result.

FileWave 17: review OS 27 network Profile warnings

FileWave 17.0 updates compatibility metadata for Apple OS 27. The base Compatibility view still requires Central and Server 16.4 or later; use the FileWave 17 generation when reviewing these OS 27 changes.

For iOS/iPadOS 27, macOS 27 and visionOS 27, the network Profile payloads com.apple.dnsProxy.managed (DNS Proxy), com.apple.dnsSettings.managed (DNS Settings) and com.apple.relay.managed (Relay) are marked deprecated. Review the result for the actual platform, OS version and enrollment type selected in the checker.

Deprecated is different from removed. A deprecation warning is a reason to plan the appropriate replacement, not an instruction to delete a working network Profile immediately. Review individual settings too: a payload-level warning does not mean every key has the same availability.

See DDM Configurations for FileWave 17 DNS and relay planning. Check the replacement declaration's own requirements and service dependencies rather than assuming Profile-to-DDM equivalence. Preserve management connectivity during a transition, and verify actual DNS or relay behavior in addition to compatibility and declaration status.

FileWave 17: Login Window Wi-Fi settings for macOS 27

In FileWave Central 17.0, configure these macOS 27 options in the Apple Profile editor's Login Window payload, not Restrictions (macOS):

Login Window settingProfile key
Enable captive WiFi portal for login and unlockForceCaptivePortalConnectionFromLockScreen
Enable WiFi network selection for login and unlockForceWifiConfigurationOnLockScreen

These keys belong to com.apple.loginwindow, not com.apple.applicationaccess. When reviewing a profile prepared against earlier OS 27 definitions, check the payload containing each key rather than relying on its name alone. Review the actual profile before changing it; a compatibility result is not an automatic migration of an existing saved profile.

After authoring the intended Login Window settings, check compatibility for the target macOS version and enrollment type. Verify the intended login or unlock behavior on representative Macs before broad rollout; a successful editor save or export does not establish that the device has applied the settings.

Plan for mixed Apple fleets

  • Check each platform and OS range that the Deployment will actually target.
  • Use separate profiles when the required settings or enrollment conditions differ materially.
  • Keep deployment targets aligned with the profile’s compatible platforms instead of relying on devices to ignore unsupported settings.
  • Test on representative hardware and enrollment types before broad rollout.
  • Recheck compatibility after adding payloads or changing individual settings.

Compatibility data source

FileWave evaluates the profile against Apple’s published device-management profile definitions. Apple can revise those definitions as platforms evolve, so use the current FileWave maintenance release and verify important deployment decisions against Apple’s current documentation.