Todas las páginas
En esta página

Seguridad: tokens de agente, sesiones del navegador y claves de relay Nuevo en 0.9.27

Un relay tiene una sola persona que responde por él: tú. Desde 0.9.27, todo lo demás que habla con el relay tiene una credencial propia con menos alcance. Los agentes reciben un token propio, cada navegador guarda una sesión en lugar del token del relay y los relays emparejados inician sesión con claves. Esta página explica qué puede hacer cada uno, qué ves en Settings → Security (Ajustes → Seguridad) y qué sigue abierto. Para saber qué expone un relay en general, consulta el Resumen de seguridad.

Quién tiene qué #

Credencial Quién la tiene Qué abre
El token del relay Tú, en tu gestor de contraseñas. El relay solo guarda su hash Todo. Con él inicias sesión en un navegador y emparejas relays
Una sesión del navegador Cada navegador con sesión iniciada, en su cookie, con una clave de comprobación en el almacenamiento de la página Lo que puedes hacer en la interfaz web
Un token de agente Cada sesión (OAR_AGENT_TOKEN) y el comando oar Las rutas que necesitan los agentes, ninguna de las tuyas
Una clave de relay Un relay emparejado, una clave por sentido Solo las rutas por las que los relays se llaman entre sí
Un enlace de inicio de sesión Quien lo reciba de ti, una vez, durante 10 minutos Una sesión del navegador nueva

Qué pueden hacer los agentes y qué es tuyo #

El entorno de cada sesión recibe OAR_AGENT_TOKEN, un token ligado a la conversación de esa sesión. Con él llaman al relay el worker de la sesión, su CLI y sus herramientas, y las herramientas de agente propias de OAR. Los agentes ya no encuentran el token del relay en ninguna parte: ni en el entorno, ni en la línea de comandos, ni en config.json, ni en los registros, ni en una transcripción.

Un token de agente puede:

  • leer sesiones, ajustes y consumo;
  • enviar prompts a sesiones, detenerlas, archivarlas, compactarlas y relanzarlas, y ejecutar sus propios turns;
  • mostrar sus propias tarjetas de pregunta y de plan;
  • usar relay_tool, los eventos del relay y las programaciones;
  • usar archivos, unidades, git y archivos subidos, y las vistas previas de su propia conversación;
  • mover una sesión a un grupo existente o sacarla de uno;
  • poner en cola un reinicio del relay con un motivo, y cancelarlo.

Esto es solo tuyo, y un token de agente recibe 403 AUTH_PERSON_REQUIRED:

  • responder o descartar cualquier tarjeta de pregunta, incluida una normal de otra conversación, un Safety check, una tarjeta de aprobación o una tarjeta de plan. answer_question de relay_tool dice Only the person can answer questions; ask them in the relay UI;
  • la Inbox;
  • los ajustes, los inicios de sesión en proveedores, los emparejamientos, los dispositivos push y los enlaces compartidos;
  • eliminar una sesión, y crear, renombrar o eliminar grupos;
  • un reinicio inmediato, un apagado simple, las actualizaciones y las instalaciones;
  • la conexión en vivo de la interfaz web.

El token de una sesión actúa solo para esa sesión: relay_tool rechaza una llamada para otra conversación (AUTH_CONVERSATION_MISMATCH), y un agente solo inicia sesiones nuevas mediante create_session de relay_tool, donde se aplican tu Allow (Permitir) y el límite de sesiones. Cuando un agente fija owner_approved, el relay lo ignora.

Los scripts que ejecutas en el host del relay usan los mismos tokens: dentro de una sesión, Authorization: Bearer $OAR_AGENT_TOKEN; fuera de una, oar agent-token imprime un token. Ninguno de los dos es el token del relay. Un script que no envía ningún token recibe 401 The relay token is no longer in the config; use OAR_AGENT_TOKEN.

Sesiones del navegador #

Al iniciar sesión, el token del relay se canjea una vez, en el cuadro de inicio de sesión o mediante una dirección de inicio de sesión, por una sesión de ese navegador. A partir de ahí, la cookie del navegador guarda la sesión, nunca el token, y el relay solo guarda un hash de ella.

  • Duración. Una sesión dura 30 días desde su último uso y 400 días como máximo. El relay guarda 50 como máximo; una nueva desplaza a la que lleva más tiempo sin usarse.
  • La clave de comprobación. Al iniciar sesión, la página recibe también un segundo secreto, que guarda en su propio almacenamiento y envía con cada solicitud. Un navegador envía la cookie del relay a todos los puertos del host del relay, así que un servidor de desarrollo que un agente ejecute allí la recibe cuando abres ese servidor. Sin la clave de comprobación, la cookie no abre nada salvo los adjuntos, las imágenes generadas y el contenido multimedia que un navegador carga por sí solo (consulta Límites de esta protección). Borrar los datos del sitio en el navegador elimina la clave: ese navegador vuelve a iniciar sesión.
  • La clave se queda con el relay. La página envía la clave de comprobación solo a la dirección propia del relay, puerto incluido, bajo /api/. Una imagen que un agente pone en una respuesta desde otra dirección, incluido otro puerto del host del relay, nunca la recibe, y no tiene 🖍️ en el visor.
  • Archivos por ruta. Un archivo que la página abre por su ruta (una imagen, un vídeo, una descarga, un PDF en una pestaña nueva) lleva un permiso de archivo, k, en su dirección. La página lo pide con su clave de comprobación. Abre ese único archivo, solo junto con la cookie de este navegador, durante 10 minutos como máximo, y la página lo renueva cuando hace falta, así que un vídeo largo sigue reproduciéndose. Un enlace de archivo copiado fuera de la página deja de funcionar después. Un k erróneo o caducado recibe 403 AUTH_FILE_CAPABILITY, la misma respuesta sea cual sea la ruta, así que no revela nada sobre los archivos.
  • Las direcciones multimedia llevan una etiqueta. La galería multimedia entrega cada dirección con una etiqueta t; una dirección multimedia sin su etiqueta recibe 404, la pida quien la pida, así que una cookie copiada no puede recorrer el contenido multimedia. La etiqueta no caduca, pero cuando se sustituye relay-secrets.json, las direcciones multimedia antiguas dejan de funcionar y la galería entrega otras nuevas.
  • Los navegadores de antes de 0.9.27 guardan el token en su cookie. Esa cookie ya no abre nada: cuando la página arranca, la canjea una vez por una sesión y su clave de comprobación, sin el cuadro de inicio de sesión. Una pestaña que quedó abierta desde antes de la actualización ejecuta la página antigua y necesita recargarse una vez.
  • Sesión cerrada. Un navegador cuya sesión ya no vale muestra This browser was signed out en su página de inicio de sesión; una notificación que respondes desde él dice Signed out, open OAR.
  • Los scripts no crean sesiones. Una solicitud con el token del relay en una cabecera Authorization actúa como tú sin sesión y nunca añade un navegador a la lista.

Settings → Security #

Settings → Security trata de quién puede usar este relay. Ni los agentes ni los relays emparejados pueden abrirlo.

  • Browsers signed in (Navegadores con sesión iniciada) lista cada navegador con una sesión aquí, este primero y marcado this browser (este navegador): su nombre, sacado del navegador y el sistema que indicó hasta que lo cambies con Rename (Renombrar); cuándo y cómo inició sesión (el token del relay, un enlace de inicio de sesión, la terminal o traspasado de antes de las sesiones), cuándo se vio por última vez y su última dirección. Un navegador cuya última solicitud llegó al relay desde su propio host a través de un proxy o un túnel allí muestra this host (forwarded for …) (este host, reenviado para …), con la dirección reenviada entre paréntesis.
  • Sign out (Cerrar sesión) en una fila termina al instante la sesión de ese navegador, cierra su conexión en vivo y detiene sus notificaciones push. Sign out all other browsers (Cerrar sesión en todos los demás navegadores) deja solo este; Sign out this browser (Cerrar sesión en este navegador) muestra aquí el cuadro de inicio de sesión. Cada uno pregunta antes.

Avisos de nuevos inicios de sesión #

Cuando un navegador inicia sesión con el token del relay, un enlace de inicio de sesión o la terminal, todos los demás navegadores con sesión iniciada reciben un aviso antes de que el inicio de sesión se complete:

  • una sola fila en el banner bajo la cabecera, sean cuantos sean: New browser signed in: ,
    , via …, con Sign it out (Cerrar su sesión) y Got it (Entendido), o 3 new browsers signed in (latest: …). Show all (Mostrar todo) abre la lista sobre la conversación, cada navegador con cómo y cuándo inició sesión y Sign it out; un solo Got it los descarta todos;
  • una notificación push New browser signed in, también mientras un dispositivo tiene la app abierta, a cada dispositivo que tenga una sesión distinta de la nueva. Tiene una acción Sign it out, y un toque abre Settings → Security. Varias en 5 minutos se sustituyen entre sí. El interruptor es A new browser signed in (Un navegador nuevo inició sesión) en Settings → Notifications (Ajustes → Notificaciones).

Un inicio de sesión que llega al relay desde su propio host a través de un proxy o un túnel allí muestra this host (este host), con la dirección reenviada entre paréntesis, nunca esa dirección sola.

El relay guarda los avisos 7 días. Cada navegador los descarta solo para sí mismo, así que una sesión nueva no puede ocultar a los demás su propio inicio de sesión. Un navegador que vuelve a iniciar sesión ve de nuevo los avisos de los últimos 7 días, incluidos los que había descartado. El aviso de un inicio de sesión desde la terminal se mantiene mientras ese navegador tenga la sesión iniciada, por muchos inicios de sesión que vengan después.

Iniciar sesión en otro dispositivo #

Ya no hace falta escribir el token del relay en un teléfono.

  1. En un navegador con sesión iniciada, abre Settings → Security → Sign in another device (Ajustes → Seguridad → Iniciar sesión en otro dispositivo) y pulsa Make a sign-in link (Crear un enlace de inicio de sesión).
  2. Abre el enlace en el otro dispositivo, o pulsa Show QR code (Mostrar el código QR) y escanéalo con la cámara de ese dispositivo.

El enlace (…/?signin=…) inicia sesión en un navegador, una vez, en un plazo de 10 minutos. La pestaña muestra cuánto tiempo le queda. Quien lo abra primero inicia sesión, así que muéstralo o envíalo solo donde nadie más que tú pueda verlo. El código QR se oculta de nuevo al cabo de un minuto, cuando sales de la página o cierras los ajustes, en cuanto el enlace se usa o caduca, y con Hide QR code (Ocultar el código QR). Un enlace nuevo anula el anterior, y un reinicio del relay también lo anula.

En el host del relay, oar url --sign-in imprime en una terminal un enlace así y su código QR, para la dirección a la que llega un teléfono. El relay crea como máximo 3 de estos en 10 minutos, y uno nuevo sustituye al anterior, que deja de funcionar; el comando lo indica. La lista de navegadores dice from the terminal (oar url --sign-in) para un navegador que inició sesión de esta forma.

Dos relays a los que se llega con el mismo nombre de host y distintos puertos (host:3333, host:3334) comparten una cookie de inicio de sesión en un navegador y se cierran la sesión el uno al otro. Da a cada uno su propio nombre de host.

El token del relay #

El token del relay es la credencial de la persona: guárdalo en tu gestor de contraseñas. El relay solo guarda su hash, en relay-secrets.json en la carpeta de datos; consulta Dónde están los secretos. Los tokens nuevos empiezan por oaro1_; un token de una versión anterior sigue funcionando.

  • Se muestra una sola vez. oar setup en una terminal muestra un token nuevo una vez, con un enlace de inicio de sesión y un código QR. Sin terminal (un servicio, un script, un agente) nada imprime un token, porque esa salida acaba en registros que los agentes pueden leer.
  • oar url no imprime ningún token. El relay no puede: solo tiene el hash.
  • ¿Lo perdiste? Inicia sesión en otro dispositivo desde un navegador que siga con la sesión iniciada, o sustituye el token. Sin ningún navegador con sesión iniciada, ejecuta oar setup --new-token en una terminal en el host del relay.

Generar un nuevo token del relay #

Settings → Security → Relay token (Ajustes → Seguridad → Token del relay) indica si hay un token fijado, que el relay solo guarda su hash, y cuándo se creó o se sustituyó por última vez. Generate new relay token (Generar un nuevo token del relay) pregunta antes, The current token stops working at once. Signed-in browsers stay signed in; agents keep working., y luego muestra el token nuevo una vez:

  • oculto hasta que pulsas Show (Mostrar), con Save in password manager (Guardar en el gestor de contraseñas), con el que tu gestor de contraseñas se ofrece a guardarlo con el nombre del relay, Copy (Copiar) y Copy pairing link (Copiar el enlace de emparejamiento);
  • cuándo usó el token antiguo por última vez algo que no era una página del navegador, como un script o un relay emparejado más antiguo, y desde qué dirección;
  • los relays emparejados que aún llaman con el token antiguo, cada uno con Open there (Abrir allí), que abre Settings → Relays (Ajustes → Relays) de ese relay con Add a relay (Añadir un relay) listo para el enlace de emparejamiento. Los relays que inician sesión con una clave siguen funcionando y no aparecen en la lista.

Al cerrar el cuadro de diálogo, el token desaparece de la página. Borra el portapapeles después de pegarlo: el historial del portapapeles lo conserva.

Qué cambia al instante: el token antiguo deja de funcionar. Los navegadores con sesión iniciada la conservan, los agentes, sus tokens y los workers de sesión siguen trabajando, y los relays emparejados con clave siguen funcionando. Un script que enviaba el token antiguo necesita el nuevo o, mejor, OAR_AGENT_TOKEN. En una terminal, oar setup --new-token hace lo mismo después de que escribas NEW, y reinicia el relay.

Un relay que 0.9.26 o anterior arrancó mediante oar copilot, o uno arrancado con un --token manual, conserva el token antiguo en la línea de comandos de su supervisor hasta que se detiene y se arranca una vez. Hazlo antes de generar un token nuevo; consulta las notas de actualización.

Tras actualizar a 0.9.27, un banner bajo la cabecera dice Your relay token was readable by agents until this version. Generate a new one. Generate new token (Generar un nuevo token) abre el cuadro de diálogo anterior; Dismiss (Descartar) lo oculta, una vez para todo el relay. Mientras se siga recomendando un token nuevo después de descartar el banner, la pestaña Security conserva un pequeño punto y la fila del token una etiqueta Recommended (Recomendado), hasta que sustituyas el token.

El banner también dice The relay token was changed outside OAR cuando el token cambió sin que lo hiciera el relay: un authToken vuelto a poner en config.json, o un relay-secrets.json modificado. Descártalo si fuiste tú; si no, genera un token nuevo. Solo lo muestra tu propia página con sesión iniciada, nunca una vista compartida.

Archivos que el relay nunca sirve #

Sea cual sea la credencial, incluido el token del relay, las rutas de archivos de OAR nunca sirven ni cambian los archivos propios del relay: relay-secrets.json, la base de datos (oar.db con sus archivos -wal y -shm, sus copias de seguridad y una copia de seguridad que se esté escribiendo) y config.json. Responden 403 FILE_PROTECTED. El explorador de archivos no puede renombrarlos, moverlos ni eliminarlos, ni tampoco una carpeta que contenga alguno, y la galería multimedia nunca sirve uno que nombre un mensaje. Un enlace o un enlace duro a uno de ellos también se rechaza. Esto los mantiene fuera solo de las rutas de archivos: la propia shell de un agente aún puede leerlos (consulta Límites de esta protección).

Relays emparejados #

Los relays emparejados ya no guardan el token del relay del otro. Con 0.9.27 o posterior en ambos, el emparejamiento usa una vez el token del enlace de emparejamiento del otro relay para intercambiar claves. A partir de ahí, cada relay inicia sesión en el otro con su propia clave, que abre solo las rutas por las que los relays se llaman entre sí: nunca ajustes, archivos, emparejamiento, la facturación de una sesión ni responder a una tarjeta o a una pregunta (403 REMOTE_RELAY_PEER_SCOPE). Sustituir el token de un relay ya no rompe un emparejamiento con clave. Los relays emparejados antes pasan a claves por sí solos en un minuto más o menos, una vez que ambos ejecutan 0.9.27.

  • En ambos sentidos. Con Also add this relay there (Añadir también este relay allí) marcado, cada relay recibe una clave del otro.
  • En un solo sentido. Sin marcar, el token del enlace se usa solo para añadirlo, en memoria, y nunca se guarda. El otro relay da a este una clave solo entrante y lo lista como Inbound only (Solo entrante): nunca llama a este relay, y su Remove (Quitar) revoca la clave al instante. Aquí la fila dice One way (En un solo sentido).
  • El token mientras añades. Con 0.9.27 en ambos, el token del enlace se mantiene solo en memoria mientras se añade el relay, y nunca se escribe en la base de datos en cuanto una clave funciona. Solo lo guarda una adición que termina sin una clave que funcione (un relay más antiguo, o un intercambio fallido), hasta que una clave funcione. Un token guardado y descartado así puede seguir legible en las páginas libres de la base de datos y en su oar.db-wal hasta que SQLite las reutilice; si eso te importa, sustituye el token de ese relay.
  • Re-pair (Volver a emparejar) en Settings → Relays vuelve a intercambiar claves con un clic. Cuando nada de lo que tiene este relay funciona ya allí, o el otro relay es más antiguo, abre Add a relay con la dirección rellenada: pega el enlace de emparejamiento de ese relay y la entrada se actualiza en el sitio.
  • Renew key (Renovar la clave) y Revoke key (Revocar la clave) actúan sobre un relay. Las claves se renuevan solas cada 30 días. Una clave revocada sigue anulada hasta que la renuevas, o hasta que ese relay se vuelve a añadir desde el enlace de emparejamiento de este relay, lo que le da de nuevo una clave que funciona. Solo quitar el relay y generar un nuevo token del relay lo dejan fuera para siempre.

Orígenes verificados y no verificados #

Un prompt de un relay emparejado nombra al relay cuya clave inició la sesión, con el nombre que le diste aquí, nunca con lo que la solicitud dice de sí misma.

  • Verificado. Un prompt que llegó con una clave. Puede hacer lo que permitan los límites.
  • No verificado. Un relay sin una clave confirmada aquí (un OAR anterior a 0.9.27, o una clave aún no confirmada) sigue llegando a sus sesiones, pero su prompt muestra una etiqueta claimed (no verificado), el agente lee «(unverified)» en su línea de cabecera, y no abre nada: ni acceso a respuestas, ni margen de saltos, ni supresión de notificaciones push, ni preguntas ni vigilancias. Al agente que envía se le explica por qué. Los prompts guardados antes de 0.9.27 también se leen como no verificados.
  • Declaraciones rechazadas. Una clave que dice ser otro relay se rechaza (REMOTE_RELAY_ORIGIN_MISMATCH), igual que cualquier otra credencial que dice ser un relay que tiene clave (REMOTE_RELAY_PEER_KEY_REQUIRED). Cada rechazo se registra y se cuenta en la fila de ese relay, N refused claims since start, y el primero de cada relay deja un aviso en la Inbox.
  • Una identidad cambiada queda retenida. En cuanto un relay tiene clave, o este relay tiene una clave suya, su dirección y su id de relay quedan fijados. Si cambian, u otro relay responde en su dirección, sus claves se revocan, este relay no le envía nada de lo que guarda para él (la clave que dio a este relay, o un token) y no se emite nada nuevo hasta que pulses Confirm (Confirmar) en su fila. Volver a poner la dirección con la que recibió la clave levanta una retención que solo causó el cambio de dirección.

Las preguntas de un relay emparejado se responden en ese relay, con la sesión iniciada allí. La Inbox las muestra en solo lectura con Open there y, para un relay con 0.9.27, con botones de opción que abren la pregunta allí en una ventana pequeña; consulta Preguntas y la Inbox.

Ediciones de archivos sensibles #

Las sesiones de Claude, Claude API y DeepSeek te preguntan antes de editar un archivo que Claude Code marca como sensible, porque un cambio allí puede alterar cómo se comporta git, una shell o una herramienta: los archivos de arranque de la shell como .bashrc, .npmrc y cualquier cosa bajo .git/ o .claude/, entre otros. Una edición así espera en una tarjeta Safety check en todos los modos del relay, autopilot incluido, con el archivo y el cambio completo, y Allow once (Permitir una vez) y Deny (Denegar). Solo tú puedes responderla: un token de agente y la clave de un relay emparejado se rechazan. Nunca permite más que esa única edición, y una tarjeta sin responder deja el archivo sin cambios. Un agente o un relay emparejado que vigila la sesión solo recibe la primera línea fija de la tarjeta y la línea File:, nunca el cambio.

Leer un archivo así, o enviarlo a través del relay, no pregunta nada, y tampoco lo hace un comando que lo escribe de una forma que Claude Code no marca. La tarjeta es una comprobación de las ediciones del agente, no un sandbox.

Límites de esta protección #

Los tokens de agente separan las herramientas de los agentes de las tuyas. No son un sandbox: un agente se ejecuta con el mismo usuario del sistema operativo que el relay, y ese usuario aún puede hacer lo siguiente.

  • Cambiar los archivos del relay. Un agente puede escribir relay-secrets.json, config.json, la base de datos o el código del relay, luego poner en cola un reinicio, y así instalar un token propio. El relay solo lo detecta: al arrancar compara el hash del token con una copia en su base de datos e informa The relay token was changed outside OAR. Un agente que edite ambos puede saltarse eso. Con el mismo archivo también puede crear el token de agente de cualquier sesión. Las rutas de archivos rechazan estos archivos, pero la shell de un agente no las usa.
  • Usar las vías de la terminal. Las comprobaciones de terminal de oar setup --new-token y oar url --sign-in son un obstáculo, no una frontera: un agente puede simular una terminal o llamar a la ruta con oar agent-token. Un inicio de sesión hecho así se anuncia a todos los demás navegadores, como arriba, y aparece como «via the terminal» en la lista de navegadores. Cierra la sesión de ese navegador y luego sustituye el token.
  • Tomar la sesión de un navegador en el host del relay. Un navegador en la misma máquina y con el mismo usuario guarda su cookie y su clave de comprobación donde ese usuario puede leerlas. Juntas son una sesión completa: quien las tenga puede hacer lo mismo que tú en la interfaz web, incluido crear un token nuevo. Para recuperarte, genera un nuevo token del relay, inicia sesión con él y luego pulsa Sign out all other browsers. Un token nuevo por sí solo no cierra la sesión de ningún navegador.
  • Leer el contenido que solo pide la cookie. Los adjuntos, las imágenes generadas y el contenido multimedia indexado que un navegador carga por sí solo, por su id o su hash, siguen abriéndose solo con la cookie, sin la clave de comprobación, así que un servidor en otro puerto del host que reciba tu cookie puede descargarlos. Los archivos por ruta no están entre ellos: necesitan la clave de comprobación o un permiso de archivo. Un token de agente lee todo esto de todos modos.
  • Leer las credenciales de los relays emparejados que este relay guarda en su base de datos, y un token que guardó una vez para uno, que puede quedar en las páginas libres de la base de datos. Una clave solo abre allí las rutas de relay, y Revoke key en ese relay la anula.
  • Encontrar una copia antigua del token de antes de 0.9.27: el historial de la shell, una copia de seguridad, un config.json copiado, o la línea de comandos del supervisor de un relay que arrancó oar copilot de una versión anterior o un --token manual, hasta que ese relay se detenga y se arranque una vez. Si antes se ejecutaron agentes en este relay, genera un token nuevo después de actualizar.
  • Detener el relay. Un proceso del mismo usuario puede terminarlo, así que las comprobaciones del comando oar antes de una parada son una comodidad, no una protección.

El token del relay en sí sigue abriendo todo, para quien lo tenga.