Control de accesos

1. Qué hay en la pantalla

Arriba, cuatro cifras: «Verificaciones Totales», «Tasa de Aprobación», «Claves API Activas» y «Webhooks Activos». Debajo, las pestañas «Configuración», «Claves API», «Registro de Accesos», «Webhooks» y «Estadísticas». La pantalla abre en «Configuración».

2. Decidir cuándo se permite el acceso

En «Requisitos de Cumplimiento» fija «Porcentaje de Cumplimiento Requerido» y si activas «Permitir Cumplimiento Parcial» (si no, se exige el 100 %). En «Tipos de Documentos Críticos» marca los documentos que deben estar siempre vigentes, sea cual sea el porcentaje: si uno falta o está caducado, el acceso se deniega.

En «Configuración de Código QR» decides cuántas horas vale un QR y en «Configuración de Verificación», si se verifica a cada trabajador, si se registran también los accesos permitidos y cuántos minutos se guarda en caché el estado. Pulsa «Guardar».

3. Conectar el sistema de tornos

En «Claves API» pulsa “Crear Clave API”, ponle un “Nombre” (el lector o el centro) y, si quieres, una “Lista Blanca de IPs”. El sistema de accesos envía esa clave en la cabecera X-API-Key al consultar GET /api/v1/access-control/verify/{contractorCIF}, como indica la “Guía de Integración”. Crea una clave por lector: así puedes desactivar solo la que se retira.

En «Webhooks», “Añadir Webhook” avisa a tu sistema cuando cambia el cumplimiento de un contratista; las peticiones llevan la firma HMAC en X-Webhook-Signature.

4. Comprobar qué ha pasado

«Registro de Accesos» lista cada verificación; filtra por CIF, punto de acceso, resultado y fechas. Si alguien se queja de que no le dejaron entrar, busca su CIF: el resultado dice el motivo (documentos caducados, cumplimiento bajo, contratista vetado o no encontrado, QR no válido o caducado).

«Estadísticas» resume en un rango de fechas las verificaciones, los permitidos y denegados, el tiempo medio de respuesta, la tendencia diaria, los motivos de denegación y los puntos con más tráfico.

5. Quién puede hacerlo

Cambiar la configuración y crear o desactivar claves y webhooks requiere permiso de edición. Coordinación CAE, por defecto, solo la ven los administradores.