Skip to content

Habilitar mDL ISO

El trámite para emitir licencias de conducir con el docType oficial de ISO: por qué hace falta un certificado, quién hace qué y los tres pasos en la consola.

Esta página es solo para credenciales con el docType oficial de ISO, org.iso.18013.5.1.mDL: una licencia de conducir que tiene que poder leerse con lectores de terceros, fuera de Sovra.

Por qué hace falta un trámite

Una credencial común de Sovra lleva la dirección del emisor adentro, y cualquiera puede buscarla en SovraChain. Un mDL de ISO no lleva ninguna dirección: la norma no previó un campo para eso.

Entonces el lector sabe quién firmó la licencia por un certificado, igual que un navegador sabe quién está detrás de un sitio HTTPS. Y ese certificado lo emite una autoridad reconocida, no Sovra. El trámite es conseguirlo.

Quién hace qué

  • Sovra te da la cuenta, prepara la solicitud desde la consola, registra el resultado y te acompaña en cada paso. No es (ni puede ser) la autoridad certificante.
  • Tu organización gestiona el trámite con la autoridad y nos acerca el certificado que te devuelve.
  • La autoridad emisora firma el certificado. Es un organismo externo: en Europa, la autoridad nacional de tránsito; en América, el que corresponda por jurisdicción.

Los tres pasos

Todo se hace desde la consola, en Settings → Driving licence.

  1. Generar la llave

    Tocá Create signing key. Se crea una llave exclusiva para licencias de conducir, separada de la que usa el workspace para el resto de las credenciales. Es inmediato.

  2. Pedir el certificado a tu autoridad

    En Ask your authority for a certificate completás el país (código de dos letras, como MX, ES o AR), el nombre del emisor (Common name) y, si querés, provincia y organización. La consola genera un archivo de solicitud que le mandás a la autoridad.

    El país tiene que coincidir con el de la autoridad, o no va a poder firmar la solicitud.

    Desde acá el proceso queda fuera de Sovra: los tiempos y requisitos los pone la autoridad, y pueden ir de días a meses. Conviene arrancarlo temprano.

  3. Registrar el certificado recibido

    La autoridad te devuelve dos archivos:

    1. Su certificado raíz: mandáselo a Sovra, que lo suma a la lista de confianza.
    2. El certificado del emisor: lo cargás en el paso 3 de la consola.

    Si todo encaja, aparece la tarjeta Ready y ya podés crear esquemas en Schemas → New → mDoc → ISO driving licence y emitir.

Cómo saber si quedó habilitado

En Settings → Driving licence: con la tarjeta Ready, emitís normalmente. Sin ella, toda oferta con docType ISO falla con document_signer_required.

Si algo falla

Si la consola rechaza el certificado, no te dice solo «inválido»: te dice qué regla no se cumple, con un mensaje como dsc_profile.country_mismatch. Mandale ese mensaje exacto al equipo de Sovra y te ayudamos a traducirlo en un pedido concreto para la autoridad.

Qué significa cada rechazo y qué pedirle a la autoridad

Los mensajes que empiezan con iaca_profile. hablan del certificado raíz; dsc_profile., del certificado del emisor; dsc_profile.chain., de la relación entre ambos.

Mensaje Qué pedirle a la autoridad
iaca_profile.not_self_signed La raíz debe ser autofirmada: se envió una intermedia.
iaca_profile.basic_constraints CA:TRUE con pathlen 0 o ausente.
iaca_profile.key_usage keyCertSign y cRLSign.
iaca_profile.expired La raíz está vencida.
dsc_profile.key_usage digitalSignature y ningún otro.
dsc_profile.missing_mdl_eku Agregar la EKU 1.0.18013.5.1.2.
dsc_profile.validity_too_long 457 días o menos.
dsc_profile.country_mismatch El país del emisor debe ser idéntico al de la raíz.
dsc_profile.state_mismatch La raíz declara una provincia, así que el emisor debe declarar la misma.
dsc_profile.is_a_ca CA:FALSE, o ausencia total de basicConstraints.
dsc_profile.chain.* El certificado no fue emitido por la raíz enviada.
dsc_profile.certifies_another_key Debe certificarse la solicitud actual, no una anterior.
dsc_profile.not_yet_valid La fecha de inicio de validez es futura.

Si necesitás dar de baja o reemplazar un emisor ya registrado, escribile al equipo de Sovra: no se hace desde la consola. Los esquemas que ya creaste con org.iso.18013.5.1.mDL se mantienen, pero no emiten hasta que se registre un certificado nuevo.

Probar sin una autoridad real (desarrollo y pilotos)

Para desarrollo, demos o pilotos podés hacer de autoridad vos mismo con openssl. Los certificados se validan con las mismas reglas que los reales, así que el ejercicio reproduce el trámite de verdad. Una raíz autogenerada solo la confía quien la generó: no la uses en un entorno donde importe la confianza de verificadores reales.

Guardá el archivo de solicitud del paso 2 como csr.pem, cambiá C = ES por el mismo país que pusiste en el paso 2, y ejecutá:

cat > iaca.cnf <<'EOF'
[req]
distinguished_name = dn
prompt = no
x509_extensions = iaca
[dn]
C = ES
CN = Dev IACA
[iaca]
basicConstraints = critical,CA:TRUE,pathlen:0
keyUsage = critical,keyCertSign,cRLSign
subjectKeyIdentifier = hash
EOF

cat > dsc.cnf <<'EOF'
[dsc]
basicConstraints = critical,CA:FALSE
keyUsage = critical,digitalSignature
extendedKeyUsage = critical,1.0.18013.5.1.2
subjectKeyIdentifier = hash
authorityKeyIdentifier = keyid:always
EOF

# La raíz, que hace de autoridad. Se envía a Sovra.
openssl ecparam -name prime256v1 -genkey -noout -out iaca.key
openssl req -x509 -new -key iaca.key -sha256 -days 3650 -config iaca.cnf -out iaca.pem

# El certificado del emisor, a partir de la solicitud de la consola.
# Se carga en el paso 3.
openssl x509 -req -in csr.pem -CA iaca.pem -CAkey iaca.key -CAcreateserial \
  -days 400 -sha256 -extfile dsc.cnf -extensions dsc -out dsc.pem

Mandale iaca.pem a Sovra y cargá dsc.pem en el paso 3. Guardá iaca.key si vas a certificar otros emisores con la misma raíz.

Type to search…

↑↓ navigate↵ selectEsc close