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>
- 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.
- 2048-bit (default):
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. |