# Target biométrico Documentación relacionada con el Target Biométrico y su comportamiento.\ Esta funcionalidad está disponible solo a partir de la versión 5 de GBDS. ## Comportamiento ### En cualquier enroll/update Si una transacción no tiene "origin", lo que significa que no hay ninguna etiqueta referente a una organización de origen, la transacción tendrá, a efectos de excepción, origen de organizaciones de nivel más alto. {% hint style="info" %} Ejemplo: Una transacción registrada en un entorno con organización `ori_griaule` como organización de nivel más alto (sin organización padre), tendrá `ori_griaule` como origen {% endhint %} ### En generación de excepción {% hint style="info" %} CSI significa Ciclo de Inconformidad Simplificado. Es un sistema usado para evaluar datos biométricos, determinando si un candidato biométrico es HIT, NO\_HIT o UNCERTAIN con base en límites específicos durante el registro o las actualizaciones. Un candidato se marca como HIT si su coincidencia está por encima del límite de CSI, NO\_HIT si no lo está y UNCERTAIN si su coincidencia está por debajo del límite. {% endhint %} {% hint style="info" %} * Hit de dedo: todas las matches para dedos alcanzan la cantidad biométrica mínima * No Hit de dedo: todos los no matches de dedo alcanzan la cantidad biométrica mínima * Hit de rostro: todas las matches para rostro * No Hit de rostro: todos los no matches de rostro alcanzan la cantidad biométrica mínima {% endhint %} * Cada candidato será marcado como HIT, NO\_HIT o UNCERTAIN * Si el candidato biométrico no es un match, será un NO\_HIT * Si el candidato biométrico es un match con un valor por debajo del límite de CSI, será UNCERTAIN, de acuerdo con las configuraciones de enroll/update y finger/face * Si el candidato biométrico da match con un valor por encima del límite de CSI, será un HIT, de acuerdo con las configuraciones de enroll/update y finger/face * Las excepciones serán marcadas como target BIOMETRIC, BIOMETRIC\_INCONCLUSIVE, BIOMETRIC\_MISMATCH o BIOGRAPHIC: Registro | Dedo | Rostro | Excepción | | ------ | ------ | ------------------- | | HIT | HIT | BIOGRAPHIC | | HIT | NO HIT | BIOMETRIC\_MISMATCH | | NO HIT | HIT | BIOMETRIC\_MISMATCH | * Sin hit de dedo ni de rostro y sin no hit de dedo ni de rostro: * con incertidumbre biométrica, genera una excepción `BIOMETRIC` * con certeza biométrica, genera una excepción `BIOMETRIC_INCONCLUSIVE` Actualización | Dedo | Rostro | Excepción | | ------ | ------ | ------------------- | | NO HIT | NO HIT | BIOGRAPHIC | | HIT | NO HIT | BIOMETRIC\_MISMATCH | | NO HIT | HIT | BIOMETRIC\_MISMATCH | Si ningún dedo o rostro es considerado HIT ni NO\_HIT: * con incertidumbre biométrica, genera una excepción BIOMETRIC * con certeza biométrica, genera una excepción BIOMETRIC\_INCONCLUSIVE #### Próxima biometría La próxima biometría a ser evaluada será: * Perteneciente a un candidato con excepción en ANALYSIS * Con una decisión general de UNCERTAIN * No asignada a nadie * De una excepción donde la transacción entrante o la transacción entrante y de referencia contengan una etiqueta con al menos una de las organizaciones de las etiquetas de permiso del usuario * Puede configurarse a partir del endpoint con el parámetro `origin` * `ENTRANT`, será filtrado solo por la transacción entrante * `BOTH`, será filtrado por ambas transacciones {% hint style="info" %} La lista de organizaciones proporcionada es jerárquica, lo que significa que, si una organización tiene hijos, todos los hijos serán considerados para encontrar excepciones.\ Con la seguridad activada, esta lista de organizaciones se recupera de los permisos del usuario, siendo todos los permisos que comienzan con el prefijo de organización configurado, por defecto "ori\_". {% endhint %} Digital y/o rostro serán devueltos de acuerdo con el permiso configurado del usuario, por defecto "tpca" para digitales y "fca" para rostro, o de acuerdo con la solicitud para digital o rostro Si la configuración de "double blind" está activada, el usuario asignado a la biometría no puede haber decidido previamente sobre biometría El orden para la próxima biometría se decide por prioridad y por el orden proporcionado en el endpoint. Si no se proporciona ninguno, por defecto el orden es desde el más antiguo. GET next biometric devolverá el número de biometrías disponibles para ser tratadas, que son * Todas las UNCERTAIN de target BIOMETRIC con estado ANALYSIS no decididas por el usuario que está haciendo la solicitud de next biometric, disponibles para la organización a la que pertenece el usuario y, si se solicita por dedo o rostro, se contarán a partir de la selección elegida Con una biometría seleccionada, esta será asignada al usuario por 5 minutos. ### Desbloqueo manual Puede hacerse usando el endpoint `Unlock biometric` ### Para cada tratamiento biométrico Las validaciones a realizar son: * Se debe proporcionar un usuario, a menos que la seguridad esté activada; en ese caso, el usuario es proporcionado por el token * El timeout es cero por defecto; cuando el tratamiento es final y la excepción se trata como APPROVE, se utiliza este valor * Parámetros obligatorios: `enroll TGUID, exception PGUID, decision` y `index` * La excepción debe existir y estar en ANALYSIS y en target BIOMETRIC (los otros tipos no se tratan en esta etapa) * El candidato de la excepción debe tener un índice y estar clasificado como UNCERTAIN * El candidato biométrico debe estar asignado al usuario o no asignado a ningún otro usuario * El usuario no puede haber tomado una decisión para este candidato anteriormente * La biometría debe estar asignada al usuario Si todo pasa, la decisión se marca en el candidato y el candidato se libera (se desasigna) ### Double Blind | Double Blind | Decisión | | ------------ | --------------------------------------------------------------------------------------------------------------- | | Activado | La decisión es final cuando haya suficientes decisiones iguales (configurado en gbds.csi.doubleBlind.threshold) | | Desactivado | Final | ### Decisión final Si la decisión no es final, el estado de la excepción es NOT\_FINAL Si la decisión es final y todos los tratamientos necesarios se completan: #### Registro **APPROVE -** No hit de **d**edo y rostro alcanzan la cantidad mínima de conteo para registro, siendo considerado falso positivo **BIOGRAPHIC -** Hit de dedo y rostro alcanzan la cantidad mínima de conteo para registro **BIOMETRIC\_MISMATCH -** Si los hits de dedo y los no hits de rostro/no hits de dedo y hits de rostro alcanzan el mínimo de conteo para registro **BIOMETRIC\_INCONCLUSIVE -** Si todas las decisiones fueron tomadas pero no se alcanza ninguna conclusión #### Actualización **APPROVE -** Si hit de dedo y rostro alcanzan el valor mínimo de conteo para actualización, siendo considerado falso negativo **BIOGRAPHIC -** No hit de dedo y rostro alcanzan la cantidad mínima de conteo para actualización **BIOMETRIC\_MISMATCH -** Si los hits de dedo y los no hits de rostro/no hits de dedo y hits de rostro alcanzan el mínimo de conteo para actualización **BIOMETRIC\_INCONCLUSIVE -** Si todas las decisiones fueron tomadas pero no se alcanza ninguna conclusión (todos HIT, NO\_HIT o UNCERTAIN\_EXPERT, pero sin un valor mínimo definido) ### Prioridad Cuando una excepción es priorizada o despriorizada, todas las excepciones para el mismo entrante se ven afectadas. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.griaule.com/gbs/es/configuracion-de-gbds/target-biometrico.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.