Customizing Apple SCEP Template

Organization (O) field

By default, the issued certificate includes the Organization (O) field as O = BigFix . You can customize or remove this field in the Apple SCEP Template if required by your organization’s security or compliance policies. To do that, in the default Apple SCEP custom template, locate the following section:
<array>
  <array>
    <string>O</string>
    <string>BigFix</string>
  </array>
</array>
You can choose one of the following supported configurations:
Option 1: Use the Organization name defined during MDM server installation
<string>${ORGANIZATION}</string>
This automatically inserts the organization name configured during MDM server setup.
Option 2: Specify a custom organization name
<string>Example Corporation</string>

This inserts the specified organization name into the certificate.

Option 3: Remove the Organization field
You can remove the entire section if you do not want the Organization attribute included in the certificate subject.

RSA Key Length

By default, the SCEP profile requests a 2048-bit RSA key:
<key>Keysize</key>
<integer>2048</integer>
You can change this value to request a 4096-bit RSA key if required by your security policy:
<key>Keysize</key>
<integer>4096</integer>
Compatibility Considerations
Using a 4096-bit key increases cryptographic strength but may exclude older operating systems.
  • 2048-bit (default):
    • Compatible with all supported iOS and macOS versions.
    • Recommended for mixed or legacy environments.
  • 4096-bit (optional):
    • More secure.
    • Requires:
      • iOS 13 or later
      • macOS 14 (Sonoma) or later
    • Devices running earlier OS versions may fail certificate enrollment.

Troubleshooting

Symptom Possible Cause Recommended Action
Certificate is not issued Incorrect SCEP challenge password Verify the challenge password configured in the SCEP profile matches the SCEP server configuration.
Certificate enrollment fails SCEP server URL is unreachable Confirm the SCEP URL is correct and accessible from the device network.
Profile installs, but no certificate appears OS does not support selected key size If using 4096-bit keys, verify the device runs a supported OS version. Otherwise, revert to 2048-bit keys.
Organization (O) field still shows default value Profile was not updated or redeployed Ensure the raw profile was saved and the updated profile was redeployed to the device.
Organization field is missing unexpectedly Organization section was removed Re-add the Organization (O) block if the field is required in the certificate subject.
Authentication fails after certificate install Incorrect user identity in certificate (CN or SAN) Verify the User Principal Name value resolves correctly for the user and matches backend authentication requirements.
Certificate request retries repeatedly Temporary connectivity issue or server timeout Check network connectivity to the SCEP server and review server logs for request failures.
Some devices enroll successfully, others fail Mixed OS versions with unsupported key size Use 2048-bit keys for environments with older devices or split profiles by OS group.
Certificate subject does not reflect recent changes Old certificate still in use Remove the existing certificate and redeploy the updated profile to force re-enrollment.