> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Prévisualisations dans le navigateur de Devin

> Ouvrez une webapp exécutée sur la machine de Devin à partir d'un lien privé. Découvrez le fonctionnement des URL de prévisualisation, de l'accès, des ports multiples, du tunneling de ports et des sessions en veille.

Une prévisualisation dans le navigateur est un lien privé vers une application web exécutée sur la machine de Devin. Lorsque Devin démarre un serveur de développement dans une session, il peut exposer le port et vous fournir un lien à ouvrir dans votre navigateur web.

Les prévisualisations fonctionnent avec n'importe quelle pile technologique : dès lors qu'une application sert du HTTP sur un port, Devin peut en afficher une prévisualisation. L'application et ses données restent sur la machine de Devin ; rien n'est téléversé vers un service tiers.

> [!NOTE]
>
> Cette page porte sur les prévisualisations dans les sessions Devin. Pour les prévisualisations d'un serveur de développement local dans Devin Desktop, consultez [prévisualisation de Devin Desktop](https://docs.devinenterprise.com/fr/desktop/previews.md).

## Ouvrir un aperçu

Devin ouvre un aperçu lorsqu'il démarre une application que vous devriez examiner. Vous pouvez aussi en demander un, par exemple « prévisualise l'application ».

Devin affiche une carte **Ouvrir l'aperçu** dans la conversation. Cliquez dessus pour ouvrir l'application dans l'onglet **Aperçu** de la session. Pour ouvrir plutôt l'aperçu dans un nouvel onglet du navigateur, faites Cmd-clic, Ctrl-clic ou clic du milieu sur la carte.

Dans une session démarrée depuis Slack, un lien **Ouvrir l'aperçu** est publié dans le fil de discussion.

## URL d’aperçu

Voici à quoi ressemble une URL d’aperçu :

```
https://<name>--<id>.preview.devinapps.com
```

Le nom correspond à celui que Devin donne à l'aperçu. L'id est aléatoire, ce qui rend l'URL impossible à deviner.

L'URL est propre à la session. Elle reste la même si Devin redémarre l'application ou la déplace vers un autre port. Un aperçu ouvert dans une autre session reçoit une URL différente.

Les URL d'aperçu permettent également de cibler individuellement chacun des ports que Devin expose sur la machine, grâce à une autre syntaxe :

```
https://<port>--<devin-id>.preview.devinapps.com
```

Ces ports doivent d'abord être exposés par Devin, mais une fois exposés, ils deviennent accessibles à tous.

## Qui peut ouvrir un aperçu

Les prévisualisations sont privées. Rien n’est exposé sur Internet.

Toute personne qui ouvre l’URL d’un aperçu doit être connectée à Devin. Ensuite, l’aperçu hérite des droits d’accès de sa session : si vous pouvez envoyer des messages à la session, vous pouvez ouvrir son aperçu.

Par défaut, cela concerne toutes les personnes de votre organisation autorisées à utiliser les sessions Devin. Vous pouvez donc envoyer le lien à un collègue et il fonctionnera immédiatement. Si l’accès à la session est réservé à son propriétaire ou à des personnes spécifiques, seules ces personnes peuvent ouvrir l’aperçu. Les autres voient une page indiquant que l’aperçu n’est pas disponible.

## Ce que vous pouvez faire dans l'onglet Aperçu

L'onglet Aperçu fonctionne comme un navigateur simplifié. Il propose des boutons pour avancer, revenir en arrière, actualiser, zoomer et rechercher dans la page, ainsi qu'un sélecteur de taille d'écran pour basculer entre les largeurs ordinateur, tablette et mobile.

Vous pouvez également annoter des éléments de la page et indiquer à Devin ce qu'il doit modifier. Dans une session, utilisez le bouton « Sélection » : il vous suffit de cliquer sur un élément ou de faire glisser le curseur sur une zone, d'ajouter une remarque, puis de l'envoyer dans la conversation. Devin reçoit l'élément sélectionné accompagné de votre remarque.

## Applications avec plusieurs ports

Un aperçu peut couvrir plusieurs ports, par exemple un frontend sur un port et une API backend sur un autre. Devin les liste tous lorsqu’il ouvre l’aperçu, qui s’affiche alors sur le premier port. Le menu **Ports** de l’onglet Aperçu permet de basculer de l’un à l’autre.

Votre frontend n’a pas besoin de connaître l’URL de l’aperçu. Si la page appelle `http://localhost:8000`, l’aperçu transmet cette requête au port 8000 de la machine de Devin. Un service worker installé par l’aperçu réécrit ces requêtes dans votre navigateur ; les connexions WebSocket sont traitées de la même manière. Comme la requête reste sur l’adresse de l’aperçu lui-même, vous n’avez pas besoin de modifier les paramètres CORS.

Seuls les ports que Devin a exposés pour l’aperçu sont accessibles de cette manière.

## Ce que voit votre application

Pour votre serveur, la requête provient de `localhost`. L’aperçu définit les en-têtes `Host` et `Origin` sur `localhost` avant que la requête n’atteigne votre application : les serveurs de développement qui vérifient le nom d’hôte fonctionnent donc sans configuration supplémentaire. Devin continue lui aussi d’utiliser `localhost`, aussi bien pour exécuter l’application que pour la tester.

Certains comportements diffèrent de ceux observés lorsque l’application s’exécute sur votre propre ordinateur :

* **Service workers.** L’aperçu utilise son propre service worker : votre application ne peut donc pas en enregistrer un. Si votre application est une PWA, désactivez le service worker en développement, ou acceptez que la réécriture automatique des ports puisse ne pas fonctionner.
* **Cookies.** Les cookies définis par votre application dans l’onglet Aperçu sont stockés séparément de ceux définis lorsque l’aperçu est ouvert dans un onglet de navigateur distinct. Si vous vous connectez à votre application à un endroit, vous devrez peut-être vous reconnecter à l’autre.
* **Connexion via un fournisseur d’identité.** Votre navigateur se trouve sur l’URL de l’aperçu, et non sur `localhost`. Un fournisseur tel que Microsoft Entra ID, Okta ou Google rejette la connexion si seul `localhost` est enregistré comme URL de redirection. Consultez [Tunnellisation des ports](#tunneling-ports).
* **Serveurs de développement HTTPS.** Votre navigateur voit le certificat de Devin, et non celui de votre serveur. Consultez [Bouclage HTTPS](#https-loopback).

## Tunnellisation des ports

Certains services ne fonctionnent que si votre navigateur est réellement sur `localhost`. Le cas le plus courant est la connexion via un fournisseur d’identité. Le fournisseur n’accepte que les URL de redirection que vous avez enregistrées, et la plupart des configurations de développement enregistrent `http://localhost:<port>`. Un aperçu ayant sa propre URL, le fournisseur la refuse.

Dans ces cas, vous pouvez créer un tunnel entre le port de la machine de Devin et votre propre ordinateur. L’application s’ouvre alors à l’adresse `http://localhost:<port>` dans votre navigateur, comme si elle s’exécutait sur votre ordinateur, et le fournisseur l’accepte.

Il existe deux façons de créer un tunnel pour un port :

* **Devin Desktop.** Ouvrez la session dans Devin Desktop et redirigez-y le port.
* **SSH.** Exécutez `devin forward <session> 3000`, ou passez `-L 3000:localhost:3000` à `devin ssh` ou à une simple commande `ssh`. Consultez [Rediriger des ports](https://docs.devinenterprise.com/fr/cli/ssh.md#forward-ports).

Un tunnel n’est accessible que depuis l’ordinateur qui l’exécute : ce n’est donc pas un lien que vous pouvez envoyer à un coéquipier. Utilisez un aperçu pour partager votre travail, et un tunnel lorsque `localhost` est indispensable.

Si vous préférez vous en tenir à l’aperçu, vous pouvez ajouter l’URL d’aperçu de la session à la liste des URL de redirection du fournisseur, ou prévoir dans l’application une connexion de développement qui contourne le fournisseur. Devin peut également se connecter sur `localhost` dans son propre navigateur. Consultez [Interactive Browser](https://docs.devinenterprise.com/fr/work-with-devin/devin-session-tools.md#interactive-browser).

## Bouclage HTTPS

Un serveur de développement qui sert du HTTPS sur son port fonctionne dans un aperçu sans aucune configuration supplémentaire. Devin détecte que le port utilise HTTPS et s'y connecte en conséquence.

Votre navigateur ne voit pas le certificat de votre serveur : l'URL d'aperçu est servie avec le certificat de Devin. La connexion à votre serveur de développement s'effectue sur la machine de Devin, où votre certificat n'est pas vérifié ; les certificats de développement auto-signés fonctionnent donc sans avertissement.

Ce point n'a d'importance que dans quelques cas bien précis, par exemple pour une application qui s'attend à ce que le navigateur voie un certificat spécifique.

## Sessions en veille

La machine de Devin se met en veille lorsque la session est inactive. Inutile de la sortir de veille vous-même : il suffit d'ouvrir l'Aperçu pour réactiver la machine, et l'application redevient accessible à la même URL. Le premier chargement de la page peut prendre quelques secondes.

La machine reste active tant que l'Aperçu est utilisé, puis se remet en veille environ 5 minutes après la dernière requête.

Un Aperçu cesse de fonctionner lorsque la session est archivée ou prend fin.

## Prévisualisations et Devin Apps

Une prévisualisation est liée à une seule session. Elle sert à consulter un travail en cours, à relire une modification ou à montrer à un collègue ce que Devin a créé. Dans la plupart des cas, une prévisualisation suffit.

Les Devin Apps répondent à un autre besoin : un outil interne, un tableau de bord ou une application similaire que votre équipe continue d'utiliser une fois le travail de la session terminé. Si c'est ce que vous développez, vous pouvez demander à Devin de publier la prévisualisation sous forme de [Devin App](https://docs.devinenterprise.com/fr/product-guides/devin-apps.md). Les Devin Apps sont servies de la même manière que les prévisualisations, depuis la machine de Devin, mais elles bénéficient d'une URL stable et de leurs propres paramètres de partage, plus complets.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.