Workspace ONE API Custom Commands y Postman
Por George Gonzalez
- Lectura en 2 minutos - 364 palabrasAl utilizar Workspace ONE para la gestión moderna de dispositivos macOS, la mayor parte del tiempo me la paso usando el interfaz web. Pero de vez en cuando tiene sentido ir directamente al API.
Se puede utilizar cualesquier método, desde PowerShell en Windows hasta la linea de comando en macOS. Pero para este ejemplo utilizaré Postman , pueden ver este otro articulo para ver otras de mis herramientas favoritas.
En este articulo no voy a cubrir el proceso de bajar, instalar y configurar Postman o crear las cuentas y permisos necesarios en su instancia de WS1. Hay muy buenos blogs de otros colegas sobre ese tema y compartiré un vinculo a ellos al final de esta pagina.
Estas instrucciones asumen que ya tienen su entorno configurado y Postman tiene los parámetros correctos como el Tenant Code y credenciales de API. Ademas que los derechos de la cuenta de API están correctos.
Cuando todo esto esta en orden y puede enviar llamadas de API y recibir respuestas de su Consola de Workspace ONE entonces podemos continuar probando Custom Commands. En este caso, enviaremos un comando a un dispositivo mac enrolado en DEP para que instale una actualización.
El cuerpo de la llamada debe verse así, claro, cambiaria Product Key, Version, Deferrals y otros detalles según necesite.
El tipo de llamada API es POST:
https://servername.awmdm.com/AP1/mdm/devices/DEVICEIDGOESHERE/commands?command=CustomMdmCommand
El cuerpo debe ser raw y JSON
Los Headers deben parecerse a este, recordando cambiar el Content-Type a application/json
Si el comando fue recibido con éxito verá un mensaje de “202 Accepted”
Cuando el comando es recibido puede revisar bajo “Troubleshooting” o “Commands” en la consola de UEM para el Device ID utilizado.
Al abrir el “Event Data” verá mas detalles sobre el comando recibido.
Cuando el comando de MDM es procesado en el dispositivo del cliente, este presentará un mensaje para actualizar el sistema.
¡Y eso es todo lo que hay que hacer!
En caso de que necesite enviar el mismo comando a un grupo de dispositivos, puede entonces convertir el DEVICEID en la llamada POST a un variable y entonces usar la opción de colección de Postman.
Referencias:
Using Postman to Execute REST API calls