Autenticación
La API de Nomid MDM usa claves API para autenticar solicitudes. Esta guía explica cómo obtener y usar tu clave API.
Descripción General
Las claves API se usan para autenticar todas las solicitudes a la API de Nomid MDM. Incluye tu clave API en el encabezado X-API-Key con cada solicitud.
X-API-Key: nm_acme_a1b2c3d4e5f6g7h8i9j0...Obtener Tu Clave API
Las claves API se crean y gestionan a través del Portal de Nomid. Sigue estos pasos para crear tu primera clave API.
Requisitos Previos
- Una cuenta de Nomid MDM con acceso de administrador
- Acceso a la Configuración de la Empresa en el Portal de Nomid
Inicia Sesión en el Portal de Nomid
Abre tu navegador y accede al Portal de Nomid. Inicia sesión con tus credenciales de administrador.
portal.nomid.techNavega a Integraciones
Una vez dentro, ve a la sección Configuración de la Empresa y selecciona la pestaña Integraciones.
Haz Clic en Crear Clave API
Haz clic en el botón "Crear Clave API" ubicado en la esquina superior derecha de la página de Integraciones.
Ingresa un Nombre
En el modal que aparece, ingresa un nombre descriptivo para tu clave API. Esto te ayuda a identificar la clave después (ej.: "Integración Power BI" o "Sincronización CRM").
Copia Tu Clave
Después de hacer clic en Crear, tu clave API será mostrada. Haz clic en el botón copiar para copiarla al portapapeles. ¡La clave solo se mostrará una vez!
Importante: Guarda Tu Clave
Tu clave API solo se mostrará una vez en el momento de la creación. Cópiala inmediatamente y guárdala de forma segura (ej.: en un gestor de contraseñas o variable de entorno). Si pierdes la clave, necesitarás crear una nueva.
Formato de Clave API
Las claves API siguen este formato:
nm_- Todas las claves comienzan con 'nm_'{company}- Prefijo específico de la empresa para identificación{random}- 32 caracteres aleatorios para seguridad
Usando Tu Clave API
Incluye la clave API en el encabezado X-API-Key con cada solicitud:
curl -X GET "https://api.nomid.tech/emm/api/v1/assets" \
-H "X-API-Key: nm_acme_a1b2c3d4e5f6..."Permisos
Las claves API pueden configurarse con permisos específicos:
| Permission | Description |
|---|---|
| DEVICES_READ | Leer información de dispositivos |
| POLICIES_READ | Leer información de políticas |
| EXPORT_READ | Exportar datos |
Mejores Prácticas de Seguridad
Nunca expongas claves API en código del lado del cliente o repositorios públicos
Rota las claves regularmente y revoca las claves no utilizadas
Almacena las claves en variables de entorno, no en el código
Usa los permisos mínimos necesarios para tu integración
Revocando Claves API
Si sospechas que tu clave API ha sido comprometida o ya no es necesaria, puedes revocarla inmediatamente desde la página Configuración de la Empresa > Integraciones en el Portal de Nomid. Las claves revocadas no pueden ser restauradas.