Skip to content

Verificar credenciales

Cómo pedir y validar credenciales con OID4VP y DCQL: con una sesión de verificación de Sovra o por tu cuenta, leyendo SovraChain.

Verificar es pedirle a un ciudadano que te muestre datos de una credencial de su wallet, y comprobar que son auténticos, vigentes y suyos. Y que muestre solo lo que pediste: si solo necesitás saber que es mayor de edad, pedís eso y nada más.

Son tres movimientos: creás una sesión diciendo qué datos querés (con una consulta DCQL, un JSON corto), mostrás un QR, y recibís un webhook con el veredicto. Funciona igual para SD-JWT VC y para mDoc; solo cambia cómo se nombra cada dato. El protocolo por debajo es OpenID4VP.

El flujo en una pantalla

sequenceDiagram
    autonumber
    participant V as Tu servidor (verificador)
    participant S as Sovra
    participant W as Wallet del holder
    participant C as SovraChain

    V->>S: POST /api/v1/verifier/verifications (dcql_query)
    S-->>V: 201 session_id, authorization_request_uri(_ref), expires_at
    V->>W: Muestra el QR (la sesión vive 10 minutos)
    W->>W: El ciudadano aprueba o rechaza cada campo
    W->>S: vp_token / DeviceResponse firmado por el holder
    S->>C: Emisor, llaves del holder y estado de revocación
    alt pasa todas las validaciones
        S-->>V: Webhook presentation.verified (claims divulgados)
    else falla alguna validación
        S-->>V: Webhook presentation.failed (error)
    end

Tu servidor crea la sesión y muestra el QR. El ciudadano lo escanea, ve exactamente qué datos le pedís y los aprueba uno por uno. Sovra comprueba que la credencial sea auténtica, vigente y del ciudadano, y te avisa con presentation.verified o presentation.failed. La sesión vive 10 minutos; sus estados están en Estados de la sesión.

Dos formas de verificar

Con Sovra (recomendada para empezar). Creás una sesión, Sovra valida y te avisa por webhook. Son dos llamadas HTTP y un webhook.

Sin Sovra, con el SDK. Todo lo necesario para verificar (emisor, llaves, lista de confianza, revocación) está en SovraChain. Con @sovrahq/verification-sdk y acceso RPC verificás por tu cuenta, sin API key ni dependencia de la disponibilidad de Sovra. Conviene si no podés depender de un tercero, si verificás en un entorno aislado, para auditar credenciales guardadas, o si querés verificar credenciales sin ser cliente de Sovra.

Las comprobaciones criptográficas son idénticas en los dos caminos, y se pueden combinar. El detalle está en Verificar sin Sovra.

En esta sección

Type to search…

↑↓ navigate↵ selectEsc close