GBS Identity
1. Visión general
GBS Identity es una aplicación web destinada a la creación y consulta de registros biométricos de individuos. Cada registro (llamado internamente de encounter) reúne:
Datos biográficos — claves, nombre, filiación, fecha de nacimiento (según la configuración del entorno).
Biometrías — imagen facial, huellas dactilares y firma.
Tras el envío, el sistema registra al individuo en el ABIS y dispara una búsqueda biométrica 1:N que devuelve perfiles coincidentes. El operador puede entonces visualizar la información de los perfiles encontrados en la base, validando la identidad.
Principales capacidades para el operador:
Crear y enviar registros, incluso sin conexión (modo sin conexión).
Buscar historial de registros.
Visualizar resultados de búsqueda biométrica.
Monitorear el estado de los dispositivos biométricos y de los servicios dependientes.
Visualizar métricas agregadas de capturas, envíos y coincidencias.
2. Requisitos previos
2.1 Navegador e instalación
Navegador recomendado: Google Chrome o Microsoft Edge actualizados.
GBS Identity es una PWA (Progressive Web App). Puede utilizarse sin conexión y puede instalarse en el ordenador.
Después del primer acceso con internet, los recursos de la aplicación quedan en caché local, permitiendo el uso sin conexión.
Para instalarlo como aplicación del sistema operativo, haga clic en el icono de instalación en la barra de direcciones del navegador. GBS Identity pasará a abrirse como una ventana dedicada, sin necesidad del navegador, y quedará disponible en el menú de Windows.
2.2 Extensión y dispositivos biométricos
La captura biométrica ocurre a través de la Live Capture Extension, que se comunica con los dispositivos USB del ordenador (cámara facial, lector biométrico de huellas y pad de firma). Antes de iniciar un registro, asegúrese de que:
La Live Capture Extension está instalada en el navegador.
El Live Capture Connector está instalado en el sistema operativo (drivers y plugins de los dispositivos).
Los dispositivos físicos están conectados por USB y encendidos.
El estado de cada componente puede verificarse en cualquier momento en la página Diagnóstico del sistema y en el indicador en la esquina superior derecha (ver Sección 5).
2.3 Conexión y servidor
Para el envío inmediato de registros, se requiere conexión a internet y disponibilidad del servidor de identificación (ABIS).
Cuando está sin conexión, el registro se guarda localmente y se envía automáticamente en cuanto la conexión y el servidor vuelvan a estar disponibles.
3. Acceso e inicio de sesión
GBS Identity utiliza la nueva autenticación integrada de la suite GBS a través de GBS Auth. En esta modalidad, la autenticación está intermediada con el proveedor de identidad (IdP - Identity Provider) de la organización del cliente. Al acceder a la aplicación, se le redirige a la pantalla de inicio de sesión del proveedor de identidad. Tras autenticarse con sus credenciales, el navegador vuelve a GBS Identity ya con su sesión abierta.
El nombre del usuario aparece en la esquina superior derecha del encabezado. Las funcionalidades disponibles dependen de los permisos asignados a su perfil.
Para cerrar la sesión, haga clic en el avatar (esquina superior derecha) y seleccione Salir. Se le redirigirá de vuelta a la pantalla de inicio de sesión.
4. Diseño de la aplicación
Toda página tiene la misma estructura: barra lateral a la izquierda, encabezado fijo en la parte superior y área de contenido central.
4.1 Barra lateral (izquierda)
Muestra los elementos principales de navegación. Puede contraerse/expandirse mediante el botón de la base.
Inicio
Página de inicio. Acceso directo para crear un nuevo registro y ver la actividad reciente.
Nuevo registro
Abre el formulario de creación de registro (solo si tiene permiso de escritura).
Registros
Lista y busca todos los registros (todos los usuarios, si es administrador) o solo los suyos.
Métricas
Panel de indicadores agregados de uso (solo para usuarios con permiso de métricas).
Los elementos de menú a los que no puede acceder (por falta de permiso) permanecen ocultos. La versión de la aplicación se muestra en la parte inferior de la barra lateral.
4.2 Encabezado (parte superior)
El encabezado muestra el título de la página actual y, en la esquina derecha, los siguientes iconos (de izquierda a derecha):
Listos para enviar — acceso directo al Registro de envíos (página con registros pendientes de sincronización). Aparece cuando hay registros pendientes de envío.
Indicador de estado del sistema — señala en tiempo real si todos los componentes (dispositivos, extensión, ABIS, internet) están operativos. Al hacer clic abre la página de Diagnóstico del sistema. Colores:
VERDEtodo correcto,AMARILLOaviso (algo no crítico falló),ROJOcrítico (impide nuevos registros).Iniciar recorrido de la página (icono de ayuda) — inicia un recorrido guiado contextual con explicaciones sobre cada elemento de la pantalla actual.
Avatar y nombre del usuario — abre el menú de la cuenta, con la opción Salir.
4.3 Recorrido guiado y onboarding
En cada página, el botón de ayuda (icono con "?") inicia un recorrido interactivo con explicaciones paso a paso de los elementos de la pantalla. Los recorridos están disponibles en:
Inicio — presentación general de la aplicación, modo sin conexión e instalación como PWA.
Nuevo registro — explicación de las etapas biográficas y biométricas.
Registros — búsqueda y lectura del listado.
Detalles del registro — lectura de los resultados de la búsqueda biométrica.
Los pasos mostrados en el recorrido se adaptan a sus permisos y al estado de la pantalla. Use los botones Anterior, Siguiente y Finalizar para navegar.
5. Estado del sistema y diagnóstico
5.1 Indicador en el encabezado
Un pequeño panel en el encabezado supervisa continuamente cada componente. Al hacer clic en él se le lleva a la página Diagnóstico del sistema.
5.2 Página Diagnóstico del sistema
Accesible desde el indicador del encabezado o desde el menú de la cuenta. Verifica seis componentes:
Sistema de captura
Live Capture Extension instalada y Connector activo (motor principal de captura biométrica).
Sí
Dispositivo de captura facial
Cámara detectada, permiso de acceso concedido por el navegador.
Sí
Escáner de huellas dactilares
Driver, SDK, dispositivo USB y acceso.
Sí
Pad de firma
Driver, SDK, dispositivo USB y acceso.
Sí
Servicio de identificación (ABIS)
Conexión con el sistema biométrico de búsqueda.
No (limita la funcionalidad)
Conexión a Internet
Conectividad de red.
No (limita la funcionalidad)
Cada componente se muestra en una tarjeta con su estado — EN LÍNEA, SIN CONEXIÓN, CRÍTICO, NO DISPONIBLE. Cuando hay una falla, la tarjeta muestra una sección Pasos para la resolución con instrucciones específicas.
5.3 Banners de estado
Problema crítico identificado — al menos un componente esencial (extensión o dispositivo biométrico) no está disponible. No será posible iniciar nuevos registros hasta que se resuelva. Siga los pasos indicados en la tarjeta correspondiente.
Aviso del sistema — los componentes no críticos no están disponibles (ABIS o internet). Puede seguir usando el sistema con funcionalidad limitada (por ejemplo, los registros se guardan localmente para su envío posterior).
5.4 Subestados comunes
Denegado
El navegador bloqueó el acceso al dispositivo.
Revise los permisos en la barra de direcciones.
No encontrado
El dispositivo no fue detectado por el sistema.
Compruebe la conexión USB y el cable.
En uso
El dispositivo está siendo utilizado por otro programa.
Cierre otros programas que puedan estar usando el dispositivo.
No instalado
El driver o la extensión no fue instalada.
Instale la Live Capture Extension/Connector (enlace clicable en la tarjeta).
Versión incompatible
La versión instalada no es compatible.
Actualice el driver/extensión a la versión recomendada.
6. Inicio (Home)
Es la página de inicio de la aplicación, accesible mediante el elemento Inicio de la barra lateral. Contiene dos bloques:
6.1 Iniciar nuevo registro
Botón destacado en la parte superior. Al hacer clic abre la página de creación de un nuevo registro (Sección 7). Aparece solo si tiene permiso de creación.
6.2 Actividad reciente
Lista de los 5 registros más recientes a los que tiene acceso, con nombre (cuando esté disponible), fecha de creación y estado actual. Cada elemento es clicable y lleva a la página de detalles del registro.
Comportamiento:
En línea: muestra los 5 registros más recientes del servidor.
Sin conexión: muestra los 5 registros más recientes almacenados localmente (aún no enviados).
Cuando hay registros con estado Búsqueda solicitada, el panel se actualiza automáticamente cada 10 segundos para reflejar la evolución hasta que todos se completen.
El enlace Ver más → abre la página completa de registros (en línea) o el Registro de envíos (sin conexión).
7. Crear un nuevo registro
Esta es la funcionalidad central de GBS Identity. El flujo estándar tiene cinco etapas, mostradas en secuencia con indicador de progreso en la parte superior:
Datos biográficos
Complete la información del individuo. Los campos mostrados dependen de la configuración de la instalación.
Los campos obligatorios aparecen en rojo. Algunos campos tienen máscara automática y validación inmediata — si el valor es inválido, el mensaje aparece debajo del campo y el botón Siguiente queda deshabilitado.
Haga clic en Siguiente para avanzar.
Captura facial
El componente de captura en vivo muestra la imagen de la cámara. Por defecto, la captura comienza automáticamente y el sistema utiliza la verificación de calidad ICAO para garantizar una imagen adecuada.
Cuando la imagen se captura correctamente, aparece el mensaje "Rostro capturado con éxito" y el botón Capturar nuevamente. Evalúe la imagen en pantalla: si es necesario, repita antes de continuar.
El botón Siguiente solo se habilita después de una captura exitosa. Use Anterior para volver a la etapa de datos biográficos.
Huellas dactilares
El escáner solicita las huellas en secuencia. Coloque el dedo indicado por la interfaz y espere la captura — el sistema avanza automáticamente al siguiente dedo.
El modo de captura es configurable por instalación. La imagen de referencia de arriba muestra una recogida de cuatro dedos. Los dedos que aún no han sido capturados se destacan.
Si un dedo no puede ser capturado (amputación, lesión), siga la interfaz de la extensión para marcar el motivo (la captura puede omitirse mediante las opciones específicas del dispositivo, cuando estén habilitadas por la configuración).
El mensaje "Huellas dactilares capturadas con éxito" aparece cuando el conjunto está completo.
Firma
Solicite al individuo que firme en el pad de firma. La firma se muestra en tiempo real en la pantalla.
Si la firma queda inadecuada, use Capturar nuevamente.
Cuando la firma se captura, aparece "Firma capturada con éxito".
Si el individuo no puede firmar (analfabeto, lesión, bebé, etc.), marque la opción No firma. El sistema mostrará "Firma no capturada" y permitirá avanzar incluso sin firma.
Revise los datos ingresados
Muestra un resumen de todos los datos ingresados:
Datos biográficos completados.
Datos biométricos — para cada modalidad (Face, Huellas dactilares, Firma), indica si fue Capturado o No capturado, con vista previa cuando está disponible.
Léalo atentamente. Para corregir algo, use Anterior y vuelva a las etapas anteriores — los datos ya capturados se conservan.
Cuando todo esté correcto, haga clic en Enviar. Durante el envío, ambos botones quedan deshabilitados.
Cancelar registro
Cancelar (esquina superior): aborta el registro y descarta todo lo capturado (con confirmación).
Atención: esta acción no se puede deshacer. Al cancelar o salir de un registro en curso, todos los datos biográficos y biométricos capturados (foto facial, huellas dactilares, firma y demás información asociada) se borran permanentemente. El sistema siempre muestra un modal de confirmación antes de descartar los datos.
Después del envío
El comportamiento depende del estado de la conexión en el momento del envío:
En línea + ABIS disponible
El registro se envía inmediatamente. Se le redirige a la página de detalles del registro.
"Registro enviado con éxito"
Sin conexión
El registro se guarda en el dispositivo (IndexedDB) y se añade a la cola de envío.
"Está sin conexión. El registro se guardó localmente y se enviará cuando se restablezca la conexión."
Fallo en el envío en línea
El registro se guarda localmente y el sistema intentará reenviarlo automáticamente.
"Error en el envío. El registro se guardó localmente y se reenviará automáticamente."
8. Modo sin conexión y Registro de envíos
GBS Identity fue diseñado para funcionar sin conexión. Puede iniciar y completar un registro normalmente cuando esté sin conexión — se almacenará en el navegador y se enviará automáticamente en cuanto haya conexión y el servidor esté disponible.
8.1 Cómo identifica el sistema el estado sin conexión
El navegador perdió acceso a internet, o
El servidor de identificación (ABIS) está caído.
En ambos casos, el encabezado mostrará una indicación de estado amarilla/roja y algunas páginas mostrarán banners específicos.
8.2 Listos para enviar
Cuando hay registros pendientes de envío, aparece un botón Listos para enviar en el encabezado. Al hacer clic abre la página Registro de envíos.
8.3 Página Registro de envíos
Lista todos los registros pendientes de envío almacenados localmente. Para cada uno, se muestran:
Nombre (o "Registro sin nombre" cuando no está completado).
Fecha de la última actualización.
Indicador Enviando en tiempo real durante la sincronización.
Indicador Error en el intento de envío cuando ocurre una falla.
Cuando el sistema está en línea, ABIS responde y hay registros pendientes, aparece el botón Reenviar registros en la parte superior de la página. Haz clic para forzar un nuevo intento de envío.
Cuando la cola está vacía, la página muestra "Ningún registro pendiente de envío".
8.4 Banner de servidor offline
En la página Registros y en Métricas, cuando ABIS no está disponible, aparece un banner naranja:
MODO OFFLINE — Servidor de Búsqueda Offline. El servidor de búsqueda ABIS no está disponible en este momento. Solo los registros listos para envío están visibles. Los registros en línea no pueden accederse hasta que se restablezca la conexión con el servidor.
9. Listar y buscar registros
Accedida mediante el elemento Registros de la barra lateral. La página tiene tres bloques: filtros, lista paginada y paginación.
9.1 Filtros
Buscar por...
Campo de texto con selector de tipo de clave. El valor se formatea automáticamente según el tipo seleccionado.
Fecha inicial / Fecha final
Filtra por la fecha de inicio de la captura del registro. Se puede usar solo una de las dos.
Botones Buscar (aplica los filtros) y Limpiar (borra todos los filtros y vuelve a hacer la búsqueda). Pulsar la tecla Enter en el campo de búsqueda también dispara la búsqueda.
Los filtros aplicados se conservan al navegar a otras páginas. Al volver a Registros, tu búsqueda sigue mostrándose.
9.2 Lista de registros
Cada ítem muestra:
Nombre (o "Registro desconocido", cuando no hay "Nombre").
Documentos identificadores.
Cantidad de candidatos encontrados (después de que finaliza la búsqueda biométrica).
Badge de estado indicando el estado del procesamiento:
Registrando
El individuo está siendo registrado en ABIS.
Registrado
El enrolamiento se ha completado.
Error al registrar
El enrolamiento falló.
Procesando
La búsqueda biométrica 1:N fue solicitada y está en curso.
Fallo en la búsqueda
La búsqueda biométrica falló en el servidor.
Completado
El procesamiento se ha completado — los candidatos (si los hay) están disponibles para análisis.
Cada ítem tiene el botón Ver para abrir los detalles (Sección 10).
9.3 Paginación
En el pie de la lista, control de páginas (primera, anterior, siguiente, última) y selección de cantidad de registros por página (10, 15 o 50). La paginación solo aparece cuando hay resultados en línea.
10. Detalles del registro y búsqueda biométrica
Accedida mediante el botón Ver de cada registro o por la tarjeta de actividad reciente en el dashboard. La página tiene tres bloques:
10.1 Registro Actual
Tarjeta en la parte superior, mostrando todos los datos del registro recién creado:
Imagen facial capturada.
Datos biográficos.
Estado actual (badge).
Indicación de si algún dedo tiene una anomalía (amputado, lesionado, etc.).
Mientras el estado del registro sea Registrando, Registrado o Búsqueda solicitada, esta página se actualiza automáticamente cada 5 segundos.
10.2 Resultado de la búsqueda biométrica
Justo debajo del registro actual, muestra el resultado de la búsqueda:
"X perfiles encontrados" — total de candidatos en la esquina superior derecha de la sección.
"Ningún perfil encontrado" — cuando la búsqueda no devolvió candidatos.
Cuando no hay candidatos, el sistema explica:
10.3 Tarjeta de candidato
Cada candidato encontrado se muestra en una tarjeta con:
Imagen facial del candidato.
Tipo de registro:
CIVIL(proveniente de la base civil) oREGISTRO(otro encounter ya existente en Identity).Datos biográficos resumidos.
Fecha de creación del registro del candidato.
PGUID / TGUID — identificadores únicos del candidato.
Botón Ver Detalles.
Para cerrar la información detallada, haz clic en Ocultar Detalles.
10.4 Avisos de verificación por clave
Además de la búsqueda biométrica 1:N, GBS Identity realiza una verificación 1:1 para cada clave informada. Estos avisos aparecen como banners destacados:
Aviso: El (clave) informado ya está registrado en un perfil en la base que no tiene correspondencia biométrica con el registro. Esto puede indicar fraude documental — investiga antes de aceptar el registro.
10.5 Volver
El botón Volver en la parte superior retorna a la página de origen: Registros (si viniste del listado) o Inicio (si viniste del dashboard).
11. Completar registro
Cuando se ha creado un registro en el modo rápido (solo con biometría mínima) y la búsqueda biométrica no devolvió ningún candidato, el operador puede completar el registro añadiendo más biometrias y datos biográficos. Esto mejora la calidad del registro almacenado en ABIS para búsquedas futuras.
11.1 Cuándo aparece el botón
En la página de detalles del registro, cuando no se encuentra ningún candidato y el registro es del tipo rápido (y aún no ha sido completado), aparece el botón Completar Registro.
Si el registro ya tiene candidatos o ya ha sido completado, el botón no aparece y el sistema muestra "El registro no puede completarse" si intentas abrir la URL de complemento manualmente.
11.2 Flujo de complemento
Al hacer clic en Completar Registro, se abre el mismo formulario de cinco pasos usado en un nuevo registro, ya prellenado con los datos biográficos y biométricos del registro original. Agrega la información que falta y continúa hasta la etapa de revisión.
Al enviar, el sistema actualiza el registro en ABIS y devuelve el nuevo resultado de búsqueda. Se te redirige de vuelta a la página de detalles.
Si cancelas o intentas salir con cambios pendientes, el sistema muestra un modal:
Descartar cambios — Atención: Tus cambios se perderán. Cancelar descartará todos los cambios hechos en este registro, incluyendo nuevos datos biográficos y biométricos capturados.
12. Métricas
Accedida mediante el elemento Métricas de la barra lateral (solo para usuarios con permiso). Muestra tres indicadores agregados de uso para un período seleccionado.
12.1 Filtro de período
En la parte superior de la página, elige Fecha Inicial y Fecha Final. Atajos disponibles: Hoy, Último Mes, Este Año. El botón Buscar solo se habilita cuando ambas fechas están completas.
Después de buscar, se muestra una línea resumen (por ejemplo, "Período seleccionado: 01/05/2026 - 27/05/2026 (27 días)") y las tres tarjetas de métrica.
12.2 Indicadores mostrados
Total de Capturas Offline
Cuántos registros fueron capturados sin conexión (offline) en el período. Útil para seguir el uso en campo.
Total de Registros Enviados
Cuántos registros fueron efectivamente enviados a ABIS en el período.
Registros sin candidatos
Cuántos registros, al ser sometidos a la búsqueda biométrica, no tuvieron ningún candidato correspondiente.
12.3 Indisponibilidad del servicio
Esta página requiere ABIS en línea. Si accedes mientras estás offline, serás redirigido a la página inicial con el mensaje "El servicio de identificación no está accesible en este momento para consulta de métricas".
13. Mensajes, avisos y solución de problemas
13.1 Toasts y notificaciones comunes
Registro enviado con éxito
Envío en línea completado. Registro disponible para consulta.
Estás offline. Registro guardado localmente y será enviado cuando se restaure la conexión.
El registro está seguro en el dispositivo. Revisa el encabezado para ver señales de que la conexión ha vuelto.
Registro pendiente sincronizado con éxito
Un registro que estaba en la cola fue enviado.
Error al sincronizar el registro. Lo intentaremos de nuevo.
Error temporal. El sistema hará un nuevo intento automáticamente.
Error en el formato del registro. Contacta con soporte
El registro local está corrupto o en formato inválido. Contacta con soporte con el ID del registro.
Error al cargar registros. Intenta nuevamente.
Error temporal en la llamada al servidor. Recarga la página o vuelve a hacer la búsqueda.
Página de nuevo registro no disponible mientras los dispositivos estén inactivos
Consulta la página de Diagnóstico del Sistema (Sección 5).
Registro no encontrado. Se creará un nuevo registro.
El ID en la URL no existe. El sistema creó un registro en blanco.
Error al inicializar el registro. Intenta nuevamente.
Error al preparar la pantalla de nuevo registro. Vuelve a abrir la página.
13.2 Actualización de la aplicación (PWA)
Cuando se detecta una nueva versión, aparece un aviso flotante "Nueva versión disponible — Actualiza la página para usar la versión más reciente de la app", con los botones:
Actualizar ahora — recarga la aplicación en la nueva versión.
Más tarde — pospone el recordatorio.
Descartar — cierra el aviso (se mostrará nuevamente en otra ocasión).
13.3 Diagnósticos: qué hacer si algo está en rojo
Sistema de Captura en rojo.
Live Capture Extension no instalada o desactivada.
Instala la extensión (enlace en la página de Diagnóstico). Reinicia el navegador.
Dispositivo Facial en rojo.
Cámara no conectada o permiso denegado.
Revisa el cable USB. Concede permiso a la cámara en la barra de direcciones del navegador.
Escáner de Huellas en rojo.
Controlador ausente, dispositivo en uso por otro programa o USB desconectado.
Vuelve a conectar el USB. Cierra otros programas de captura. Instala el controlador indicado.
Pad de Firma en rojo.
La misma familia de causas que el escáner.
Vuelve a conectar y prueba.
Servicio de Identificación en rojo.
ABIS fuera de servicio o VPN/firewall bloqueando.
Sigue trabajando offline — los registros se enviarán cuando el servicio vuelva. Contacta con soporte si persiste.
Conexión a Internet en rojo.
Sin red (Wi-Fi/Ethernet) o router caído.
Revisa la red del equipo. Sigue trabajando offline — GBS Identity funciona sin internet.
14. Salir y cambiar de sesión
Haz clic en el avatar en la esquina superior derecha y selecciona Salir. El sistema cierra la sesión en el proveedor de identidad y te devuelve a la pantalla de inicio de sesión. Los datos locales no enviados (registros pendientes) permanecen almacenados en el dispositivo y se sincronizarán en la próxima sesión del mismo usuario.
Glosario
Registro (encounter)
Conjunto de datos biográficos y biométricos recopilados de un individuo en una sesión.
ABIS
Automated Biometric Identification System — servicio que almacena, indexa y busca biometrías.
Enrolamiento (registro)
Proceso de insertar al individuo en ABIS para que pase a figurar en búsquedas futuras.
Verificación (1:1)
Comparación de los documentos del individuo contra un registro específico en la base, identificado por la misma clave.
Búsqueda (1:N)
Comparación biométrica del individuo contra toda la base, devolviendo candidatos con coincidencia.
Perfil encontrado
Registro existente en la base que presenta coincidencia biométrica (rostro, huella o firma) con el registro recién creado.
CIVIL
Origen del candidato: proveniente de la base civil (base de ciudadanos).
REGISTRO
Origen del candidato: proveniente de otros encounters ya existentes en Identity.
PGUID / TGUID
Identificadores únicos asignados por ABIS al individuo (PGUID) y al registro biométrico (TGUID).
Live Capture Extension
Extensión del navegador que permite a la aplicación web acceder a los dispositivos biométricos.
Live Capture Connector
Aplicación del sistema operativo que actúa como puente entre la extensión del navegador y los controladores de los dispositivos.
PWA
Progressive Web App — modelo de aplicación web que puede instalarse como app nativa y funcionar offline.
Última actualización
¿Te fue útil?