libdmclient An Open Source implementation of OMA-DM David Navarro - PowerPoint PPT Presentation

libdmclient An Open Source implementation of OMA-DM David Navarro FOSDEM 2013

What is Device Management ? • Technologies which allow authorized third-parties to remotely perform management operations on an end-user device. • Use cases are: • • Applications settings provisioning Device capabilities access • Connectivity management control (e.g. disable camera) • • Software and Firmware update Diagnostic and monitoring • • and more… Device lock and wipe • OMA-DM is the device management standard in the mobile phone industry. 2

OMA-DM Presentation • Defined by the Open Mobile Alliance • Current version is 1.2. Version 1.3 is finalized. • Client-Server protocol. • Mutual authentication. • Exchange of SyncML packets over http(s) 3

OMA-DM Protocol Overview • Server sends SyncML commands on device’s standardized node URIs. (e.g. ./DevInfo/DevId or ./LAWMO/Operations/PartiallyLock) • Commands are GET, ADD, REPLACE, DELETE and EXEC. • The nodes collection is called the DM tree. • Access Control List 4

Example: Changing the Browser HomePage 1/3 . BMO HomePage Name Orange URL http://www.orange.co.uk Favorites 1 Name Home | libdmclient https://01.org/libdmclient URL … 5

Example: Changing the Browser HomePage 2/3 . . . <Replace> <CmdID>4</CmdID> <Item> <Target> . . <LocURI>./BMO/HomePage/URL</LocURI> . </Target> < Status> <Data>https://www.orange.fr</Data> <CmdRef>4</CmdRef> </Item> <Cmd>Replace</Cmd> </Replace> <Data>200</Data> . </Status> . . . . . 6

Example: Changing the Browser HomePage 3/3 . BMO HomePage Name Orange URL https://www.orange.fr Favorites 1 Name Home | libdmclient https://01.org/libdmclient URL … 7

OMA-DM Management Objects • Nodes are grouped in Management Objects. • Each MO is an interface for a functionality. • Three MOs are mandatory: • DevInfo • DevDetail • DmAcc 8

OMA DM Session Overview User DM Client Push Server DM Server Package 0: Push message Package 1: client initialization with credentials and device information Package 2: server initialization with credentials and initial DM commands Package 3: client response to server commands Dialog User’s input Package n: more DM commands Package n+1: client response to server commands 9

Introducing libdmclient • Implementation of the client-side of OMA-DM 1.2 • Encodes and decodes OMA-DM packets. • Dispatchs DM commands to plugins. https://01.org/libdmclient 10

Characteristics • Designed for Linux • Written in C • Single threaded • No file system access • Dependencies: • libxml2 • libwbxml 11

libdmclient Usage Overview The application takes care of: • communication with the DM server • Application reception of the push notification • libdmclient User Interface Plugin Plugin Plugin 12

Usage Flow Push DM Server Server Messaging Application libdmclient http notification Push notification session_init() Session pointer session_start() get_next_packet() DM packet DM packet DM packet DM packet DM packet process_reply() session_close() 13

libdmclient Plugins • Handle operations on a subpart of the DM tree. . DevInfo DevId Man Mod … DevDetail DmAcc Vendor Intel 14

libdmclient Plugins • Defined by a base URI and typedef struct { several callbacks. char * base_uri; omadm_mo_init_fn initFunc; • Loading mechanisms: omadm_mo_close_fn closeFunc; • omadm_mo_is_node_fn isNodeFunc; API omadm_mo_find_urn_fn findURNFunc; • shared libraries omadm_mo_get_fn getFunc; omadm_mo_set_fn setFunc; omadm_mo_get_ACL_fn getACLFunc; omadm_mo_set_ACL_fn setACLFunc; omadm_mo_rename_fn renameFunc; omadm_mo_delete_fn deleteFunc; omadm_mo_exec_fn execFunc; } omadm_mo_interface_t; 15

libdmclient Plugins example ./Vendor/Intel DM server application libdmclient plugin omadmclient_process_reply DM packet GET ./Vendor/Intel/version isNodeFunc getACLFunc permission check getFunc store result omadmclient_get_next_packet compose reply DM packet 16

Component View libdmclient application omadmclient dmtree momgr plugins package0 callbacks credentials SyncML RTK libmd5-rfc libxml2 libwbxml 17

Session Data Structure • In memory • Opaque pointer used in APIs session • Contains all required data • state variables • plugins tree • list of reply elements • SyncML RTK handle 18

omadmclient_process_reply ./Vendor/Intel session omadmclient SyncML RTK momgr callbacks dmtree plugin DM packet DM packet decoding get callback get check URI find plugin isNodeFunc getACLFunc check ACL getFunc result compose store result 19

omadmclient_get_next_packet session omadmclient SyncML RTK start message get element add element end message get server URL DM packet 20

omadmclient_session_start_on alert omadmclient dmtree package0 credentials momgr DMAcc session plugin payload payload decoding server ID set server ID check ID store ID get server account get plugin get node values account details store account set state to STATE_SERVER_INIT 21

Current Status • IOP with Funambol DM server • Support of GET, ADD, REPLACE and DELETE • test material includes: • command-line application • hard-coded DevDetail, DevInfo and DMAcc • storage plugins (in memory and SQLite) 22

TODOs • • Support OMA-DM 1.3 Yocto integration • EXEC support • Plugin management rework • Bootstrapping • SyncML RTK strip https://01.org/libdmclient • Logs 23