Sécurité : tokens d’agent, sessions de navigateur et clés de relais Ajouté en 0.9.27
Un relais a une seule personne qui en répond : vous. Depuis la 0.9.27, tout ce qui parle au relais a un identifiant à lui, de moindre portée. Les agents reçoivent un token à eux, chaque navigateur détient une session plutôt que le token du relais, et les relais associés se connectent avec des clés. Cette page dit ce que chacun peut faire, ce que vous voyez dans Settings → Security (Réglages → Sécurité), et ce qui reste ouvert. Pour ce qu’un relais expose en général, voir Vue d’ensemble de la sécurité.
Qui détient quoi #
| Identifiant | Qui le détient | Ce qu’il ouvre |
|---|---|---|
| Le token du relais | Vous, dans votre gestionnaire de mots de passe. Le relais n’en garde que le hash | Tout. Vous connectez un navigateur avec lui et associez des relais avec lui |
| Une session de navigateur | Chaque navigateur connecté, dans son cookie, avec une clé de preuve dans le stockage de la page | Ce que vous pouvez faire dans l’interface web |
| Un token d’agent | Chaque session (OAR_), et la commande oar |
Les routes dont les agents ont besoin, aucune des vôtres |
| Une clé de relais | Un relais associé, une clé par sens | Seulement les routes par lesquelles les relais s’appellent |
| Un lien de connexion | La personne à qui vous le donnez, une fois, pendant 10 minutes | Une nouvelle session de navigateur |
Ce que les agents peuvent faire, et ce qui vous revient #
L’environnement de chaque session reçoit OAR_, un token lié à la
conversation de cette session. Le worker de la session, sa CLI et ses outils, ainsi que les
propres outils d’agent d’OAR appellent le relais avec lui. Les agents ne trouvent plus le token du relais
nulle part : ni dans l’environnement, ni sur la ligne de commande, ni dans config., les journaux ou
un fil de conversation.
Un token d’agent peut :
- lire les sessions, les réglages et la consommation ;
- envoyer un prompt à des sessions, les arrêter, les archiver, les compacter et les relancer, et exécuter ses propres turns ;
- afficher ses propres cartes de question et de plan ;
- utiliser
relay_, les événements du relais et les planifications ;tool - utiliser les fichiers, les lecteurs, git et les fichiers envoyés, ainsi que les aperçus de sa propre conversation ;
- faire entrer une session dans un groupe existant ou l’en sortir ;
- mettre un redémarrage du relais en file avec une raison, et l’annuler.
Ceci vous revient à vous seul, et un token d’agent reçoit 403 AUTH_ :
- répondre à une carte de question ou l’ignorer, y compris une carte ordinaire d’une autre
conversation, un Safety check,
une carte d’approbation ou une carte de plan.
answer_dequestion relay_répond Only the person can answer questions; ask them in the relay UI ;tool - l’Inbox ;
- les réglages, les connexions aux fournisseurs, les associations, les appareils push et les liens partagés ;
- supprimer une session, et créer, renommer ou supprimer des groupes ;
- un redémarrage immédiat, un simple arrêt, les mises à jour et les installations ;
- la connexion en direct de l’interface web.
Le token d’une session n’agit que pour cette session : relay_ refuse un appel pour
une autre conversation (AUTH_), et un agent ne démarre de nouvelles
sessions que par create_ de relay_, où s’appliquent votre Allow (Autoriser)
et la limite de sessions. Quand un agent définit owner_, le relais
l’ignore.
Les scripts que vous exécutez sur l’hôte du relais utilisent les mêmes tokens : dans une session,
Authorization: Bearer $OAR_ ; hors d’une session,
oar agent- affiche un token.
Aucun des deux n’est le token du relais. Un script qui n’envoie aucun token reçoit 401 The relay
token is no longer in the config; use OAR_AGENT_TOKEN.
Sessions de navigateur #
La connexion échange une fois le token du relais, dans la boîte de connexion ou par une adresse de connexion, contre une session de ce navigateur. Dès lors, le cookie du navigateur contient la session, jamais le token, et le relais n’en garde qu’un hash.
- Durée de vie. Une session dure 30 jours après sa dernière utilisation et 400 jours au plus. Le relais en garde au plus 50 ; une nouvelle évince celle utilisée le moins récemment.
- La clé de preuve. La connexion donne aussi à la page un second secret, qu’elle garde dans son propre stockage et envoie avec chaque requête. Un navigateur envoie le cookie du relais à tous les ports de l’hôte du relais : un serveur de dev qu’un agent y fait tourner le reçoit donc quand vous ouvrez ce serveur. Sans la clé de preuve, le cookie n’ouvre rien d’autre que les pièces jointes, les images générées et les médias qu’un navigateur charge de lui-même (voir Limites de cette protection). Effacer les données du site dans le navigateur supprime la clé : ce navigateur se reconnecte.
- La clé reste au relais. La page n’envoie la clé de preuve qu’à l’adresse propre du
relais, port compris, sous
/. Une image qu’un agent place dans une réponse depuis une autre adresse, y compris un autre port de l’hôte du relais, ne la reçoit jamais, et n’a pas de 🖍️ dans la visionneuse.api/ - Fichiers par chemin. Un fichier que la page ouvre par son chemin (une image, une vidéo, un
téléchargement, un PDF dans un nouvel onglet) porte une autorisation de fichier,
k, dans son adresse. La page la demande avec sa clé de preuve. Elle ouvre ce seul fichier, uniquement avec le cookie de ce navigateur, pendant 10 minutes au plus, et la page la renouvelle au besoin : une longue vidéo continue donc. Un lien de fichier copié hors de la page cesse ensuite de fonctionner. Unkerroné ou expiré reçoit403 AUTH_, la même réponse quel que soit le chemin : il ne révèle donc rien des fichiers.FILE_ CAPABILITY - Les adresses de médias portent une étiquette. La galerie de
médias donne chaque adresse avec une étiquette
t; une adresse de média sans son étiquette reçoit404, quel que soit le demandeur : un cookie copié ne peut donc pas parcourir les médias. L’étiquette n’expire pas, mais quandrelay-est remplacé, les anciennes adresses de médias cessent de fonctionner et la galerie en donne de nouvelles.secrets. json - Les navigateurs d’avant la 0.9.27 gardent le token dans leur cookie. Ce cookie n’ouvre plus rien : au démarrage de la page, elle l’échange une fois contre une session et sa clé de preuve, sans la boîte de connexion. Un onglet resté ouvert depuis avant la mise à jour exécute l’ancienne page et doit être rechargé une fois.
- Déconnecté. Un navigateur dont la session ne compte plus affiche This browser was signed out sur sa page de connexion ; une notification à laquelle vous répondez depuis lui indique Signed out, open OAR.
- Les scripts ne créent pas de sessions. Une requête avec le token du relais dans un
en-tête
Authorizationagit en votre nom sans session et n’ajoute jamais de navigateur à la liste.
Settings → Security (Réglages → Sécurité) #
Settings → Security concerne qui peut utiliser ce relais. Les agents et les relais associés ne peuvent pas l’ouvrir.
- Browsers signed in (Navigateurs connectés) liste chaque navigateur qui a une session ici, celui-ci en premier et marqué this browser (ce navigateur) : son nom, tiré du navigateur et du système qu’il a signalés jusqu’à ce que vous le renommiez avec Rename (Renommer) ; quand et comment il s’est connecté (le token du relais, un lien de connexion, le terminal, ou repris d’avant les sessions), quand il a été vu pour la dernière fois et sa dernière adresse. Un navigateur dont la dernière requête a atteint le relais depuis son propre hôte, par un proxy ou un tunnel qui s’y trouve, affiche this host (forwarded for …) (cet hôte, relayé pour …), avec l’adresse relayée entre parenthèses.
- Sign out (Se déconnecter) sur une ligne met aussitôt fin à la session de ce navigateur, ferme sa connexion en direct et arrête ses notifications push. Sign out all other browsers (Déconnecter tous les autres navigateurs) ne garde que celui-ci ; Sign out this browser (Déconnecter ce navigateur) fait apparaître la boîte de connexion ici. Chacun demande d’abord.
Avis de nouvelle connexion #
Quand un navigateur se connecte avec le token du relais, un lien de connexion ou le terminal, tous les autres navigateurs connectés en sont avertis avant la fin de la connexion :
- une seule ligne dans la bannière sous l’en-tête, quel que soit leur nombre : New
browser signed in:
, , via … , avec Sign it out (Le déconnecter) et Got it (Compris), ou 3 new browsers signed in (latest: …). Show all (Tout afficher) ouvre la liste par-dessus la conversation, chaque navigateur avec la façon et le moment de sa connexion et Sign it out ; un seul Got it les ignore tous ; - une notification push New browser signed in, même quand un appareil a l’app ouverte, à chaque appareil qui détient une session autre que la nouvelle. Elle a une action Sign it out, et un appui ouvre Settings → Security. Plusieurs en moins de 5 minutes se remplacent l’une l’autre. L’interrupteur est A new browser signed in (Un nouveau navigateur s’est connecté) dans Settings → Notifications (Réglages → Notifications).
Une connexion qui atteint le relais depuis son propre hôte, par un proxy ou un tunnel qui s’y trouve, affiche this host, avec l’adresse relayée entre parenthèses, jamais cette adresse seule.
Le relais garde les avis pendant 7 jours. Chaque navigateur les ignore pour lui seul, si bien qu’une nouvelle session ne peut pas cacher sa propre connexion aux autres. Un navigateur qui se reconnecte voit de nouveau les avis des 7 derniers jours, y compris ceux qu’il avait ignorés. L’avis d’une connexion par le terminal reste tant que ce navigateur est connecté, quel que soit le nombre de connexions qui suivent.
Connecter un autre appareil #
Vous n’avez plus besoin de taper le token du relais sur un téléphone.
- Sur un navigateur connecté, ouvrez Settings → Security → Sign in another device (Réglages → Sécurité → Connecter un autre appareil) et appuyez sur Make a sign-in link (Créer un lien de connexion).
- Ouvrez le lien sur l’autre appareil, ou appuyez sur Show QR code (Afficher le QR code) et scannez-le avec l’appareil photo de cet appareil.
Le lien (…/) connecte un navigateur, une seule fois, dans les 10 minutes. L’onglet
indique le temps qu’il lui reste. La première personne qui l’ouvre est connectée : ne le montrez
ou ne l’envoyez donc que là où vous seul pouvez le voir. Le QR code se masque de nouveau au bout d’une
minute, quand vous quittez la page ou fermez les réglages, une fois le lien utilisé ou
expiré, et avec Hide QR code (Masquer le QR code). Un nouveau lien met fin au précédent, et un
redémarrage du relais y met fin aussi.
Sur l’hôte du relais, oar url --sign-
affiche un tel lien et son QR code dans un terminal, pour l’adresse qu’un téléphone
joint. Le relais en crée au plus 3 en 10 minutes, et un nouveau lien remplace le précédent,
qui ne fonctionne alors plus ; la commande le signale. La liste des
navigateurs indique from the terminal (oar url --sign-in) pour un navigateur qui
s’est connecté de cette façon.
Deux relais joints sous le même nom d’hôte avec des ports différents
(host:, host:) partagent un même cookie de connexion dans un navigateur et se déconnectent
l’un l’autre. Donnez à chacun son propre nom d’hôte.
Le token du relais #
Le token du relais est l’identifiant de la personne : gardez-le dans votre gestionnaire de mots de passe.
Le relais n’en garde que le hash, dans relay- dans le dossier de données ; voir
Où se trouvent les secrets. Les nouveaux tokens
commencent par oaro1_ ; un token d’une version antérieure continue de fonctionner.
- Il n’est affiché qu’une fois.
oar setupdans un terminal affiche une fois un nouveau token, avec un lien de connexion et un QR code. Sans terminal (un service, un script, un agent), rien n’affiche de token, car cette sortie finit dans des journaux que les agents peuvent lire. oar urln’affiche aucun token. Le relais ne le peut pas : il ne détient que le hash.- Vous l’avez perdu ? Connectez un autre appareil depuis un navigateur encore
connecté, ou remplacez le token. Sans navigateur connecté, exécutez
oar setup --new-dans un terminal sur l’hôte du relais.token
Générer un nouveau token du relais #
Settings → Security → Relay token (Réglages → Sécurité → Token du relais) indique si un token est défini, que le relais n’en garde que le hash, et quand il a été créé ou remplacé pour la dernière fois. Generate new relay token (Générer un nouveau token du relais) demande d’abord, The current token stops working at once. Signed-in browsers stay signed in; agents keep working., puis affiche une fois le nouveau token :
- masqué jusqu’à ce que vous appuyiez sur Show (Afficher), avec Save in password manager (Enregistrer dans le gestionnaire de mots de passe), pour que votre gestionnaire de mots de passe propose de le garder sous le nom du relais, Copy (Copier) et Copy pairing link (Copier le lien d’association) ;
- quand l’ancien token a été utilisé pour la dernière fois par autre chose qu’une page de navigateur, comme un script ou un relais associé plus ancien, et depuis quelle adresse ;
- les relais associés qui appellent encore avec l’ancien token, chacun avec Open there (Ouvrir là-bas), qui ouvre les Settings → Relays (Réglages → Relais) de ce relais avec Add a relay (Ajouter un relais) prêt pour le lien d’association. Les relais qui se connectent avec une clé continuent de fonctionner et ne sont pas listés.
Fermer la boîte de dialogue retire le token de la page. Videz votre presse-papiers après l’avoir collé : l’historique du presse-papiers le garde.
Ce qui change aussitôt : l’ancien token cesse de fonctionner. Les navigateurs connectés restent
connectés, les agents, leurs tokens et les workers de session continuent, et les relais
associés à clé continuent de fonctionner. Un script qui envoyait l’ancien token a besoin du nouveau,
ou mieux de OAR_. Dans un terminal, oar setup --new- fait
la même chose une fois que vous avez tapé NEW, et redémarre le relais.
Un relais que la 0.9.26 ou une version antérieure a démarré par oar copilot, ou démarré
avec un --token manuel, garde l’ancien token sur la ligne de commande de son superviseur
jusqu’à ce qu’il soit arrêté et redémarré une fois. Faites-le avant de générer un nouveau token ;
voir Notes de mise à niveau.
La bannière et la pastille de recommandation #
Après la mise à jour vers 0.9.27, une bannière sous l’en-tête indique Your relay token was readable by agents until this version. Generate a new one. Generate new token (Générer un nouveau token) ouvre la boîte de dialogue ci-dessus ; Dismiss (Ignorer) la masque, une fois pour tout le relais. Tant qu’un nouveau token reste recommandé après que vous avez ignoré la bannière, l’onglet Security garde une petite pastille et la ligne du token une étiquette Recommended (Recommandé), jusqu’à ce que vous remplaciez le token.
La bannière indique aussi The relay token was changed outside OAR quand le token
a changé sans que le relais le fasse : un auth remis dans
config., ou un relay- modifié. Ignorez-la si c’était vous ;
sinon, générez un nouveau token. Seule votre propre page connectée l’affiche, jamais
une vue partagée.
Fichiers que le relais ne sert jamais #
Quel que soit l’identifiant, token du relais compris, les routes de fichiers d’OAR ne servent
ni ne modifient jamais les propres fichiers du relais : relay-, la base de données
(oar. avec ses fichiers -wal et -shm, ses sauvegardes et une sauvegarde en cours
d’écriture) et config.. Elles répondent 403 FILE_. L’explorateur de
fichiers ne peut ni les renommer, ni les déplacer, ni les
supprimer, pas plus qu’un dossier qui en contient un, et la galerie de médias n’en sert jamais un
qu’un message nomme. Un lien symbolique ou un lien physique vers l’un d’eux est refusé aussi.
Cela ne les tient à l’écart que des routes de fichiers : le shell d’un agent peut toujours les
lire (voir Limites de cette protection).
Relais associés #
Les relais associés ne gardent plus le
token du relais de l’autre. Avec la 0.9.27 ou plus récente des deux côtés, l’association utilise une fois le token
du lien d’association de l’autre relais, pour échanger des clés. Dès lors, chaque relais
se connecte à l’autre avec sa propre clé, qui n’ouvre que les routes par lesquelles les relais
s’appellent : jamais les réglages, les fichiers, l’association, la facturation d’une session, ni
la réponse à une carte ou à une question (403 REMOTE_). Remplacer le
token d’un relais ne casse plus une association à clé. Les relais associés auparavant passent aux
clés d’eux-mêmes en une minute environ une fois que les deux tournent en 0.9.27.
- Dans les deux sens. Avec Also add this relay there (Ajouter aussi ce relais là-bas) coché, chaque relais reçoit une clé de l’autre.
- Sens unique. Décoché, le token du lien ne sert qu’à l’ajout, en mémoire, et n’est jamais conservé. L’autre relais donne à celui-ci une clé entrante uniquement et le liste comme Inbound only (Entrant uniquement) : il n’appelle jamais ce relais, et son Remove (Retirer) révoque aussitôt la clé. Ici, la ligne indique One way (Sens unique).
- Le token pendant l’ajout. Avec la 0.9.27 des deux côtés, le token du lien n’est
gardé qu’en mémoire, le temps de l’ajout, et n’est jamais écrit dans la base de données une fois
qu’une clé fonctionne. Seul un ajout qui se termine sans clé qui fonctionne (un relais plus
ancien, ou un échange qui a échoué) le stocke, jusqu’à ce qu’une clé fonctionne. Un token stocké
puis abandonné ainsi peut rester lisible dans les pages libres de la base de données et dans
son
oar.jusqu’à ce que SQLite les réutilise ; si cela compte pour vous, remplacez le token de ce relais.db- wal - Re-pair (Réassocier) dans Settings → Relays échange de nouveau les clés en un clic. Quand plus rien de ce que ce relais détient ne fonctionne là-bas, ou que l’autre relais est plus ancien, il ouvre Add a relay avec l’adresse déjà remplie : collez le lien d’association de ce relais-là, et l’entrée est mise à jour sur place.
- Renew key (Renouveler la clé) et Revoke key (Révoquer la clé) agissent sur un relais. Les clés se renouvellent d’elles-mêmes tous les 30 jours. Une clé révoquée reste nulle jusqu’à ce que vous la renouveliez, ou jusqu’à ce que ce relais-là soit de nouveau ajouté à partir du lien d’association de ce relais-ci, ce qui lui redonne une clé qui fonctionne. Seuls le retrait du relais et la génération d’un nouveau token du relais l’excluent pour de bon.
Origines vérifiées et non vérifiées #
Un prompt venant d’un relais associé nomme le relais dont la clé l’a connecté, sous le nom que vous lui avez donné ici, jamais ce que la requête dit d’elle-même.
- Vérifiée. Un prompt arrivé avec une clé. Il peut faire ce que les limites permettent.
- Non vérifiée. Un relais sans clé confirmée ici (un OAR antérieur à la 0.9.27, ou une clé pas encore confirmée) atteint encore ses sessions, mais son prompt affiche une étiquette claimed (non vérifié), l’agent lit « (unverified) » dans sa ligne d’en-tête, et il n’ouvre rien : pas d’accès en réponse, pas de saut autorisé, pas de suppression des notifications push, ni questions non bloquantes ni surveillances. L’agent qui envoie apprend pourquoi. Les prompts enregistrés avant la 0.9.27 sont aussi lus comme non vérifiés.
- Déclarations refusées. Une clé qui se présente comme un autre relais est refusée
(
REMOTE_), tout comme n’importe quel autre identifiant qui se présente comme un relais doté d’une clé (RELAY_ ORIGIN_ MISMATCH REMOTE_). Chaque refus est journalisé et compté sur la ligne de ce relais, N refused claims since start, et le premier par relais place un avis dans l’Inbox.RELAY_ PEER_ KEY_ REQUIRED - Une identité modifiée est retenue. Dès qu’un relais a une clé, ou que ce relais détient une clé de lui, son adresse et son id de relais sont épinglés. S’ils changent, ou qu’un autre relais répond à son adresse, ses clés sont révoquées, ce relais ne lui envoie rien de ce qu’il détient pour lui (la clé qu’il a donnée à ce relais, ou un token), et rien de nouveau n’est émis tant que vous n’avez pas appuyé sur Confirm (Confirmer) sur sa ligne. Remettre l’adresse à celle pour laquelle il a reçu ses clés lève une retenue que seul le changement d’adresse avait posée.
Les questions d’un relais associé reçoivent leur réponse sur ce relais, en y étant connecté. L’Inbox les affiche en lecture seule avec Open there, et pour un relais en 0.9.27 avec des boutons d’option qui ouvrent la question là-bas dans une petite fenêtre ; voir Questions et Inbox.
Modifications de fichiers sensibles #
Les sessions Claude, Claude API et DeepSeek vous demandent avant une modification d’un fichier que
Claude Code marque comme sensible, parce qu’un changement à cet endroit peut modifier le comportement de git, d’un
shell ou d’un outil : fichiers de démarrage du shell comme ., ., et
tout ce qui se trouve sous . ou ., entre autres. Une telle modification attend sur une carte
Safety check dans
tous les modes du relais, autopilot compris, avec le fichier et le changement complet, et
Allow once (Autoriser une fois) et Deny (Refuser). Vous seul pouvez y répondre : un token d’agent et la
clé d’un relais associé sont refusés. Elle n’autorise jamais plus que cette seule modification, et
une carte sans réponse laisse le fichier inchangé. Un agent ou un relais associé qui
surveille la session ne reçoit que la première ligne fixe de la carte et la ligne File:,
jamais le changement.
Lire un tel fichier, ou en envoyer un par le relais, ne demande rien, pas plus qu’une commande qui l’écrit d’une façon que Claude Code ne signale pas. La carte contrôle les modifications de l’agent ; ce n’est pas un bac à sable.
Limites de cette protection #
Les tokens d’agent séparent les outils des agents des vôtres. Ce ne sont pas un bac à sable : un agent tourne sous le même utilisateur du système d’exploitation que le relais, et cet utilisateur peut encore faire ce qui suit.
- Modifier les fichiers du relais. Un agent peut écrire
relay-,secrets. json config., la base de données ou le code du relais, puis mettre un redémarrage en file, et ainsi installer un token à lui. Le relais ne fait que le remarquer : à son démarrage, il compare le hash du token avec une copie dans sa base de données et signale The relay token was changed outside OAR. Un agent qui modifie les deux peut passer outre. À partir du même fichier, il peut aussi fabriquer le token d’agent de n’importe quelle session. Les routes de fichiers refusent ces fichiers, mais le shell d’un agent ne passe pas par elles.json - Utiliser les chemins du terminal. Les vérifications de terminal d’
oar setup --new-et d’token oar url --sign-sont un frein, pas une frontière : un agent peut simuler un terminal ou appeler la route avecin oar agent-. Une connexion faite ainsi est annoncée à tous les autres navigateurs, comme ci-dessus, et affiche « via the terminal » dans la liste des navigateurs. Déconnectez un tel navigateur, puis remplacez le token.token - Prendre la session d’un navigateur sur l’hôte du relais. Un navigateur sur la même machine et sous le même utilisateur garde son cookie et sa clé de preuve là où cet utilisateur peut les lire. Les deux ensemble forment une session complète : qui les détient peut faire ce que vous pouvez faire dans l’interface web, y compris créer un nouveau token. Pour reprendre la main, générez un nouveau token du relais, connectez-vous avec, puis utilisez Sign out all other browsers. Un nouveau token seul ne déconnecte aucun navigateur.
- Lire le contenu ouvert par le seul cookie. Les pièces jointes, les images générées et les médias indexés qu’un navigateur charge de lui-même, par leur id ou leur hash, s’ouvrent toujours avec le seul cookie, sans la clé de preuve : un serveur sur un autre port de l’hôte qui reçoit votre cookie peut donc les récupérer. Les fichiers par chemin n’en font pas partie : ils exigent la clé de preuve ou une autorisation de fichier. Un token d’agent lit tout cela de toute façon.
- Lire les identifiants des relais associés que ce relais garde dans sa base de données, et un token qu’il y a stocké un jour pour l’un d’eux, qui peut subsister dans les pages libres de la base de données. Une clé n’ouvre que les routes de relais là-bas, et Revoke key sur ce relais l’annule.
- Trouver une ancienne copie du token d’avant la 0.9.27 : historique du shell, une
sauvegarde, un
config.copié, ou la ligne de commande du superviseur d’un relais qu’json oar copilotd’une version antérieure ou un--tokenmanuel a démarré, jusqu’à ce que ce relais soit arrêté et redémarré une fois. Si des agents ont tourné sur ce relais auparavant, générez un nouveau token après la mise à jour. - Arrêter le relais. Un processus du même utilisateur peut y mettre fin : les vérifications de la commande
oaravant un arrêt sont donc une commodité, pas une protection.
Le token du relais lui-même ouvre toujours tout, pour quiconque le détient.