Autenticación

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_a1b2c3d4e5f6...

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

1. 1

   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.

2. 2

   Navega a Integraciones

   Una vez dentro, ve a la sección Configuración de la Empresa y selecciona la pestaña Integraciones.

3. 3

   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.

4. 4

   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").

5. 5

   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!

Formato de Clave API

Las claves API siguen este formato:

nm_{company}_{random_32_chars}

• Todas las claves comienzan con 'nm_'
• Prefijo específico de la empresa para identificación
• 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..."

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

Errores de Autenticación

La API devuelve códigos de error específicos para problemas de autenticación: