En Fiado, para abrir una inversión hay que demostrar que eres el titular de la cédula: una prueba de vida con la cámara y la comparación de tu rostro con la foto del documento. Lo hice con face-api en el backend NestJS, sobre WebAssembly, sin GPU ni binarios nativos. La primera versión funcionaba perfecto con las fotos de muestra y rechazaba casi todas las cédulas reales.
Dos rostros donde esperaba uno
La regla era: exactamente un rostro por imagen, para que nadie se verifique con otra persona al lado. Pero la cédula ecuatoriana trae, además del retrato, un retrato fantasma más pequeño, así que toda cédula "tenía dos personas". En la cédula, entonces, cuenta el rostro más grande: los detecto todos y los ordeno por área.
const faces = await faceapi
.detectAllFaces(tensor, new faceapi.SsdMobilenetv1Options({
minConfidence: MIN_DETECTION_CONFIDENCE,
}))
.withFaceLandmarks()
.withFaceDescriptors();
return faces.sort((a, b) => b.detection.box.area - a.detection.box.area);En la selfie, ¿cuándo cuenta un segundo rostro?
En el fotograma en vivo la regla sí tiene que existir, pero contar cualquier rostro era demasiado: un cuadro en la pared, alguien que pasa al fondo o un falso positivo tumbaban la verificación. Ahora un segundo rostro sólo invalida la captura si el detector está seguro (confianza de 0,7 o más) y si mide al menos un cuarto del principal.
const EXTRA_FACE_CONFIDENCE = 0.7;
const EXTRA_FACE_AREA_RATIO = 0.25;
export function relevantFaces<
T extends { detection: { score: number; box: { area: number } } },
>(faces: T[]): T[] {
const [main, ...rest] = faces;
if (!main) return faces;
return [
main,
...rest.filter(
(face) =>
face.detection.score >= EXTRA_FACE_CONFIDENCE &&
face.detection.box.area >=
main.detection.box.area * EXTRA_FACE_AREA_RATIO,
),
];
}Fotos giradas y retratos diminutos
Otros dos fallos venían de la foto, no de la persona. Las fotos tomadas con el celular llegaban a veces giradas y el detector no encontraba nada: si no aparece un rostro, pruebo girando la imagen 90° hasta dar la vuelta completa. Y el retrato ocupa poco de la cédula: buscarlo en la imagen reducida a 1280 px está bien, pero sacar de ahí el descriptor pierde detalle. El descriptor sale de un recorte del retrato a resolución completa.
Un umbral medido, no el de siempre
face-api suele usar una distancia de 0,6 entre descriptores para decir "misma persona". Con las fotos de muestra, la misma persona quedaba entre 0,05 y 0,35, y personas distintas desde 0,47. Una cédula real (impresa, con hologramas, con una foto de hace años) aleja al titular de su selfie, así que el umbral quedó en 0,5: acepta al titular sin llegar al 0,6. Y se configura por entorno, porque con más cédulas reales habría que volver a medirlo.
const distanceAtThreshold = () => {
const raw = Number(process.env.FACE_MATCH_DISTANCE);
return raw > 0 && raw < 1 ? raw : 0.5;
};Lo que no hace
Esta prueba de vida detiene una foto impresa o en pantalla, que no gira ni sonríe cuando se le pide. No sustituye a un detector pasivo certificado (ISO/IEC 30107-3) contra máscaras o deepfakes en tiempo real. Por eso el reconocimiento está detrás de una interfaz (BiometricProvider): cambiar face-api por un proveedor comercial no toca el resto del sistema.