Identidad por certificado
Un dispositivo puede demostrar quién es con un certificado de cliente en lugar de un token o una contraseña. Presenta el certificado en el handshake TLS de su conexión MQTT, y la plataforma comprueba que lo emitió una autoridad certificadora (CA) en la que el tenant confía. No hay ningún secreto compartido que grabar en el firmware, y nada de lo que guarda el dispositivo puede reproducir alguien que copie un mensaje de la red: la clave privada nunca sale del dispositivo.
Esta página explica cómo decide la plataforma confiar en un certificado y dónde se detiene esa confianza. Para configurarlo, sigue Conectar con un certificado; la parte de la consola está en Aprovisionamiento y anclas de confianza. Para operar el broker y vigilarlo, consulta Autenticación por certificado.
Disponible por MQTT en el broker de la plataforma. HTTP y LwM2M no aceptan certificados de cliente, el SDK de C# solo puede presentarlo con claves RSA y ECDSA, y la renovación de un certificado por sí sola aún no está disponible. Lo que no se admite enumera todo lo que queda fuera.
El ancla de confianza es el límite de la identidad
Un ancla de confianza es un certificado de CA que un tenant ha añadido para decir «los dispositivos con un certificado emitido por esta CA son míos». Es material público y se guarda tal cual. Un tenant puede tener 32.
- Una CA raíz o una CA intermedia puede ser un ancla. Ancla en la CA más estrecha que emita solo tus dispositivos. Si un fabricante opera una PKI para muchos clientes, confía en la subCA que emite tu flota, no en la raíz.
- Cada conexión se comprueba de nuevo contra el ancla. Nada de un certificado se guarda en caché como de confianza.
- Un ancla se puede deshabilitar. Eso retira la CA al instante, y se terminan las sesiones activas de todos los dispositivos que dependen de ella.
Como el ancla decide quién es un dispositivo del tenant, las restricciones de nombre (name constraints) no se respetan, y una CA que las lleve se rechaza al añadirla como ancla o cuando aparece en una cadena presentada. La identidad que usa DeviceChain es el nombre común del certificado, que las restricciones de nombre no cubren. Una restricción pensada para limitar lo que una CA puede emitir se ignoraría en silencio, así que la plataforma rechaza el certificado en lugar de dejarte creer que se aplica.
Cómo debe ser un certificado
La plataforma acepta un certificado de dispositivo solo cuando se cumple todo esto:
- Nombra la autenticación de cliente en su uso extendido de clave. Un certificado sin uso extendido de clave, o que permita cualquier uso, se rechaza: nunca declaró ser un certificado de cliente.
- No es una CA.
- Ni él ni ningún certificado por encima está firmado con SHA-1.
- Todas las claves de la cadena son RSA de 2.048 a 8.192 bits, ECDSA en P-256 o P-384, o Ed25519.
- Su cadena, desde la hoja hasta los intermedios que envía el dispositivo, llega hasta el ancla de confianza. El dispositivo envía como máximo cinco certificados, 16 KiB en total.
- Es válido ahora. Se acepta un certificado emitido hasta cinco minutos en el futuro, para perdonar a un dispositivo cuyo reloj va algo atrasado respecto al de la CA; su caducidad nunca se amplía.
Dos formas de que un certificado se convierta en dispositivo
| Forma | Qué haces | La identidad del dispositivo |
|---|---|---|
| Credencial fijada | Creas el dispositivo y luego añades una credencial X509_CERTIFICATE con su certificado que nombra el ancla. | El dispositivo que creaste. Su token es el que elegiste. |
| Registro en la primera conexión | Creas un perfil de certificado: un perfil de aprovisionamiento que nombra un ancla. Los dispositivos cuyos certificados encadenan con el ancla se registran solos la primera vez que se conectan. | Un dispositivo creado para el certificado. Su id externo es el nombre común del certificado, y su token se deriva de él. |
Una credencial fijada se identifica por el SHA-256 del certificado, que calcula el servidor. La credencial registra el ancla con la que debe encadenar el certificado y la caducidad más temprana de toda la cadena. Un dispositivo puede tener hasta tres credenciales de certificado a la vez, de modo que se puede añadir un reemplazo antes de que caduque el anterior. Las credenciales deshabilitadas y las caducadas cuentan entre las tres hasta que las elimines.
Un perfil de certificado no tiene un secreto de aprovisionamiento que proteger ni rotar, porque el certificado es la prueba. Usa los mismos controles que el autorregistro: la estrategia, un tope de dispositivos, una caducidad y la revocación de lo que registró. Un tenant puede tener ocho perfiles de certificado.
El token derivado y el client id
Las sesiones MQTT se identifican por el client id, y la plataforma exige que sea {instanceId}:{tenant}:{deviceToken} para que un dispositivo no pueda apoderarse de la sesión de otro. Un dispositivo que se registra en la primera conexión aún no tiene token, así que la plataforma necesita un token que pueda calcular solo a partir del certificado, antes de escribir nada. El token de un dispositivo registrado desde un certificado es:
pv-{slug}-{hash}
sluges el nombre común con cada carácter que no sea letra, dígito,-o_sustituido por-, y sin-ni_al principio ni al final.hashson los primeros 12 caracteres hexadecimales del SHA-256 del nombre común.- El token completo tiene como máximo 128 caracteres; un
sluglargo se recorta para que quepa, y se elimina cualquier-o_que el recorte deje al final. - Si ningún carácter del nombre común llega al
slug, el token espv-{hash}.
Así, el firmware de un dispositivo puede calcular su propio client id a partir de su propio certificado. La guía tiene un ejemplo resuelto. Una conexión cuyo client id no coincide se rechaza antes de crear nada, de modo que una conexión rechazada nunca deja un dispositivo a medias.
Un dispositivo que creas de antemano y reservas para un perfil de certificado debe llevar este token. La consola y la API lo rellenan cuando dejas el token vacío, y rechazan uno distinto.
Qué perfil registra un dispositivo
Un certificado puede encadenar con las anclas de más de un perfil. Gana el perfil cuyo ancla está más cerca del certificado, de modo que un perfil anclado en un intermedio tiene prioridad sobre uno anclado en su raíz. Si dos perfiles utilizables empatan a la misma distancia, la conexión se rechaza en lugar de adivinar, y salta la alerta DeviceX509JitMisconfigured. Da a cada perfil su propio ancla, o ancla uno en una CA más estrecha.
El registro en la primera conexión crea dispositivos con la estrategia ALLOW_NEW. Con ALLOW_NEW, cualquier certificado que emita la CA del ancla, con un nombre común que ningún dispositivo haya usado, registra un dispositivo nuevo, hasta el maxDevices del perfil. Si eso es demasiado abierto, ancla en el intermedio más estrecho, fija un tope y deshabilita el ancla ante un compromiso. Adoptar un dispositivo que creaste y reservaste de antemano, y aceptar un certificado renovado para un dispositivo que ya tiene uno, todavía no están disponibles.
Cuánto dura una sesión
La sesión se concede hasta la notAfter más temprana entre el certificado del dispositivo, cada intermedio y el ancla de confianza (y la propia caducidad de la credencial, si la tiene). El broker cierra la sesión en ese momento. Un dispositivo que renueva su certificado se reconecta con el nuevo.
Revocación
| Necesitas | Haz esto | Surte efecto |
|---|---|---|
| Detener un dispositivo | Deshabilita o elimina su credencial X509_CERTIFICATE, o deshabilita el dispositivo | Al instante; se termina la sesión abierta |
| Detener una CA entera | Deshabilita el ancla de confianza | Al instante; se termina la sesión de todos los dispositivos que dependen de ella |
| Detener un certificado, hoja o intermedio, registrado o no | Revócalo por huella con revokeDeviceCertificate | Desde la siguiente conexión del certificado, en todas las réplicas; se terminan las sesiones abiertas que afecta |
| Detener los certificados que una CA ha revocado | Sube la lista de revocación (CRL) de la CA al ancla de confianza | Desde la siguiente conexión de cada certificado que la lista nombra; se terminan las sesiones abiertas de los certificados que nombra por primera vez |
| Detener un dispositivo que se registró solo | revokeProvisionedDevices o resetDeviceProvisioning, como con cualquier dispositivo autorregistrado | Al instante |
| Dejar que un certificado caduque | Emite certificados de corta duración | Exactamente al caducar el certificado |
Una revocación rechaza el certificado cuando se conecta y termina las sesiones abiertas que afecta. Revocar un certificado hoja, a mano o con una CRL que lo nombra, termina las sesiones de los dispositivos que lo tienen. Revocar una autoridad certificadora es más amplio: cuando das su certificado, o una CRL nombra un intermedio que se vio usar en la cadena de una credencial registrada, se terminan las sesiones de todos los dispositivos con una credencial de certificado bajo ese ancla de confianza, y los dispositivos cuya cadena sigue siendo de confianza se reconectan al instante. Una revocación manual por huella simple de un intermedio que ninguna credencial registrada usa, hasta donde se ha visto, rechaza las conexiones a través de él, solo bajo ese ancla, y no termina ninguna sesión, porque no se sabe que nada dependa de él. En una instancia actualizada desde una versión anterior, las credenciales registradas antes de la actualización no tienen intermedio registrado, así que una revocación así no puede saber qué sesiones afecta: el resultado dice sessionsEnded: false, y repetir la revocación con el certificado del intermedio (certificatePem) termina las sesiones de todos los dispositivos del ancla. Las sesiones se terminan al confirmarse la revocación y de nuevo entre 10 y 40 segundos después (la segunda pasada vence a los 10 segundos y se ejecuta en el siguiente ciclo de reintento, que corre cada 30 segundos), lo que atrapa a un dispositivo que se estaba admitiendo en ese instante. Si el servicio que termina las sesiones no puede confirmarlo, la revocación se mantiene; el resultado dice sessionsEnded: false y repetir la llamada vuelve a pedirlo. Consulta las notas de actualización.
Las CRL se suben, nunca se descargan. La plataforma no sigue un punto de distribución de CRL. (Consultar a un respondedor OCSP es una comprobación aparte y opcional, descrita más abajo.) Subes la lista vigente de la CA al ancla de confianza con putDeviceRevocationList (una lista de hasta 2 MiB por GraphQL) o con un PUT /trust-anchors/{token}/crl en streaming en la API de device-management, en DER o PEM. Por defecto, ambas vías comparten un límite de 2 MiB; la subida en streaming solo acepta listas mayores si aumentas deviceManagement.callout.revocation.maxCrlBytes (hasta 32 MiB). La plataforma comprueba la firma de la lista contra el ancla (o contra la cadena de emisor que envíes con ella) y conserva una lista vigente por emisor. Se rechaza una lista cuyo número de CRL no supere todos los aceptados antes para ese emisor, así que una lista antigua nunca puede reemplazar a una más nueva, ni siquiera después de borrar la lista. deleteDeviceRevocationList elimina una lista y los rechazos que traía.
Una revocación manual es decisión de la propia plataforma. revokeDeviceCertificate nombra un certificado por su PEM o su huella SHA-256 y, opcionalmente, un motivo. Se aplica dondequiera que el certificado aparezca en una ruta verificada, pase lo que pase después con su credencial o su dispositivo, de modo que borrar la credencial no permite que el certificado vuelva a registrarse. unrevokeDeviceCertificate la quita. Un ancla de confianza con revocaciones manuales no se puede borrar hasta quitarlas.
Cuán estricta es un ancla. Un ancla tiene un modo de revocación. ENTRIES (el valor por defecto) rechaza un certificado que nombre una lista guardada o una revocación manual y admite el resto, por antiguas que sean las listas, de modo que un ancla sin lista se comporta como antes de que existiera la revocación. REQUIRE_CURRENT rechaza además un certificado cuyo emisor no tenga una lista vigente; una lista cuenta como vigente hasta su nextUpdate más el periodo de gracia del ancla (revocationStaleGrace, hasta 168 horas). La plataforma se niega a pasar un ancla a REQUIRE_CURRENT mientras no tenga ninguna lista vigente, o mientras un certificado registrado lo haya emitido una CA que no la tiene, porque se rechazaría a todos esos dispositivos. Vigila el status de cada lista (FRESH, EXPIRING, STALE) y sube la siguiente antes de que caduque.
OCSP es una segunda comprobación opcional, por ancla de confianza, desactivada por defecto. Un ancla tiene un modo OCSP: OFF (el valor por defecto: no se consulta a ningún respondedor ni se envía ninguna petición), ENFORCE_KNOWN o REQUIRE_CURRENT. No se consulta nada hasta que se activa el interruptor de la instancia deviceManagement.callout.ocsp.enabled (desactivado por defecto), y REQUIRE_CURRENT necesita además allowRequireCurrent (desactivado por defecto) y un ocspResponderUrl en el ancla. La API rechaza pasar un ancla a un modo de comprobación mientras el interruptor está desactivado. Si luego se desactiva, un ancla ENFORCE_KNOWN funciona como OFF y un ancla REQUIRE_CURRENT rechaza las conexiones nuevas, porque ese modo nunca admite lo que no puede confirmar.
La comprobación se ejecuta después de las de cadena, caducidad, listas y revocación manual, así que un certificado que ya se rechaza no cuesta ninguna petición, y pregunta por cada certificado por debajo del ancla en cada camino verificado. Una respuesta revoked rechaza la conexión en ambos modos de comprobación. Una respuesta unknown, una mal formada o no verificable, y un respondedor inaccesible, lento u ocupado cuentan todos como ausencia de respuesta, y el modo decide qué significa eso: ENFORCE_KNOWN admite la conexión y la cuenta (x509_ocsp_unavailable_allowed_total), mientras que REQUIRE_CURRENT rechaza un certificado cuyo estado no pudo confirmar como vigente. Solo se guardan en caché las respuestas buenas, y solo durante un tiempo acotado.
La URL del respondedor sale de la entrada Authority Information Access del certificado, o del ocspResponderUrl del propio ancla, que un tenant fija con updateDeviceTrustAnchor y que sustituye a la entrada del certificado. Toda consulta pasa por la protección de salida (egress) de la plataforma. Una URL tomada de un certificado no recibe lista de permitidos del operador; solo el ocspResponderUrl de un ancla puede llegar a un destino que un operador haya permitido.
Límites actuales: una respuesta revoked rechaza esa conexión, pero todavía no termina las sesiones abiertas y no se escribe en el almacén de revocaciones, así que no se comparte con otros certificados ni réplicas más allá del propio rechazo. No hay actualización en segundo plano; una respuesta se obtiene cuando una conexión la necesita. Pasa las anclas a un modo de comprobación solo después de que haya terminado una actualización progresiva, porque las réplicas que aún no se han actualizado no comprueban OCSP y podrían admitir un certificado que otra réplica rechaza. Un rechazo por OCSP se cuenta en callout_x509_total como ocsp_revoked (una respuesta revocada) u ocsp_unavailable (REQUIRE_CURRENT no pudo confirmar).
Un rechazo por lista o por revocación manual se cuenta como cert_revoked, y uno por REQUIRE_CURRENT como revocation_unknown, en callout_x509_total. Los certificados de corta duración siguen siendo la revocación más barata; usa las listas y la revocación manual para el certificado que no puedes esperar a que caduque.
Lo que no se admite
- Restricciones de nombre. Una CA con restricciones de nombre se rechaza, como se explicó arriba.
- Descargar una CRL por cuenta propia, y OCSP que termine sesiones. Las listas se suben al ancla de confianza; la plataforma nunca descarga una. Existe una comprobación OCSP en la conexión, por ancla y desactivada por defecto, pero una respuesta revocada todavía no termina las sesiones abiertas ni actualiza el almacén de revocaciones, y no hay actualización en segundo plano. Consulta Revocación.
- Renovación por sí sola, y adoptar un dispositivo después de restablecer su aprovisionamiento. Un dispositivo que tiene un certificado y luego presenta otro distinto se rechaza (
ALREADY_PROVISIONED) cuando se conecta para registrarse. Hasta que llegue la renovación, añade el certificado nuevo como credencial fijada (un dispositivo puede tener tres) antes de que caduque el anterior. - Claves Ed25519 en el SDK de C#. El SDK presenta un certificado de cliente, pero .NET no tiene Ed25519, así que no puede presentar uno con ese tipo de clave.
- Ingesta HTTP y LwM2M. Ninguna se autentica con un certificado de cliente. Los dispositivos HTTP usan un token o una credencial básica, y los de LwM2M usan claves precompartidas. Un certificado presentado por MQTT con un usuario distinto de
{tenant}:@x509se ignora, y la conexión se juzga por su token o contraseña como antes. - Otros brokers. Solo el broker propio de la plataforma autentica por certificado. Un dispositivo que se conecta a través de un broker externo del operador no está cubierto.
- Certificados emitidos por la plataforma. Tú traes tu propia CA y tus propios certificados.