简介
给设备发个指令操作的第一步不是由MDM Server直接向APNs推送指令的,但是由Server向APNs发送一个特定的指令来好比唤醒设备,设备被唤醒之后会根据已安装的配置文件的ServerURL 的地址主动发起请求,报告自己的当前状态,只有其状态值为
Idle
设备才会接收Server指令操作。
如图所示:
所以完成一次指令推送经历以下过程:
- 1、server 与APNs建立连接,发送数据。
- 2、当设备收到APNs推送消息时,主动连接server报告本身的状态空闲
- 3、server收到设备发来的状态信息,发出操作命令
- 4、设备收到命令执行,并返回数据
- 5、server响应,此次查询完成,连接关闭。
以下以设备信息查询指令DeviceInformation
为例进一步分析每个过程。
查询设备信息的指令操作过程
- MDM Server 与 APNs建立连接,发送一个固定的指令,内容如下。
token=8c20addf006e09842376d9066fda4147800bc98755eb0430027a1a2f94442418
payload=
{
"aps":
{
"sound":"default.caf"
},
"mdm":"EC0B1F96-5160-424C-A9DE-754A454E424B"
}
在这里需要我们前面得到的p12格式的证书,形式上和APP的差不多。其中token就是在TokenUpdate
时的token,mdm是其中 的PushMagic
,这个值是每次推送时都必须有的。所以根据内容看出Sever与APNs推送的消息基本固定,不同于APP的消息推送。发送这个消息主要目的就是通知设备,MDM Server要给你发指令了,赶快去连接服务器。
- 当设备收到APNs推送消息主动连接Server
收到有APNs发来的消息,发起请求到通过配置文件的服务器URL(即ServerURL
字段的值)。向Server报告自己的当前状态是否空闲。
Status
Idle
UDID
233deb277d03bd4aaf91108390c7d*
以上可以看出每次请求或应答都会有UDID来标记设备,Status
的值表示设备当前状态。状态值有以下几种状态:
Status value | Description |
---|---|
Acknowledged | 一切正常,设备正确响应指令 |
Error | 出现错误 |
CommandFormatError | 指令格式错误 |
Idle | 设备空闲 |
NotNow | 设备收到指令,但不能马上执行以后会再次请求服务器 |
正常情况下大多数出现的是Acknowledged
和Idle
两种状态。
- Server收到设备发来的状态信息
收到设备状态信息,判断是否空闲,只有空闲的时候再去发送指令。发送查询设备信息指令:
Command
RequestType
DeviceInformation
Queries
ModelName
Model
BatteryLevel
DeviceCapacity
AvailableDeviceCapacity
OSVersion
SerialNumber
IMEI
ICCID
MEID
IsSupervised
IsDeviceLocatorServiceEnabled
IsActivationLockEnabled
IsCloudBackupEnabled
WiFiMAC
BluetoothMAC
CommandUUID
f04997b8-aae2-44de-8c8d-8fb838000d0c
Server发送一个命令操作时必定包含Command
和 CommandUUID
Command
必须有RequestType
表示具体的命令操作 + 该命令相关的操作参数。以上命令用来查询设备信息,Queries
数组中表示要查询的内容的key。
CommandUUID
表示命令的ID,当设备响应命令操作时,Sever可以此来确定是哪个命令操作,然后做相应的数据处理。
- 设备收到命令执行,根据指定的key返回相应的数据
CommandUUID
f04997b8-aae2-44de-8c8d-8fb838000d0c
QueryResponses
AvailableDeviceCapacity
19.606937408447266
BatteryLevel
0.56000000238418579
BluetoothMAC
6c:70:9f:2b:46:72
DeviceCapacity
26.413677215576172
ICCID
8986 0113 7231 0048 6168
IMEI
35 884805 093285 4
IsActivationLockEnabled
IsCloudBackupEnabled
IsDeviceLocatorServiceEnabled
IsSupervised
MEID
35884805093285
Model
ME824CH
ModelName
iPad
OSVersion
9.2.1
SerialNumber
F4KMG0FSFLMM
WiFiMAC
6c:70:9f:2b:46:71
Status
Acknowledged
UDID
233deb277d03bd4aaf91108390c7d9fe2c49c8be
- server响应,若还需操作继续发送指令,否则返回为空此次操作完成,断开连接。
HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
Content-Length: 0
Date: Wed, 26 Apr 2017 07:34:00 GMT
其他操作命令
- 查询设备已安装的应用
Command
RequestType
InstalledApplicationList
CommandUUID
149e4fd2-0267-4da2-9b58-bf94282dcdb4
- 设备锁屏命令
Command
RequestType
DeviceLock
CommandUUID
07a6c20e-5e35-4f79-8680-10dee8460099
- 清除密码命令
Command
RequestType
ClearPasscode
UnlockToken
// base64编码的字符串(在TokenUpdate中获取的UnlockToken字段的值)
CommandUUID
命令的请求和响应格式
- 命令请求格式
Command
RequestType
命令名字
...其他字段或参数(可选),根据不同的命令会有不同的附加的key
CommandUUID
- 命令响应格式
CommandUUID
CommandUUID
Status
Acknowledged
UDID
[device UUID]
由设备发起的请求或响应操作基本是固定的,我们唯一能够操作的也只有Sever端的请求和响应了。
参考:
1、MDM协议官方文档- Mobile Device Management Protocol Reference https://developer.apple.com/library/content/documentation/Miscellaneous/Reference/MobileDeviceManagementProtocolRef/3-MDM_Protocol/MDM_Protocol.html#//apple_ref/doc/uid/TP40017387-CH3-SW2
2、配置描述文件参考- Configuration Profile Referencehttps://developer.apple.com/library/content/featuredarticles/iPhoneConfigurationProfileRef/Introduction/Introduction.html#//apple_ref/doc/uid/TP40010206-CH1-SW1