Configuration sécurisée d'OpenCode Browse : isoler les agents de code de votre navigateur connecté
OpenCode Browse permet aux agents de code de piloter votre vrai navigateur, celui où vous êtes connecté. C'est pratique, mais c'est aussi risqué. Ce guide présente une configuration sécurisée d'OpenCode Browse fondée sur le modèle de confinement en cinq couches : Profil, Périmètre, Mode, Passation et Nettoyage. Il explique contre quoi allowedOrigins et readOnly ne protègent pas, et se termine par une liste de contrôle préalable.
OpenCode Browse permet à un agent de code de travailler dans le navigateur que vous utilisez déjà, connecté à votre GitHub, à votre console cloud et à tout ce qui se trouve dans ce profil. Chaque page que l'agent lit peut tenter d'orienter ce qu'il fait avec ces sessions.
Contenir ce risque sans perdre en confort, c'est le rôle de ce que nous appelons le modèle de confinement en cinq couches : Profil, Périmètre, Mode, Passation et Nettoyage. Chaque couche réduit ce qu'une session compromise peut atteindre.
En plus du README et des notes de version, nous nous appuyons sur deux analyses indépendantes : un test pratique de Browse dans plusieurs clients MCP, et une comparaison avec Playwright MCP et Chrome DevTools MCP. Leurs chiffres sont des instantanés : vérifiez donc le nombre d'étoiles, les numéros de version et tout ce sur quoi vous vous appuyez dans le dépôt de Browse.
Ce qu'OpenCode Browse confie réellement à votre agent
Browse connecte des agents d'IA à votre vrai navigateur, y compris vos onglets, vos connexions et vos extensions, grâce à un petit serveur MCP natif et à une extension Chromium. Il fonctionne avec OpenCode, Claude Code, Codex, Cursor et tout autre client MCP. Anomaly, l'entreprise derrière OpenCode, l'a annoncé le 7 novembre 2026, et le code est disponible sur GitHub sous licence MIT.
La conception est légère. Depuis la version 0.1.0, la CLI, le relais et le serveur MCP sont livrés sous la forme d'un seul binaire Rust de quelques mégaoctets, sans Node.js ni Playwright en dessous. Les notes de version du projet confirment que Browse n'utilise plus Playwright depuis la 0.1.0.
Le choix de conception le plus important concerne le navigateur piloté. Browse pilote votre vrai navigateur connecté et vous rend l'onglet pour les connexions et les paiements, tandis que Playwright MCP lance son propre navigateur avec son propre profil, conçu pour une automatisation reproductible. En pratique, chaque compte connecté dans le profil de l'agent est à sa portée. Si ce profil contient une session administrateur de votre console cloud, une page qui oriente l'agent oriente un administrateur.
Les capacités varient aussi selon le client. Dans le test pratique, OpenCode se voyait proposer 26 outils avec 41,415 octets de définitions d'outils, tandis que Claude Code, Codex et Cursor se voyaient proposer 3 outils avec 7,495 octets.
Pourquoi un navigateur connecté change le modèle de menace
L'OWASP décrit l'injection de prompt indirecte comme ce qui se produit lorsqu'un LLM accepte des entrées provenant de sources externes, comme des sites web ou des fichiers. Un agent de navigation fait cela toute la journée.
Les recherches de Brave sur les navigateurs agentiques ont montré que lorsqu'un assistant d'IA suit des instructions malveillantes issues du contenu d'une page web non fiable, les protections traditionnelles comme la politique de même origine et CORS deviennent de fait inutiles. Ces protections partent du principe qu'une requête émise depuis votre session reflète votre intention. Les instructions n'ont d'ailleurs pas besoin d'être visibles. Dans une attaque, Brave a caché des instructions d'injection de prompt dans des images, en texte bleu clair à peine visible sur fond jaune.
Vient ensuite la question du flux de données, valable pour tout MCP de navigateur : tout le texte de page que votre agent lit part chez son fournisseur de modèle. Si des agents doivent travailler à proximité de boîtes de réception, d'outils RH ou d'autres systèmes contenant des données personnelles, filtrez leurs prompts et leurs appels d'outils pour détecter les données personnelles.
La spécification MCP fixe elle-même une base prudente. Elle indique que les outils représentent une exécution de code arbitraire et que les descriptions du comportement des outils, comme les annotations, doivent être considérées comme non fiables sauf si elles proviennent d'un serveur de confiance.
Ni l'OWASP ni Brave ne promettent une prévention. L'OWASP affirme qu'il n'est pas certain qu'il existe des méthodes infaillibles pour empêcher l'injection de prompt. Brave est plus direct : tant que la sécurité ne s'améliore pas dans l'ensemble des navigateurs, la navigation agentique restera intrinsèquement dangereuse et doit être traitée comme telle. Concevez donc votre configuration en partant du principe qu'une injection finira par réussir. Notre guide pour tester la séparation entre instructions et données face à l'injection de prompt montre comment vérifier le côté modèle, mais la résistance au niveau du modèle ne remplace pas les couches ci-dessous.
Le modèle de confinement en cinq couches : une configuration renforcée étape par étape
Le modèle regroupe sept étapes pratiques en cinq couches :
- Profil (étapes 1 à 3) : quelle identité de navigateur, quels comptes et quel appairage l'agent obtient.
- Périmètre (étape 4) : où les onglets de l'agent peuvent aller.
- Mode (étape 5) : si l'agent peut saisir du texte et cliquer.
- Passation (étape 6) : quelles actions reviennent toujours à un humain.
- Nettoyage (étape 7) : combien de temps l'accès persiste après une tâche.
Une vérification se situe à côté des couches plutôt qu'à l'intérieur : la configuration du client, c'est-à-dire le client MCP lui-même et chaque autre serveur ou module complémentaire qu'il exécute à côté de Browse.
Aucune couche ne tient seule. Si une page sur une origine autorisée se comporte mal, les limites de profil et de mode continuent de s'y appliquer. La syntaxe peut changer d'une version à l'autre : vérifiez donc les noms d'options et les valeurs par défaut dans le README de Browse pour la version que vous installez.
Étape 1 (Profil) : créer un profil dédié à l'agent
Les profils Chrome séparent les favoris, l'historique, les mots de passe et les autres paramètres. N'installez l'extension Browse que dans un profil créé pour le travail des agents. L'auteur du test pratique a déclaré qu'il ne l'ajouterait pas encore à son profil de navigateur principal, car tout ce à quoi il est connecté s'y trouve et ce qu'un agent lit sur une page peut tenter de l'orienter. Nous partageons cet avis.
Étape 2 (Profil) : ne se connecter que là où la tâche l'exige
Un profil sans aucune connexion expose peu de choses. Il ne permet pas non plus de faire grand-chose : le vrai travail de cette étape consiste donc à choisir quels comptes y ajouter.
Ajoutez les comptes une tâche à la fois et, pour chacun, demandez-vous ce que l'agent pourrait en faire si une page l'orientait mal. En général, cela mène aux mêmes choix :
- Privilégiez les comptes de test, de bac à sable ou de préproduction plutôt que ceux de production.
- Lorsqu'un compte de production est inévitable, utilisez le rôle le plus faible qui permet encore d'accomplir la tâche, et gardez les rôles administrateur, facturation et propriétaire hors du profil.
- Soyez prudent avec l'authentification unique. Une seule session connectée auprès d'un fournisseur d'identité peut ouvrir de nombreuses applications liées : elle élargit donc la portée bien plus qu'une simple connexion à un outil.
- Déconnectez-vous une fois la tâche terminée au lieu de laisser les comptes s'accumuler.
Brave recommande d'isoler les capacités agentiques puissantes de la navigation ordinaire et de rendre cette séparation évidente pour l'utilisateur.
Étape 3 (Profil) : appairer de façon délibérée
Un code d'appairage ne fonctionne qu'une fois, dans un délai de 10 minutes, et cinq codes erronés d'affilée annulent tous les codes en attente. Lancez vous-même l'appairage, terminez-le rapidement et ne collez jamais de codes dans un chat ou un ticket. Une demande d'appairage que vous n'avez pas lancée est une raison de vous arrêter et d'enquêter.
Étape 4 (Périmètre) : limiter chaque session avec allowedOrigins
Définissez allowedOrigins avec une courte liste d'origines auxquelles vous faites confiance et dont la tâche a besoin. Pour une tâche de recherche documentaire, cela signifie le ou les deux sites de documentation que l'agent lira réellement, écrits sous forme d'origines exactes plutôt que d'un domaine d'entreprise entier ou d'un caractère générique large. Cet extrait est illustratif, il n'est pas copié de la documentation de Browse, et le domaine est fictif :
{
"allowedOrigins": ["https://docs.example.com"],
"readOnly": true
}Étape 5 (Mode) : activer readOnly par défaut pour les sessions à risque
La recherche et la synthèse demandent rarement à l'agent de saisir du texte ou de cliquer : faites donc de readOnly la valeur par défaut pour ces tâches. Les écritures relèvent de sessions courtes et supervisées, comme la mise à jour d'un enregistrement sur un site de préproduction sous vos yeux, avec une liste d'origines tout aussi restreinte :
{
"allowedOrigins": ["https://staging.example.com"],
"readOnly": false
}Une faille reste ouverte dans les deux cas : readOnly n'empêche pas eval.
Étape 6 (Passation) : confier les connexions, la 2FA et les paiements à un humain
Quand c'est votre tour, pour une connexion, une demande de 2FA ou un paiement, Browse vous rend l'onglet et reprend dès que vous cliquez sur Continue. Utilisez ce mécanisme plutôt que de stocker des identifiants à un endroit où l'agent peut les lire. Lorsqu'un flux de travail a réellement besoin d'un accès API, un proxy d'identifiants qui tient les clés API hors de portée de l'agent est une bien meilleure approche que de coller des secrets dans son contexte.
Étape 7 (Nettoyage) : considérer la fermeture automatique comme un filet de sécurité
Les onglets que personne ne touche pendant 10 minutes se ferment d'eux-mêmes, mais jamais tant qu'une opération y est en cours. Considérez cela comme un filet de sécurité pour les onglets oubliés. Fermer vous-même les onglets de l'agent à la fin d'une tâche reste votre responsabilité, car le comportement de fermeture des onglets peut varier selon le client.
Vérifier vous-même le transport local
Browse fournit un relais en plus de son serveur MCP. Consultez le README pour savoir comment les deux se connectent à votre client MCP dans votre version. À titre de référence, les recommandations de sécurité MCP indiquent que les serveurs exécutés localement doivent se prémunir contre toute utilisation non autorisée par des processus malveillants, par exemple en utilisant le transport stdio pour limiter l'accès au client MCP. Aucun point de terminaison local ne devrait être accessible plus largement que ce dont le client a besoin.
Ce que allowedOrigins et readOnly laissent ouvert
Les mainteneurs décrivent ces deux contrôles comme des garde-fous, et non comme une frontière de données. allowedOrigins limite les navigations, les documents de premier niveau ainsi que les onglets et fenêtres contextuelles que l'agent ouvre. Les requêtes que la page émet elle-même, notamment fetch, XHR, images, scripts et iframes, ne sont pas filtrées.
Le test pratique a constaté la même chose. L'onglet restait là où allowedOrigins le maintenait, tandis que le JavaScript de la page pouvait toujours envoyer des requêtes n'importe où. Avec readOnly activé, la saisie était bloquée et eval exécutait toujours du code dans la page.
| Contrôle | Couche | Ce qu'il limite | Ce qu'il n'empêche pas |
|---|---|---|---|
| Profil dédié | Profil | Les comptes et données enregistrées que l'agent peut atteindre | L'injection depuis des pages chargées dans ce profil |
| allowedOrigins | Périmètre | Les destinations possibles des onglets de l'agent | Les requêtes émises par la page elle-même |
| readOnly | Mode | La saisie par l'agent | Le code exécuté via eval |
Une page malveillante ou compromise sur une origine autorisée peut donc toujours envoyer à l'extérieur tout ce qu'elle voit. Gardez des listes d'origines restreintes et propres à chaque tâche, réservez readOnly à la lecture et n'accordez l'accès en écriture que lorsque quelqu'un surveille.
Passation humaine pour les connexions, la 2FA, les paiements et les contrôles anti-robots
Les défis anti-robots passent par la même passation que les connexions, les demandes de 2FA et les paiements. Après une navigation, Browse signale les vérifications Cloudflare, les murs de captcha et les pages d'accès refusé, et demande à l'agent de vous transmettre ceux qui sont interactifs. Il ne les résout jamais. Cette conception correspond à la recommandation de Brave selon laquelle, quel que soit le plan initial de l'agent, le modèle doit exiger une interaction explicite de l'utilisateur pour les tâches sensibles en matière de sécurité et de confidentialité.
Au quotidien, nous pensons que la passation est la fonction de sécurité la plus utile de Browse, et deux habitudes la renforcent. D'abord, vérifiez vous-même l'URL et la page avant de cliquer sur Continue, afin de savoir exactement où vous vous connectez ou payez. Ensuite, tenez une liste écrite, partagée par l'équipe, des actions réservées aux humains : les paiements, les changements d'identifiants, les paramètres de partage et tout ce qui supprime des données ne doivent jamais s'exécuter sans surveillance.
Erreurs courantes lors du déploiement de Browse
- Installer Browse dans le profil quotidien (Profil). Chaque compte connecté devient alors accessible.
- Traiter allowedOrigins comme un pare-feu de données (Périmètre). Il régit la navigation des onglets, et les pages sur des origines autorisées peuvent toujours envoyer des requêtes n'importe où.
- Croire que readOnly signifie que rien ne change (Mode). eval s'exécute toujours.
- Approuver un appairage à la légère (Profil). N'approuvez que les appairages que vous avez lancés.
- Faire confiance à des métadonnées d'outils non vérifiées (configuration du client). La spécification MCP considère les annotations d'outils comme non fiables sauf si elles proviennent d'un serveur de confiance, et cela s'applique à chaque serveur que vous ajoutez à côté de Browse.
- Utiliser Browse pour la CI. Les pipelines reproductibles conviennent mieux à un outil qui lance son propre navigateur et son propre profil, comme Playwright MCP.
Mises en garde et limites à anticiper
Dans la comparaison indépendante, Browse comptait environ 770 étoiles GitHub, contre environ 39,800 pour Playwright MCP et environ 57,900 pour Chrome DevTools MCP. Les étoiles ne sont qu'un indicateur approximatif d'adoption : cherchez ailleurs des preuves d'un audit de sécurité.
La comparaison décrivait aussi Browse comme âgé d'environ trois semaines, alors que les alternatives avaient un long historique, ce qui compte si vous avez besoin d'un comportement stable en CI. L'annonce publique datant du 7 novembre 2026, cet âge laisse penser que le dépôt était public plus tôt, si bien que la date d'annonce ne correspond peut-être pas à la première version. Nous n'avons pas confirmé la date de la première version ; consultez l'historique des versions si cela compte pour vous.
Les versions évoluent aussi rapidement. Cette comparaison indiquait la v0.1.0 comme dernière version de Browse. À ce stade, les versions peuvent se succéder vite : nous vous conseillons donc de revérifier le README et les notes de version avant de vous fier à tout comportement décrit ici.
Testez votre renforcement client par client, car les clients voient des ensembles d'outils différents. Une configuration validée dans Claude Code, avec ses 3 outils, n'est pas automatiquement validée pour OpenCode avec ses 26. Le nettoyage fait partie de ces tests. Dans le test pratique, Claude Code fermait l'onglet une fois sa tâche terminée. Ne partez pas du principe que tous les autres clients font de même.
Aucune configuration ne supprime le risque d'injection de prompt. Les étapes de ce guide réduisent l'exposition sans garantir la sécurité. Dites-le clairement dans votre politique interne.
Liste de contrôle préalable à chaque session de navigation d'agent
Passez-la en revue avant chaque session.
- [ ] Profil : je suis dans le profil dédié à l'agent, connecté uniquement à ce dont cette tâche a besoin.
- [ ] Profil : tout onglet que je ne voudrais pas voir envoyé au fournisseur de modèle est fermé.
- [ ] Profil : j'ai lancé moi-même tout appairage et je l'ai terminé dans le délai de 10 minutes.
- [ ] Configuration du client : chaque autre serveur MCP et module complémentaire de ce client provient d'une source de confiance. Notre guide de tri des extensions d'éditeur explique comment vérifier et verrouiller les modules complémentaires tiers pour agents.
- [ ] Périmètre : allowedOrigins est défini avec une courte liste de domaines de confiance pour cette tâche.
- [ ] Mode : cette session est en readOnly sauf si l'écriture est nécessaire, et je garde en tête qu'eval s'exécute toujours.
- [ ] Passation : je sais quelles étapes (connexion, 2FA, paiement, captcha) me reviendront, et je vérifierai l'URL et la page avant de cliquer sur Continue.
- [ ] Nettoyage : je fermerai les onglets de l'agent à la fin de la tâche et me déconnecterai des comptes dont je n'ai plus besoin.
Points clés
- OpenCode Browse donne aux agents accès à vos vrais onglets, connexions et extensions via un serveur MCP natif et une extension Chromium : chaque compte connecté dans ce profil est donc à la portée de l'agent.
- Le modèle de confinement en cinq couches (Profil, Périmètre, Mode, Passation, Nettoyage) organise sept étapes de configuration afin qu'une faille dans une couche soit limitée par les autres.
- Profil : n'installez Browse que dans un profil de navigateur dédié, et ne vous y connectez qu'aux comptes à faibles privilèges dont une tâche a réellement besoin.
- Périmètre et Mode : selon les mainteneurs, allowedOrigins ne filtre pas les requêtes émises par la page elle-même, et un test indépendant a montré que readOnly n'empêche pas eval. Traitez-les comme des garde-fous, pas comme une frontière de données.
- Passation : utilisez la passation intégrée pour les connexions, la 2FA, les paiements et les contrôles anti-robots, et vérifiez vous-même la page avant de cliquer sur Continue.
- Le texte des pages lues par l'agent part chez son fournisseur de modèle : tenez les onglets sensibles à l'écart des sessions d'agent.
- Aucune configuration n'empêche totalement l'injection de prompt : testez chaque client MCP séparément et passez en revue la liste de contrôle préalable à chaque session.
Conclusion
Les agents qui ne peuvent pas accéder à vos outils connectés bloquent dès le premier écran de connexion. Browse lève cet obstacle en travaillant dans votre navigateur authentifié, ce qui permet à un agent de faire des choses qu'un navigateur d'automatisation propre et séparé ne peut pas faire. Le revers, c'est que du contenu web non fiable se trouve désormais à un pas de vos sessions, et les cinq couches sont là pour empêcher ce pas de se transformer en accès à vos comptes.
Donnez à l'agent son propre profil et ne vous connectez que là où c'est nécessaire. Limitez chaque session avec allowedOrigins, activez readOnly par défaut, laissez les humains aux commandes pour les connexions, la 2FA, les paiements et les contrôles anti-robots, puis fermez les onglets et déconnectez-vous une fois le travail terminé. Restez lucide sur les failles. Les mainteneurs indiquent que les requêtes émises par la page elle-même ne sont pas filtrées. Le test pratique a montré qu'eval exécute toujours du code dans la page, même avec readOnly activé.
Pour les équipes, la vraie question est de savoir quelles tâches confier à Browse. Le travail interactif et supervisé dans un profil restreint s'y prête raisonnablement. Les exécutions sans surveillance sur des comptes à forte valeur, ou les pipelines de CI qui exigent un comportement reproductible, sont pour l'instant mieux servis ailleurs. Trois évolutions justifieraient un rôle plus large : un audit de sécurité indépendant, une version 1.0 stable avec une configuration figée, et le filtrage des requêtes émises par les pages elles-mêmes, qui rapprocherait allowedOrigins d'une véritable frontière de données.
Si votre équipe rédige une politique pour les outils de navigation d'agents, ou examine quels serveurs MCP et modules complémentaires vos développeurs utilisent, Optijara peut vous accompagner dans cette démarche à l'aide des cinq couches présentées ci-dessus.
Questions fréquentes
Est-il sûr d'installer OpenCode Browse dans mon profil Chrome principal ?
Nous ne le recommandons pas. L'auteur du test pratique indépendant a déclaré qu'il ne l'ajouterait pas à son profil principal, car tout ce à quoi il est connecté s'y trouve et le contenu des pages peut tenter d'orienter l'agent. Les profils Chrome séparent les favoris, l'historique, les mots de passe et les paramètres : créez plutôt un profil dédié à l'agent. C'est la couche Profil du modèle de confinement en cinq couches.
allowedOrigins empêche-t-il les données de quitter la page ?
Non. Les mainteneurs le qualifient de garde-fou, et non de frontière de données. Il limite les navigations, les documents de premier niveau ainsi que les onglets et fenêtres contextuelles que l'agent ouvre, mais les requêtes que la page émet elle-même, notamment fetch, XHR, images, scripts et iframes, ne sont pas filtrées. Le test pratique a confirmé que le JavaScript de la page peut toujours envoyer des requêtes n'importe où.
Qu'est-ce que le mode readOnly empêche réellement ?
readOnly bloque la saisie par l'agent. Il n'empêche pas eval, qui exécute toujours du code dans la page. Considérez readOnly comme une valeur par défaut judicieuse pour les tâches de recherche et de lecture, sans vous y fier comme garantie que la page ne peut pas être modifiée.
Browse résoudra-t-il les captchas ou effectuera-t-il la 2FA à la place de mon agent ?
Non. Pour les connexions, les demandes de 2FA et les paiements, Browse vous rend l'onglet et reprend dès que vous cliquez sur Continue. Pour les défis anti-robots comme les vérifications Cloudflare et les murs de captcha, il les signale et demande à l'agent de vous transmettre ceux qui sont interactifs. Il ne les résout jamais.
Dois-je utiliser Browse ou Playwright MCP pour les tests automatisés en CI ?
Pour la CI, un outil qui lance son propre navigateur avec son propre profil, comme Playwright MCP, est plus adapté, car il est conçu pour une automatisation reproductible. Browse pilote votre navigateur connecté, et une comparaison indépendante rédigée lorsque la v0.1.0 était la dernière version le décrivait comme âgé d'environ trois semaines, ce qui compte lorsque vous avez besoin d'un comportement stable en CI.
Le contenu des pages que lit mon agent reste-t-il sur ma machine ?
Non. Tout le texte de page lu par un agent utilisant un MCP de navigateur part chez son fournisseur de modèle. Fermez les onglets de messagerie, RH, banque et autres onglets sensibles avant une session d'agent, et tenez-les entièrement à l'écart du profil dédié à l'agent.
Sources
- https://github.com/anomalyco/browse
- https://github.com/anomalyco/browse/releases/tag/v0.1.5
- https://flaviocopes.com/opencode-browse/
- https://dev.to/hassann/opencode-browse-vs-playwright-mcp-vs-chrome-devtools-mcp-which-browser-mcp-should-you-use-2360
- https://support.google.com/chrome/answer/2364824?hl=en&co=GENIE.Platform%3DDesktop
- https://www.chromium.org/developers/creating-and-using-profiles/
- https://brave.com/blog/comet-prompt-injection/
- https://brave.com/blog/unseeable-prompt-injections/
- https://modelcontextprotocol.io/docs/2026-07-28/tutorials/security/security_best_practices
- https://modelcontextprotocol.io/specification/2025-06-18
- https://genai.owasp.org/llmrisk/llm01-prompt-injection/



