Skip to content
This repository has been archived by the owner on Mar 11, 2021. It is now read-only.

micromdm/command

Repository files navigation

Build Status GoDoc

The command service accepts command requests and creates MDM Payloads which can be processed by the device. The command service does not communicate with devices directly. Instead it serializes the payload and sends it on a message queue for other services to consume.

The Command Service can be deployed as both a library and a standalone service.

The current implementation of the command service uses BoltDB to archive events and NSQ as the message queue, both of which can be embeded in a larger standalone program.

Architecture Diagram

mdm commandservice

Example request/response:

POST /v1/commands HTTP/1.1
Content-Type: application/json; charset=utf-8
Host: localhost:8080
Connection: close
User-Agent: Paw/3.0.9 (Macintosh; OS X/10.11.6) GCDHTTPRequest
Content-Length: 188

{
    "request_type":"InstallApplication",
    "udid":"184012D9-753A-5DFC-8149-5C9AF257629F",
    "manifest_url":"https://mdm.example.com/repo/manifests/munkitools-2.5.1.2637.plist",
    "management_flags":1
}



HTTP/1.1 201 Created
Date: Wed, 30 Nov 2016 01:21:33 GMT
Content-Length: 290
Content-Type: text/plain; charset=utf-8
Connection: close

{
  "payload": {
    "CommandUUID": "a00258bc-b1d5-4c7e-addb-9c2215eb9c0f",
    "Command": {
      "request_type": "InstallApplication",
      "manifest_url": "https://mdm.example.com/repo/manifests/munkitools-2.5.1.2637.plist",
      "management_flags": 1,
      "options": {}
    }
  }
}

Example mdm Payload plist stored in the Event:

<?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>ManagementFlags</key>
      <integer>1</integer>
      <key>ManifestURL</key>
      <string>https://mdm.example.com/repo/manifests/munkitools-2.5.1.2637.plist</string>
      <key>Options</key>
      <dict></dict>
      <key>RequestType</key>
      <string>InstallApplication</string>
    </dict>
    <key>CommandUUID</key>
    <string>a00258bc-b1d5-4c7e-addb-9c2215eb9c0f</string>
  </dict>
</plist>

About

MDM Command service/library

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published