LOM payload example configuration and command issuance
The MDM installs a Device and Controller configuration (LightsOutManagementLOM) on each Mac respectively.
This payload establishes Device and Controller trust using the CAs of each being installed on the other.
This payload establishes the Mac computer’s identity as Device, Controller, or both using the certificate UUID referenced by
ControllerCertificateUUIDandDeviceCertificateUUIDwithin thecom.apple.lompayload. These referenced certificate payloads can be PKCS12 or SCEP.
The MDM issues a LOMSetupRequestCommand to the Mac acting as the Device.
The Mac acting as the Device responds with LOMSetupRequestResponse, which contains needed information for the issuance of LOM commands, such as
PrimaryIPv6AddressListandSecondaryIPv6AddressList.
The MDM issues a LOM Device Request Command to the Mac acting as the Controller.
This command contains the
DeviceDNSName, as configured in the client certificate payload. The command (PowerON,PowerOFForReset) and the IPv6 addresses to send to.The LOMDeviceRequestResponse then returns with
ResponseDataindicating success or error.
Example configuration construction utilising SCEP Payloads for device identity:
A Mac configured as a Controller
<key>PayloadContent</key><array> <dict> <key>ControllerCertificateUUID</key> <string>CA9BE302-3AD2-4E58-B16D-2520E06493CA</string> <key>DeviceCACertificateUUIDs</key> <array> <string>153517F0-D444-4DA9-9896-874E66BE89AE</string> </array> <key>PayloadDisplayName</key> <string>LOM Enrollment</string> <key>PayloadType</key> <string>com.apple.lom</string> <key>PayloadUUID</key> <string>DD64FC01-A2D2-4268-B892-33300F7205C3</string> </dict> <dict> ... <key>PayloadDisplayName</key> <string>Device CA Certificate</string> <key>PayloadType</key> <string>com.apple.security.pem</string> <key>PayloadUUID</key> <string>153517F0-D444-4DA9-9896-874E66BE89AE</string> </dict> <dict> ... <key>PayloadDisplayName</key> <string>Client Certificate</string> <key>PayloadType</key> <string>com.apple.security.scep</string> <key>PayloadUUID</key> <string>CA9BE302-3AD2-4E58-B16D-2520E06493CA</string> </dict></array>A Mac configured as a Device
<key>PayloadContent</key><array> <dict> <key>ControllerCACertificateUUIDs</key> <array> <string>153517F0-D444-4DA9-9896-874E66BE89AE</string> </array> <key>DeviceCertificateUUID</key> <string>CA9BE302-3AD2-4E58-B16D-2520E06493CA</string> <key>PayloadDisplayName</key> <string>LOM Enrollment</string> <key>PayloadType</key> <string>com.apple.lom</string> <key>PayloadUUID</key> <string>DD64FC01-A2D2-4268-B892-33300F7205C3</string> </dict> <dict> ... <key>PayloadDisplayName</key> <string>Controller CA Certificate</string> <key>PayloadType</key> <string>com.apple.security.pem</string> <key>PayloadUUID</key> <string>153517F0-D444-4DA9-9896-874E66BE89AE</string> </dict> <dict> ... <key>PayloadDisplayName</key> <string>Client Certificate</string> <key>PayloadType</key> <string>com.apple.security.scep</string> <key>PayloadUUID</key> <string>CA9BE302-3AD2-4E58-B16D-2520E06493CA</string> </dict></array>A Mac configured as a Controller and a Device
<key>PayloadContent</key><array> <dict> <key>ControllerCACertificateUUIDs</key> <array> <string>153517F0-D444-4DA9-9896-874E66BE89AE</string> </array> <key>DeviceCertificateUUID</key> <string>CA9BE302-3AD2-4E58-B16D-2520E06493CA</string> <key>ControllerCertificateUUID</key> <string>CA9BE302-3AD2-4E58-B16D-2520E06493CA</string> <key>DeviceCACertificateUUIDs</key> <array> <string>153517F0-D444-4DA9-9896-874E66BE89AE</string> </array> <key>PayloadDisplayName</key> <string>LOM Enrollment</string> <key>PayloadType</key> <string>com.apple.lom</string> <key>PayloadUUID</key> <string>DD64FC01-A2D2-4268-B892-33300F7205C3</string> </dict> <dict> ... <key>PayloadDisplayName</key> <string>Device and Controller CA Certificate</string> <key>PayloadType</key> <string>com.apple.security.pem</string> <key>PayloadUUID</key> <string>153517F0-D444-4DA9-9896-874E66BE89AE</string> </dict> <dict> ... <key>PayloadDisplayName</key> <string>Client Certificate</string> <key>PayloadType</key> <string>com.apple.security.scep</string> <key>PayloadUUID</key> <string>CA9BE302-3AD2-4E58-B16D-2520E06493CA</string> </dict></array>