Guía de interfaz de programación de aplicaciones (API) de Intel® Endpoint Management Assistant (Intel® EMA)

La Guía de API de Intel® EMA proporciona un esquema para los administradores y desarrolladores de TI sobre la Intel® Endpoint Management Assistant (Intel® EMA) Interfaz de programación de aplicaciones (API).

El documento PDF proporciona a los desarrolladores información general sobre la Intel® EMA la interfaz de programación de aplicaciones (API). La información detallada sobre los URI de API individuales (como descripciones y parámetros) se encuentra en los dos archivos HTML siguientes. Latestswagger.html contiene las rutas de la API que siempre apuntan a la última versión de la API publicada. Además, también se proporciona el archivo de detalles de URI de API versión 9, V9swagger.html. Para ver esta información detallada del URI de la API, descargue el archivo HTML deseado y ábralo en un navegador (Chrome funciona mejor).

Detalles adicionales de la API de Intel EMA:
La API Intel® Endpoint Management Assistant (Intel® EMA) es un conjunto de interfaces programáticas diseñadas para permitir que los desarrolladores y administradores de TI interactúen con Intel® EMA. Esta API facilita la administración y el monitoreo de dispositivos de punto final, automatiza las tareas administrativas e integra Intel® EMA capacidades en otras soluciones de software.

Entorno requerido:
Intel® EMA servidor debe estar instalado y en ejecución.
Se requieren los permisos de acceso a la API y credenciales adecuados.

Características y capacidades clave:

Administración de dispositivos:
Administre y supervise dispositivos de punto final de forma remota.
Automatización: automatice tareas administrativas como actualizaciones de software, reinicios de dispositivos y cambios de configuración.
Integración: Integre funcionalidades Intel® EMA en otras soluciones de software y flujos de trabajo.
Seguridad: administre dispositivos de forma segura con mecanismos de autenticación y autorización.

Casos de uso:
Aprovisionamiento automatizado de dispositivos: aprovisione y configure automáticamente nuevos dispositivos.
Solución remota de problemas: diagnostique y resuelva problemas de forma remota en dispositivos de endpoint.
Implementación de software: automatice la implementación de actualizaciones y parches de software.
Supervisión del cumplimiento: asegúrese de que los dispositivos cumplan con los estándares y las políticas de la organización.

Empezar:

Requisitos de software:
Intel® EMA servidor debe estar instalado y en ejecución.
Permisos de acceso: Se requieren los permisos de acceso a la API y credenciales adecuados. Estos permisos se describen en detalle en el archivo JSON de Swagger.
API Key Generation: genera una clave de API desde la consola Intel® EMA.
Configuración: configure los ajustes de red y asegúrese de que el servidor Intel® EMA sea accesible.

Autenticación y seguridad:

Autenticación de token:
Utiliza un nombre de usuario y una contraseña asociada para una cuenta de servidor Intel® EMA servidor.
Autenticación de Active Directory: usa credenciales de Active Directory. Solo se puede usar cuando Intel® EMA instala con el modo de autenticación de dominio de Windows* y el servidor Intel® EMA está unido a un dominio de Active Directory.
Autenticación de credenciales de cliente: diseñadas para el acceso de la API al servidor Intel® EMA. Debe crear una cuenta de credenciales de cliente y un secreto de cliente en el servidor del servidor Intel® EMA.
Autenticación Microsoft* Entra: Introducida en la Intel® EMA 1.9.0, permite la autenticación para la interfaz web Intel® EMA mediante Azure Active Directory, conocido como Microsoft Entra.

Mejores prácticas de seguridad:
Usar HTTPS: Utilice siempre HTTPS para cifrar los datos en tránsito.
Privilegios mínimos: otorgue los permisos mínimos necesarios a los usuarios de la API.
Hash de contraseña: No almacene contraseñas en archivos de texto claro.

Manejo y resolución de problemas de errores:

Códigos de error comunes:
400 Bad Request: parámetros de entrada no válidos.
401 Unauthorized: credenciales de autenticación no válidas o faltantes.
404 Not Found: recurso no encontrado.
Error 500 Internal Server: el servidor se encontró con una condición inesperada.

Consejos para solucionar problemas:
Check API Key: Asegúrese de que la clave de API sea válida y tenga los permisos necesarios.
Validar entrada: compruebe que los parámetros de entrada sean correctos y tengan el formato adecuado.
Problemas de red: Asegúrese de que no haya problemas de conectividad de red entre el cliente y el servidor Intel® EMA.