Docs /
... / Control de acceso / Inicio de sesión en túneles y certificados de dispositivo

Inicio de sesión en túneles y certificados de dispositivo

Controla quién puede acceder a tus túneles .odac.cc en app.odac.run. De forma predeterminada, los túneles requieren iniciar sesión con tu cuenta de ODAC, y puedes emitir certificados de dispositivo para scripts, aplicaciones o dispositivos que no pueden iniciar sesión de forma interactiva, y luego renovarlos o revocarlos según sea necesario.

Abrir el panel de Acceso de un túnel

  1. Abre Dominios en la barra lateral izquierda (consulta Ver dominios, uso de túneles y disponibilidad) y busca la fila de tu túnel .odac.cc (marcada con un icono de rayo y el interruptor verde Túnel activado). La insignia Acceso indica cómo se autentican los visitantes y muestra una descripción emergente al pasar el cursor:
    • Cuenta: Only you can reach this site, after signing in with your ODAC account. Click to add device certificates.
    • Cuenta / Cert.: ODAC account sign-in, plus devices with a certificate. Click to manage.
      Haz clic en cualquier parte de la fila del túnel (fuera del interruptor Túnel o del icono de enlace externo), o haz clic en su insignia Acceso, para abrir su configuración de acceso.

Tabla de Dominios que muestra dominios personalizados y dos filas de túnel con las insignias de Acceso Cuenta y Cuenta / Cert., con el puntero sobre la insignia Cuenta y su descripción emergente

  1. Se abre el panel de Acceso con el nombre de host del túnel en el subtítulo. Los túneles siempre mantienen habilitado el inicio de sesión con cuenta de ODAC (Open with your ODAC account sign-in, or with a device certificate.). Debajo, la sección Certificados de dispositivo indica For apps and scripts that cannot sign in. A certificate alone is enough, no sign-in needed. y muestra No device certificates yet. Issue one for each app or device that cannot sign in. hasta que crees uno.
    Si los certificados de dispositivo no están disponibles para el proyecto, el túnel no está activo o ningún nodo de borde del túnel está en línea, aparece un aviso de bloqueo en la parte superior del panel y Emitir certificado permanece deshabilitado hasta que se resuelva esa condición.

Panel de Acceso abierto para api-8c2e4b.odac.cc que muestra el aviso de inicio de sesión con cuenta de ODAC, la lista vacía de Certificados de dispositivo y el puntero sobre Emitir certificado

Emitir un certificado de dispositivo

  1. Haz clic en Emitir certificado para abrir el cuadro de diálogo Emitir un certificado de dispositivo. Introduce un Nombre (como Webhook worker) para identificar el script o dispositivo en la lista. En Da acceso a, el nombre de host del túnel aparece como una única etiqueta fija (The certificate opens this host only.). Elige una duración en Válido por (30 días, 90 días, 1 año de forma predeterminada o 2 años); luego escribe una Contraseña del archivo o haz clic en Generar una contraseña (el icono del dado) para crear una. Si el cliente genera su propia clave privada, haz clic en Tengo mi propia clave para pegar una Solicitud de certificado (CSR) en formato PEM (consulta Emitir e instalar un certificado de cliente).

Cuadro de diálogo Emitir un certificado de dispositivo superpuesto al panel de Acceso con Nombre establecido en Webhook worker, Da acceso a fijado en api-8c2e4b.odac.cc, 1 año seleccionado, una Contraseña del archivo generada y el puntero sobre Crear certificado

  1. Haz clic en Crear certificado. Una vez que finalicen los pasos de progreso, aparece Certificado listo con la fecha de expiración (Valid until ...). Si un nodo de borde del túnel no confirma a tiempo, el cuadro de diálogo muestra The tunnel edge did not confirm in time. Try again: the same request goes out, so you will not end up with two certificates.; haz clic en Reintentar para intentarlo de nuevo de forma segura o en Volver para regresar al formulario. Haz clic en el botón de descarga .p12 (por ejemplo, Descargar Webhook-worker.p12) y guarda en un lugar seguro tanto el archivo como la Contraseña del archivo, o sigue las pestañas macOS, iPhone y iPad, Windows, Android o Firefox para instalarlo en un dispositivo. Si usaste Tengo mi propia clave, descarga Certificado (.crt) y Cadena CA (-ca.crt) en su lugar. Haz clic en Listo al terminar.

Pantalla Certificado listo que muestra el aviso de clave privada, el botón Descargar Webhook-worker.p12 y las pestañas de instalación por dispositivo

  1. De vuelta en el panel de Acceso, el nuevo certificado aparece en Certificados de dispositivo con un punto de estado verde, su fecha de expiración y los botones Renovar y Revocar a la derecha. En la tabla Dominios detrás del panel, la insignia Acceso del túnel cambia de Cuenta a Cuenta / Cert..

Panel de Acceso para api-8c2e4b.odac.cc que muestra Webhook worker en Certificados de dispositivo con punto de estado verde, fecha de expiración, botón Renovar y botón Revocar

Renovar un certificado de dispositivo

  1. En Certificados de dispositivo, haz clic en Renovar (el icono de flecha circular) en la fila de un certificado activo. Solo los certificados de túnel activos muestran Renovar; los certificados de túnel expirados o revocados no se pueden renovar.
  2. En el cuadro de diálogo Renovar certificado, Nombre aparece rellenado y bloqueado con el del certificado al que reemplaza (A renewal keeps the name of the certificate it replaces.), y Da acceso a permanece fijado en el nombre de host del túnel. Elige una duración en Válido por, introduce o genera una Contraseña del archivo (o haz clic en Tengo mi propia clave) y haz clic en Renovar certificado.

Cuadro de diálogo Renovar certificado superpuesto al panel de Acceso con Nombre bloqueado en Webhook worker y el puntero sobre Renovar certificado

  1. En Certificado listo, descarga el nuevo archivo .p12 (o .crt y Cadena CA) y actualiza tu script o dispositivo. Debajo de las pestañas de instalación, Revocar el anterior permanece deshabilitado (Download the new file first) hasta que descargues un archivo .p12. Haz clic en Revocar el anterior cuando todos los clientes usen el reemplazo, o haz clic en Listo para dejar ambos activos durante la transición. En el panel de Acceso, el reemplazo muestra Renews <name> y la fila anterior muestra Renewed as <name>, revoke this one once every device has switched.

Panel de Acceso que muestra ambas filas de Webhook worker durante una transición de renovación con el puntero sobre el botón Revocar del certificado más antiguo

Revocar un certificado de dispositivo y sincronización con nodos de borde sin conexión

  1. Para bloquear un certificado de dispositivo de inmediato, haz clic en Revocar (el icono del escudo tachado) en cualquier fila activa o expirada en Certificados de dispositivo, o haz clic en Revocar el anterior después de renovar. Incluso cuando ningún nodo de borde del túnel está en línea, Revocar permanece habilitado para que las revocaciones se registren al instante.
  2. En el cuadro de diálogo de confirmación Revocar certificado, revisa la advertencia (Every device using <name> is refused on its next request, and its open connections, WebSockets included, are closed. This cannot be undone.) y haz clic en Revocar (o en Cancelar para mantener activo el certificado).

Modal de confirmación Revocar certificado superpuesto al panel de Acceso para Webhook worker con el puntero sobre Revocar

  1. Cuando todos los nodos de borde del túnel reciben la actualización de inmediato, aparece Certificate revoked y el certificado pasa a Expirados y revocados (<cantidad>). Si un nodo de borde está sin conexión o aún está recibiendo la revocación:
    • Una notificación indica Revoked. The revocation is reaching every edge.
    • Un aviso ámbar sobre la lista en el panel de Acceso informa de la sincronización pendiente, como A revocation is waiting for an edge node that is offline. It applies as soon as the node reconnects.
    • Al expandir Expirados y revocados (<cantidad>) se muestra Still reaching one edge node (o Still reaching <count> edge nodes) debajo del certificado revocado hasta que todos los nodos vuelvan a conectarse.
      Cuando no quedan certificados de dispositivo activos en el túnel, su insignia Acceso en Dominios vuelve a Cuenta.

Panel de Acceso para api-8c2e4b.odac.cc que muestra el aviso de bloqueo por nodo de borde sin conexión, el botón Emitir certificado deshabilitado, el aviso ámbar de revocación sin conexión, la fila activa CI deploy con Revocar aún habilitado y Expirados y revocados expandido con Aún llegando a un nodo de borde