Tablero conectando…
Actividad
Motivos de rechazo
Servicios
Devices
Tenants
El token viaja en el encabezado x-tenant-token y sólo abre lo suyo: sus servicios y los Devices que cuelgan de ellos. Se emite, rota y revoca únicamente desde aquí — un tenant no administra sus propias credenciales. Se guarda hasheado: el valor se ve una sola vez, al emitirlo.
Gates
Abrir y Cerrar mandan el relé a ON y a OFF y lo dejan ahí: un Gate abierto se queda abierto hasta que le des Cerrar. Pulso es lo que hará el validador de QR — abre y programa el cierre dentro del propio switch. Leer DP pregunta qué códigos acepta el dispositivo (necesitas countdown_1 para que ese cierre ocurra en el switch y no dependa de la nube).
Conexiones
Una conexión son las credenciales de una cuenta de switches: el Access ID, el Access Secret y la región. La región debe ser la misma donde se emparejaron los switches; con otra, las credenciales se aceptan pero el dispositivo "no existe" y ningún Gate abre.
Predeterminados
Claves de acceso
El validador manda la clave en el encabezado x-api-key. Genera una por validador: así puedes revocar uno sin tocar a los demás. Nunca uses aquí la contraseña de administrador.
Cambiar contraseña
Configuración
Leer lo que tiene ahora
Configuración predeterminada
Devices
Un servicio agrupa los Devices de un mismo contexto. Dos servicios el mismo día son dos alias: cada uno con su validador, su vigencia y su recuento aparte. Fuera de su ventana, los Devices de ese servicio dejan de abrir, así que un Device filtrado del servicio de la mañana no abre la puerta del de la tarde.
Devices sueltos
Un Device sin servicio opera siempre: el servicio es opcional, no un requisito.
Monitor
Aquí entra todo, incluidas las rutas desconocidas. Si el Device postea a la ruta equivocada verás un 404 con su cuerpo: es la forma más rápida de saber si la petición siquiera llega, antes de sospechar del cable, del firewall o del token.
Lo que vio el Device
Tarjetas del servicio
Tarjetas sin asignar
Un UID que no está ligado a ningún pase llega como lectura denegada. Aquí se juntan para que lo asocies a un boleto válido en P@ssID; una vez asociado, el siguiente escaneo abre.
Seguridad
Umbral
Pon aquí la IP pública del recinto. Si un Device mal configurado dispara el umbral, sin lista blanca se bloquea a sí mismo y la puerta se queda muerta. Acepta IP exacta, comodín * y CIDR.
Aviso en tiempo real
Variables: ${ip} ${intentos} ${ventana} ${motivo} ${ruta} ${reincidencia} ${hasta} ${host}. En el cuerpo: ${instancia} ${destino} ${mensaje}. Prueba el aviso ahora: el momento de descubrir que el token está mal no es durante un ataque.
Bloqueados
Bitácora
—
Playground
POST /api/v1/devices/control
POST https://cae.passid.com.mx/api/v1/devices/control
x-device-token: dk_...
Content-Type: application/json
{
"switch": "switch_1", // opcional; si viene, debe coincidir con el del carril
"action": "pulse", // "pulse" | "on" | "off"
"seconds": 3 // sólo para "pulse"; si falta, usa la retención del carril
}
El Gate lo determina el token, no la URL: así un cliente no puede pedir un dispositivo y accionar otro. La respuesta trae code: 1 éxito, 0 error — más un estado HTTP honesto, para que un monitor distinga "credencial mala" de "el aparato no contestó" sin parsear el JSON. Este contrato es provisional y vive versionado en /api/v1.
Tokens de dispositivo
Rotar un token invalida el anterior al instante. Un token filtrado abre sólo ese Gate: revocarlo no afecta a los demás ni al validador de QR, que usa su propia clave pk_ de Claves de acceso.
Enviar una petición
—