Web Service Endpoint

Security Information

Get security-related information about the device.

URL

PUT https://yourmdmhost.example.com/mdm

HTTP Body

Response Codes

OK

Discussion

Query Availability

Device Channel

iOS, macOS, Shared iPad, tvOS

User Channel

-

Requires Supervision

-

Allowed in User Enrollment

iOS, macOS

Required Access Right

AllowQuerySecurity

Example Request and Response

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict> <key>Command</key> <dict> <key>RequestType</key> <string>SecurityInfo</string> </dict> <key>CommandUUID</key> <string>0001_SecurityInfo</string></dict></plist>
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict> <key>CommandUUID</key> <string>0011_SecurityInfo</string> <key>SecurityInfo</key> <dict> <key>HardwareEncryptionCaps</key> <integer>3</integer> <key>ManagementStatus</key> <dict> <key>IsUserEnrollment</key> <false/> </dict> <key>PasscodeCompliant</key> <true/> <key>PasscodeCompliantWithProfiles</key> <true/> <key>PasscodeLockGracePeriod</key> <integer>0</integer> <key>PasscodeLockGracePeriodEnforced</key> <integer>0</integer> <key>PasscodePresent</key> <false/> </dict> <key>Status</key> <string>Acknowledged</string> <key>UDID</key> <string>00008020-000915083C80012E</string></dict></plist>

Topics

Command and Response

object SecurityInfoCommand

The wrapper for the Security Info command.

object SecurityInfoCommand.Command

The object for the Security Info command.

object SecurityInfoResponse

The wrapper object for the Security Info response.

object SecurityInfoResponse.SecurityInfo

The response object for the security info command.

object SecurityInfoResponse.SecurityInfo.FirewallSettings

The response object for firewall settings.

object SecurityInfoResponse.SecurityInfo.FirewallSettings.ApplicationsItem

The response object for applications within the firewall settings.

object SecurityInfoResponse.SecurityInfo.FirmwarePasswordStatus

The response object for the firmware password status.

object SecurityInfoResponse.SecurityInfo.ManagementStatus

The response object for the MDM status.

object SecurityInfoResponse.SecurityInfo.SecureBoot

The response object for the secure boot settings.

See Also

Security

List the Certificates

Get a list of installed certificates.

Get the Bypass Code for Activation Lock

Get the code you use to bypass activation lock.

Clear the Bypass Code for Activation Lock

Clear the activation lock bypass code from the device.

Rotate the FileVault Key

Reset the FileVault password periodically to mitigate the security risk of deployed devices.