Saltar al contenido principal

Credential Offer

Un Credential Offer es el mensaje que un emisor envía a una cartera para iniciar la emisión bajo OpenID4VCI: identifica al emisor, indica qué credenciales se ofrecen y le dice a la cartera de qué modo puede recogerlas.

En la práctica, la oferta es lo que hay detrás del código QR en una página de emisión o del enlace en un correo electrónico o una aplicación. Puede entregarse por valor, incrustada directamente en un enlace profundo openid-credential-offer:// o en el propio QR, o por referencia, como una URL que la cartera consulta para obtener el mismo contenido, lo que mantiene el código corto cuando la oferta incluye varias credenciales o lleva un estado de emisor largo. Al escanearla o abrirla, la cartera recibe la URL del emisor y uno o varios identificadores de configuración de credencial, más una concesión (grant) que decide el resto del flujo: una concesión de código de autorización envía primero al titular a través del propio inicio de sesión del emisor, útil cuando la oferta se generó en un dispositivo distinto al que completa el flujo, mientras que una concesión de código preautorizado se usa cuando el titular ya estaba autenticado en el lugar donde se creó la oferta, por ejemplo justo después de iniciar sesión en un portal gubernamental, protegida opcionalmente por un código de transacción mostrado en ese mismo canal, de modo que un código interceptado en tránsito no pueda ser canjeado por otra persona. A partir de ahí, la cartera lee los metadatos del emisor para saber qué contienen realmente las credenciales indicadas, intercambia la concesión por un token de acceso en el punto de conexión de tokens del emisor, y llama al punto de conexión de credenciales para recoger lo que se ofreció, una credencial o un lote a la vez, según lo que admita el emisor.

¿Por qué algunas Ofertas de Credencial piden un código de transacción y otras no?

Se requiere un código de transacción siempre que la oferta usa una concesión de código preautorizado, ya que el titular ya estaba autenticado en otro canal y el código demuestra que la persona que escanea la oferta es la misma que autenticó ese canal. Una concesión de código de autorización, en cambio, envía al titular a través del propio inicio de sesión del emisor como parte del flujo, así que no hay un canal separado que vincular ni se necesita ningún código.

Volver al glosario