{"meta":{"title":"Transfert de ports dans votre espace de code","intro":"Vous pouvez transférer des ports dans votre codespace pour tester et déboguer votre application. Vous pouvez également gérer le protocole de port et partager le port au sein de votre organisation ou publiquement.","product":"Codespaces","breadcrumbs":[{"href":"/fr/codespaces","title":"Codespaces"},{"href":"/fr/codespaces/developing-in-a-codespace","title":"Développement dans un espace de code"},{"href":"/fr/codespaces/developing-in-a-codespace/forwarding-ports-in-your-codespace","title":"Transférer des ports"}],"documentType":"article"},"body":"# Transfert de ports dans votre espace de code\n\nVous pouvez transférer des ports dans votre codespace pour tester et déboguer votre application. Vous pouvez également gérer le protocole de port et partager le port au sein de votre organisation ou publiquement.\n\n## À propos des ports transférés\n\nLe transfert de port vous permet d’accéder aux ports TCP qui s’exécutent dans votre espace de code. Par exemple, si vous exécutez une application web sur un port particulier dans votre codespace, vous pouvez transférer ce port. Cela vous permet d’accéder à l’application à partir du navigateur sur votre ordinateur local pour les tests et le débogage.\n\n<div class=\"ghd-tool webui\">\n\nLorsqu’une application s’exécutant à l’intérieur d’un codespace imprime la sortie vers le terminal qui contient une URL localhost, par exemple `http://localhost:PORT` ou `http://127.0.0.1:PORT`, le port est automatiquement transféré. Si vous utilisez GitHub Codespaces dans le navigateur ou dans Visual Studio Code, la chaîne d’URL du terminal est convertie en un lien sur lequel vous pouvez cliquer pour afficher la page web sur votre ordinateur local. Par défaut, GitHub Codespaces transfère les ports à l’aide de HTTP.\n\nVous pouvez modifier la configuration de conteneur de développement pour que le dépôt transfère automatiquement un ou plusieurs ports. Vous pouvez également transférer un port manuellement, étiqueter les ports transférés, partager des ports transférés avec des membres de votre organisation, partager des ports transférés publiquement et ajouter des ports transférés à la configuration du codespace.\n\n> \\[!NOTE]\n> Les propriétaires d’organisation peuvent restreindre la possibilité de rendre les ports de réacheminement disponibles publiquement ou au sein de l’organisation. Pour plus d’informations, consultez « [Restriction de la visibilité des ports transférés](/fr/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports) ».\n\n## Transfert d’un port\n\nVous pouvez transférer manuellement un port qui n’a pas été transféré automatiquement.\n\n1. Ouvrez le terminal dans votre codespace.\n\n2. Cliquez sur l’onglet **PORTS**.\n\n3. Sous la liste des ports, cliquez sur **Ajouter un port**.\n\n   ![Capture d’écran du bouton « Ajouter un port » pour un codespace.](/assets/images/help/codespaces/add-port-button.png)\n\n4. Tapez le numéro de port ou l’adresse, puis appuyez sur Entrée.\n\n   ![Capture d’écran du numéro 3000 en cours de saisie dans le champ de numéro de port pour un nouveau port transféré.](/assets/images/help/codespaces/port-number-text-box.png)\n\n## Utilisation du transfert HTTPS\n\nPar défaut, GitHub Codespaces transfère les ports à l’aide de HTTP, mais vous pouvez mettre à jour n’importe quel port pour utiliser HTTPS, selon les besoins. Si vous mettez à jour un port avec une visibilité publique pour utiliser HTTPS, la visibilité du port devient automatiquement privée.\n\n1. Ouvrez le terminal dans votre codespace.\n\n2. Cliquez sur l’onglet **PORTS**.\n\n3. Cliquez avec le bouton droit sur le port à mettre à jour, puis pointez sur **Changer le protocole de port**.\n\n   ![Capture d’écran du menu contextuel d’un port transféré, avec l’option « Changer le protocole de port » sélectionnée et « HTTPS » sélectionné dans le sous-menu.](/assets/images/help/codespaces/update-port-protocol.png)\n\n4. Sélectionnez le protocole nécessaire pour ce port. Le protocole que vous sélectionnez sera mémorisé pour ce port pour la durée de vie du codespace.\n\n## Partage d’un fichier\n\n> \\[!NOTE]\n> Vous ne pouvez rendre un port privé que pour une organisation, si votre organisation utilise des données GitHub Team ou GitHub Enterprise Cloud.\n\nSi vous souhaitez partager un port transféré avec d’autres personnes, vous pouvez soit rendre le port privé pour votre organisation, soit rendre le port public. Une fois que vous avez créé un port privé pour votre organisation, toute personne de l’organisation disposant de l’URL du port peut afficher l’application en cours d’exécution. Après avoir rendu un port public, toute personne qui connaît l’URL et le numéro de port peuvent afficher l’application en cours d’exécution sans avoir à s’authentifier.\n\n> \\[!NOTE]\n> Votre choix d’options de visibilité de port peut être limité par une stratégie configurée pour votre organisation. Pour plus d’informations, consultez « [Restriction de la visibilité des ports transférés](/fr/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports) ».\n\n1. Ouvrez le terminal dans votre codespace.\n\n2. Cliquez sur l’onglet **PORTS**.\n\n3. Cliquez avec le bouton droit sur le port que vous voulez partager, cliquez sur **Visibilité du port**, puis sur **Réservée à l’organisation** ou **Publique**.\n\n   ![Capture d’écran du menu contextuel d’un port transféré, avec l’option « Visibilité du port » sélectionnée et « Privé » sélectionné dans le sous-menu.](/assets/images/help/codespaces/make-public-option.png)\n\n4. À droite de l’adresse locale du port, cliquez sur l’icône de copie.\n\n   ![Capture d’écran du volet « Ports ». L’icône de copie, qui copie l’URL d’un port transféré, est mise en évidence avec un encadré orange.](/assets/images/help/codespaces/copy-icon-port-url.png)\n\n5. Envoyez l’URL copiée à la personne avec laquelle vous souhaitez partager le port.\n\n## Utilisation d’outils en ligne de commande et de clients REST pour accéder aux ports\n\nLorsque vous transférez un port, votre application devient disponible à une URL `https://CODESPACENAME-PORT.app.github.dev`. Par exemple : `https://monalisa-hot-potato-vrpqrxxrx7x2rxx-4000.app.github.dev`. Si vous transférez un port privé à partir de l’application de bureau VS Code, votre application sera également disponible sur un port localhost tel que `127.0.0.1:4000`.\n\nPour accéder à votre application à l’aide d’un client REST, tel que Postman, ou d’un outil en ligne de commande comme curl, vous n’avez pas besoin de vous authentifier si vous utilisez un port localhost ou si vous accédez à un port public sur le domaine distant. Toutefois, pour vous connecter à un port privé au niveau du domaine distant, vous devez vous authentifier avec le jeton d’accès `GITHUB_TOKEN` dans votre demande.\n\n> \\[!NOTE]\n> `GITHUB_TOKEN` est créé automatiquement lorsque vous démarrez un codespace et reste le même pendant la durée de la session du codespace. Si vous arrêtez, puis redémarrez un codespace, un nouveau `GITHUB_TOKEN` est généré.\n\n<!-- Don't delete this comment. It prevents a formatting issue. -->\n\n### Recherche de l’adresse à laquelle se connecter\n\n1. Ouvrez le terminal dans votre codespace.\n\n2. Cliquez sur l’onglet **PORTS**, qui liste tous les ports que vous avez transférés.\n\n3. Cliquez avec le bouton droit sur le port auquel vous souhaitez vous connecter, puis cliquez sur **Copier l’adresse locale**.\n\n   ![Capture d’écran du menu contextuel d’un port transféré avec l’option « Copier l’adresse locale » mise en évidence avec un encadré orange.](/assets/images/help/codespaces/copy-local-address.png)\n\n4. Collez l’adresse copiée quelque part pour l’utiliser ultérieurement.\n\n### Recherche du GITHUB\\_TOKEN\n\n1. Dans le terminal de votre codespace, entrez `echo $GITHUB_TOKEN`.\n\n   Le jeton est une chaîne commençant par `ghu_`.\n\n2. Copiez le jeton.\n\n   > \\[!IMPORTANT]\n   > Ne partagez ce jeton d’accès avec personne.\n\n### Utilisation de curl pour accéder à un port transféré\n\nDans un terminal sur votre ordinateur local, entrez :\n\n```shell\ncurl ADDRESS -H \"X-Github-Token: TOKEN\"\n```\n\nRemplacez `ADDRESS` et `TOKEN` par les valeurs que vous avez copiées.\n\n### Utilisation de Postman pour accéder à un port transféré\n\n1. Ouvrez Postman.\n\n2. Créez une nouvelle requête GET.\n\n3. Collez l’adresse que vous avez copiée précédemment en tant qu’URL de requête.\n\n   ![Capture d’écran de l’URL du port transféré, collée dans Postman en tant qu’URL de requête GET. L’URL est mise en surbrillance.](/assets/images/help/codespaces/postman-screenshot-url.png)\n\n4. Sous l’onglet **En-têtes**, créez une entrée où la clé est « X-Github-Token » et la valeur est le `GITHUB_TOKEN` que vous avez copié précédemment.\n\n   ![Capture d’écran d’un GITHUB\\_TOKEN factice, collé dans Postman comme valeur de la clé X-GitHub-Token. La clé et la valeur sont mises en évidence.](/assets/images/help/codespaces/postman-screenshot-key-token.png)\n\n5. Cliquez sur **Envoyer**.\n\n## Transfert automatique d’un port\n\nVous pouvez ajouter un port transféré à la configuration GitHub Codespaces pour le référentiel, afin que le port soit automatiquement transféré pour tous les codespaces créés à partir du référentiel. Après avoir mis à jour la configuration, tous les codespaces créés précédemment doivent être reconstruits pour que la modification s’applique. Pour plus d’informations sur le fichier de configuration de conteneur de développement, consultez [Présentation des conteneurs de développement](/fr/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers#applying-configuration-changes-to-a-codespace).\n\n1. Dans votre codespace, ouvrez le fichier de configuration du conteneur de développement que vous souhaitez mettre à jour. En règle générale, ce fichier est `.devcontainer/devcontainer.json`.\n\n2. Ajouter la propriété `forwardPorts`\n\n   ```json\n   \"forwardPorts\": [NUMBER],\n   ```\n\n   Remplacez `NUMBER` par le numéro de port que vous voulez transférer. Il peut s’agir d’une liste de numéros de port séparés par des virgules.\n\n3. Enregistrez le fichier .\n\n## Étiquetage d’un port\n\nLorsque vous ouvrez un codespace dans le navigateur ou dans l’application de bureau VS Code, vous pouvez étiqueter un port transféré pour en faciliter l’identification dans une liste.\n\n1. Ouvrez le terminal dans votre codespace.\n\n2. Cliquez sur l’onglet **PORTS**.\n\n3. Cliquez avec le bouton droit sur le port que vous souhaitez étiqueter, puis cliquez sur **Définir l’étiquette du port**.\n\n   ![Capture d’écran du menu contextuel d’un port transféré avec l’option « Définir l’étiquette du port » mise en évidence avec un encadré orange.](/assets/images/help/codespaces/set-port-label.png)\n\n4. Tapez une étiquette pour votre port, puis appuyez sur Entrée.\n\n   ![Capture d’écran de l’étiquette « Préproduction » ajoutée en tant qu’étiquette personnalisée pour un port transféré.](/assets/images/help/codespaces/label-text-box.png)\n\n### Étiquetage automatique d’un port transféré\n\nVous pouvez étiqueter un port et écrire la modification dans un fichier de configuration de conteneur de développement pour le dépôt. Si vous effectuez cette opération pour un port qui est automatiquement transféré à l’aide de la propriété `forwardPorts`, l’étiquette est automatiquement appliquée à ce port transféré pour tous les codespaces qui seront créés dans le dépôt avec ce fichier de configuration.\n\n1. Ouvrez le terminal dans votre codespace.\n\n2. Cliquez sur l’onglet **PORTS**.\n\n3. Cliquez avec le bouton droit sur le port dont vous souhaitez ajouter l’attribut d’étiquetage à la configuration du codespace, puis cliquez sur **Définir l’étiquette et mettre à jour devcontainer.json**.\n\n   ![Capture d’écran du menu contextuel d’un port transféré, avec l’option « Définir l’étiquette et mettre à jour devcontainer.json » mise en évidence avec un encadré orange.](/assets/images/help/codespaces/update-devcontainer-to-add-port-option.png)\n\n4. Tapez une étiquette pour votre port, puis appuyez sur Entrée.\n\n   ![Capture d’écran de l’étiquette « Préproduction » ajoutée en tant qu’étiquette personnalisée pour un port transféré.](/assets/images/help/codespaces/label-text-box.png)\n\n5. Si votre dépôt contient plusieurs fichiers de configuration de conteneur de développement, vous êtes invité à choisir le fichier que vous souhaitez mettre à jour.\n\n   Le fichier de configuration de conteneur de développement est mis à jour pour inclure la nouvelle étiquette dans la propriété `portsAttributes`. Par exemple :\n\n   ```jsonc\n   // Use 'forwardPorts' to make a list of ports inside the container available locally.\n   \"forwardPorts\": [3333, 4444],\n\n   \"portsAttributes\": {\n     \"3333\": {\n       \"label\": \"app-standard-preview\"\n     },\n     \"4444\": {\n       \"label\": \"app-pro-preview\"\n     }\n   }\n   ```\n\n</div>\n\n<div class=\"ghd-tool vscode\">\n\nLorsqu’une application s’exécutant à l’intérieur d’un codespace imprime la sortie vers le terminal qui contient une URL localhost, par exemple `http://localhost:PORT` ou `http://127.0.0.1:PORT`, le port est automatiquement transféré. Si vous utilisez GitHub Codespaces dans le navigateur ou dans Visual Studio Code, la chaîne d’URL du terminal est convertie en un lien sur lequel vous pouvez cliquer pour afficher la page web sur votre ordinateur local. Par défaut, GitHub Codespaces transfère les ports à l’aide de HTTP.\n\nVous pouvez modifier la configuration de conteneur de développement pour que le dépôt transfère automatiquement un ou plusieurs ports. Vous pouvez également transférer un port manuellement, étiqueter les ports transférés, partager des ports transférés avec des membres de votre organisation, partager des ports transférés publiquement et ajouter des ports transférés à la configuration du codespace.\n\n> \\[!NOTE]\n> Les propriétaires d’organisation peuvent restreindre la possibilité de rendre les ports de réacheminement disponibles publiquement ou au sein de l’organisation. Pour plus d’informations, consultez « [Restriction de la visibilité des ports transférés](/fr/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports) ».\n\n## Transfert d’un port\n\nVous pouvez transférer manuellement un port qui n’a pas été transféré automatiquement.\n\n1. Ouvrez le terminal dans votre codespace.\n\n2. Cliquez sur l’onglet **PORTS**.\n\n3. Sous la liste des ports, cliquez sur **Ajouter un port**.\n\n   ![Capture d’écran du bouton « Ajouter un port » pour un codespace.](/assets/images/help/codespaces/add-port-button.png)\n\n4. Tapez le numéro de port ou l’adresse, puis appuyez sur Entrée.\n\n   ![Capture d’écran du numéro 3000 en cours de saisie dans le champ de numéro de port pour un nouveau port transféré.](/assets/images/help/codespaces/port-number-text-box.png)\n\n## Partage d’un fichier\n\n> \\[!NOTE]\n> Vous ne pouvez rendre un port privé que pour une organisation, si votre organisation utilise des données GitHub Team ou GitHub Enterprise Cloud.\n\nSi vous souhaitez partager un port transféré avec d’autres personnes, vous pouvez soit rendre le port privé pour votre organisation, soit rendre le port public. Une fois que vous avez créé un port privé pour votre organisation, toute personne de l’organisation disposant de l’URL du port peut afficher l’application en cours d’exécution. Après avoir rendu un port public, toute personne qui connaît l’URL et le numéro de port peuvent afficher l’application en cours d’exécution sans avoir à s’authentifier.\n\n> \\[!NOTE]\n> Votre choix d’options de visibilité de port peut être limité par une stratégie configurée pour votre organisation. Pour plus d’informations, consultez « [Restriction de la visibilité des ports transférés](/fr/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports) ».\n\n1. Ouvrez le terminal dans votre codespace.\n\n2. Cliquez sur l’onglet **PORTS**.\n\n3. Cliquez avec le bouton droit sur le port que vous voulez partager, cliquez sur **Visibilité du port**, puis sur **Réservée à l’organisation** ou **Publique**.\n\n   ![Capture d’écran du menu contextuel d’un port transféré, avec l’option « Visibilité du port » sélectionnée et « Privé » sélectionné dans le sous-menu.](/assets/images/help/codespaces/make-public-option.png)\n\n4. À droite de l’adresse locale du port, cliquez sur l’icône de copie.\n\n   ![Capture d’écran du volet « Ports ». L’icône de copie, qui copie l’URL d’un port transféré, est mise en évidence avec un encadré orange.](/assets/images/help/codespaces/copy-icon-port-url.png)\n\n5. Envoyez l’URL copiée à la personne avec laquelle vous souhaitez partager le port.\n\n## Utilisation d’outils en ligne de commande et de clients REST pour accéder aux ports\n\nLorsque vous transférez un port, votre application devient disponible à une URL `https://CODESPACENAME-PORT.app.github.dev`. Par exemple : `https://monalisa-hot-potato-vrpqrxxrx7x2rxx-4000.app.github.dev`. Si vous transférez un port privé à partir de l’application de bureau VS Code, votre application sera également disponible sur un port localhost tel que `127.0.0.1:4000`.\n\nPour accéder à votre application à l’aide d’un client REST, tel que Postman, ou d’un outil en ligne de commande comme curl, vous n’avez pas besoin de vous authentifier si vous utilisez un port localhost ou si vous accédez à un port public sur le domaine distant. Toutefois, pour vous connecter à un port privé au niveau du domaine distant, vous devez vous authentifier avec le jeton d’accès `GITHUB_TOKEN` dans votre demande.\n\n> \\[!NOTE]\n> `GITHUB_TOKEN` est créé automatiquement lorsque vous démarrez un codespace et reste le même pendant la durée de la session du codespace. Si vous arrêtez, puis redémarrez un codespace, un nouveau `GITHUB_TOKEN` est généré.\n\n<!-- Don't delete this comment. It prevents a formatting issue. -->\n\n### Recherche de l’adresse à laquelle se connecter\n\n1. Ouvrez le terminal dans votre codespace.\n\n2. Cliquez sur l’onglet **PORTS**, qui liste tous les ports que vous avez transférés.\n\n3. Cliquez avec le bouton droit sur le port auquel vous souhaitez vous connecter, puis cliquez sur **Copier l’adresse locale**.\n\n   ![Capture d’écran du menu contextuel d’un port transféré avec l’option « Copier l’adresse locale » mise en évidence avec un encadré orange.](/assets/images/help/codespaces/copy-local-address.png)\n\n4. Collez l’adresse copiée quelque part pour l’utiliser ultérieurement.\n\n### Recherche du GITHUB\\_TOKEN\n\n1. Dans le terminal de votre codespace, entrez `echo $GITHUB_TOKEN`.\n\n   Le jeton est une chaîne commençant par `ghu_`.\n\n2. Copiez le jeton.\n\n   > \\[!IMPORTANT]\n   > Ne partagez ce jeton d’accès avec personne.\n\n### Utilisation de curl pour accéder à un port transféré\n\nDans un terminal sur votre ordinateur local, entrez :\n\n```shell\ncurl ADDRESS -H \"X-Github-Token: TOKEN\"\n```\n\nRemplacez `ADDRESS` et `TOKEN` par les valeurs que vous avez copiées.\n\n### Utilisation de Postman pour accéder à un port transféré\n\n1. Ouvrez Postman.\n\n2. Créez une nouvelle requête GET.\n\n3. Collez l’adresse que vous avez copiée précédemment en tant qu’URL de requête.\n\n   ![Capture d’écran de l’URL du port transféré, collée dans Postman en tant qu’URL de requête GET. L’URL est mise en surbrillance.](/assets/images/help/codespaces/postman-screenshot-url.png)\n\n4. Sous l’onglet **En-têtes**, créez une entrée où la clé est « X-Github-Token » et la valeur est le `GITHUB_TOKEN` que vous avez copié précédemment.\n\n   ![Capture d’écran d’un GITHUB\\_TOKEN factice, collé dans Postman comme valeur de la clé X-GitHub-Token. La clé et la valeur sont mises en évidence.](/assets/images/help/codespaces/postman-screenshot-key-token.png)\n\n5. Cliquez sur **Envoyer**.\n\n## Transfert automatique d’un port\n\nVous pouvez ajouter un port transféré à la configuration GitHub Codespaces pour le référentiel, afin que le port soit automatiquement transféré pour tous les codespaces créés à partir du référentiel. Après avoir mis à jour la configuration, tous les codespaces créés précédemment doivent être reconstruits pour que la modification s’applique. Pour plus d’informations sur le fichier de configuration de conteneur de développement, consultez [Présentation des conteneurs de développement](/fr/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers#applying-configuration-changes-to-a-codespace).\n\n1. Dans votre codespace, ouvrez le fichier de configuration du conteneur de développement que vous souhaitez mettre à jour. En règle générale, ce fichier est `.devcontainer/devcontainer.json`.\n\n2. Ajouter la propriété `forwardPorts`\n\n   ```json\n   \"forwardPorts\": [NUMBER],\n   ```\n\n   Remplacez `NUMBER` par le numéro de port que vous voulez transférer. Il peut s’agir d’une liste de numéros de port séparés par des virgules.\n\n3. Enregistrez le fichier .\n\n## Étiquetage d’un port\n\nLorsque vous ouvrez un codespace dans le navigateur ou dans l’application de bureau VS Code, vous pouvez étiqueter un port transféré pour en faciliter l’identification dans une liste.\n\n1. Ouvrez le terminal dans votre codespace.\n\n2. Cliquez sur l’onglet **PORTS**.\n\n3. Cliquez avec le bouton droit sur le port que vous souhaitez étiqueter, puis cliquez sur **Définir l’étiquette du port**.\n\n   ![Capture d’écran du menu contextuel d’un port transféré avec l’option « Définir l’étiquette du port » mise en évidence avec un encadré orange.](/assets/images/help/codespaces/set-port-label.png)\n\n4. Tapez une étiquette pour votre port, puis appuyez sur Entrée.\n\n   ![Capture d’écran de l’étiquette « Préproduction » ajoutée en tant qu’étiquette personnalisée pour un port transféré.](/assets/images/help/codespaces/label-text-box.png)\n\n### Étiquetage automatique d’un port transféré\n\nVous pouvez étiqueter un port et écrire la modification dans un fichier de configuration de conteneur de développement pour le dépôt. Si vous effectuez cette opération pour un port qui est automatiquement transféré à l’aide de la propriété `forwardPorts`, l’étiquette est automatiquement appliquée à ce port transféré pour tous les codespaces qui seront créés dans le dépôt avec ce fichier de configuration.\n\n1. Ouvrez le terminal dans votre codespace.\n\n2. Cliquez sur l’onglet **PORTS**.\n\n3. Cliquez avec le bouton droit sur le port dont vous souhaitez ajouter l’attribut d’étiquetage à la configuration du codespace, puis cliquez sur **Définir l’étiquette et mettre à jour devcontainer.json**.\n\n   ![Capture d’écran du menu contextuel d’un port transféré, avec l’option « Définir l’étiquette et mettre à jour devcontainer.json » mise en évidence avec un encadré orange.](/assets/images/help/codespaces/update-devcontainer-to-add-port-option.png)\n\n4. Tapez une étiquette pour votre port, puis appuyez sur Entrée.\n\n   ![Capture d’écran de l’étiquette « Préproduction » ajoutée en tant qu’étiquette personnalisée pour un port transféré.](/assets/images/help/codespaces/label-text-box.png)\n\n5. Si votre dépôt contient plusieurs fichiers de configuration de conteneur de développement, vous êtes invité à choisir le fichier que vous souhaitez mettre à jour.\n\n   Le fichier de configuration de conteneur de développement est mis à jour pour inclure la nouvelle étiquette dans la propriété `portsAttributes`. Par exemple :\n\n   ```jsonc\n   // Use 'forwardPorts' to make a list of ports inside the container available locally.\n   \"forwardPorts\": [3333, 4444],\n\n   \"portsAttributes\": {\n     \"3333\": {\n       \"label\": \"app-standard-preview\"\n     },\n     \"4444\": {\n       \"label\": \"app-pro-preview\"\n     }\n   }\n   ```\n\n</div>\n\n<div class=\"ghd-tool cli\">\n\n> \\[!NOTE]\n> Pour plus d’informations sur GitHub CLI, consultez [À propos de l’interface CLI GitHub](/fr/github-cli/github-cli/about-github-cli).\n\nPour transférer un port, utilisez la sous-commande `gh codespace ports forward`. Remplacez `codespace-port:local-port` par les ports distants et locaux que vous souhaitez connecter. Après avoir entré la commande, faites votre choix dans la liste des codespaces affichée.\n\n```shell\ngh codespace ports forward CODESPACE-PORT:LOCAL-PORT\n```\n\nPour plus d’informations sur cette commande, consultez [le manuel de GitHub CLI](https://cli.github.com/manual/gh_codespace_ports_forward).\n\nPour afficher les détails de ports transférés, entrez `gh codespace ports`, puis choisissez un codespace.\n\n## Partage d’un fichier\n\n> \\[!NOTE]\n> Vous ne pouvez rendre un port privé que pour une organisation, si votre organisation utilise des données GitHub Team ou GitHub Enterprise Cloud.\n\nSi vous souhaitez partager un port transféré avec d’autres personnes, vous pouvez soit rendre le port privé pour votre organisation, soit rendre le port public. Une fois que vous avez créé un port privé pour votre organisation, toute personne de l’organisation disposant de l’URL du port peut afficher l’application en cours d’exécution. Après avoir rendu un port public, toute personne qui connaît l’URL et le numéro de port peuvent afficher l’application en cours d’exécution sans avoir à s’authentifier.\n\n> \\[!NOTE]\n> Votre choix d’options de visibilité de port peut être limité par une stratégie configurée pour votre organisation. Pour plus d’informations, consultez « [Restriction de la visibilité des ports transférés](/fr/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports) ».\n\nPour modifier la visibilité d’un port transféré, utilisez la sous-commande `gh codespace ports visibility`. Il existe trois paramètres de visibilité :\n\n* `private` - Visible uniquement par vous. Il s’agit du paramètre par défaut quand vous transférez un port.\n* `org` - Visible par les membres de l’organisation propriétaire du dépôt.\n* `public` - Visible par toute personne connaissant l’URL et le numéro de port.\n\nRemplacez `codespace-port` par le numéro de port transféré. Remplacer `setting` par `private`, `org`ou `public`. Après avoir entré la commande, faites votre choix dans la liste des codespaces affichée.\n\n```shell\ngh codespace ports visibility CODESPACE-PORT:SETTINGS\n```\n\nVous pouvez définir la visibilité de plusieurs ports avec une seule commande. Par exemple :\n\n```shell\ngh codespace ports visibility 80:private 3000:public 3306:org\n```\n\nPour plus d’informations sur cette commande, consultez [le manuel de GitHub CLI](https://cli.github.com/manual/gh_codespace_ports_visibility).\n\n## Utilisation d’outils en ligne de commande et de clients REST pour accéder aux ports\n\nLorsque vous transférez un port, votre application devient disponible à une URL `https://CODESPACENAME-PORT.app.github.dev`. Par exemple : `https://monalisa-hot-potato-vrpqrxxrx7x2rxx-4000.app.github.dev`. Si vous transférez un port privé à partir de l’application de bureau VS Code, votre application sera également disponible sur un port localhost tel que `127.0.0.1:4000`.\n\nPour accéder à votre application à l’aide d’un client REST, tel que Postman, ou d’un outil en ligne de commande comme curl, vous n’avez pas besoin de vous authentifier si vous utilisez un port localhost ou si vous accédez à un port public sur le domaine distant. Toutefois, pour vous connecter à un port privé au niveau du domaine distant, vous devez vous authentifier avec le jeton d’accès `GITHUB_TOKEN` dans votre demande.\n\n> \\[!NOTE]\n> `GITHUB_TOKEN` est créé automatiquement lorsque vous démarrez un codespace et reste le même pendant la durée de la session du codespace. Si vous arrêtez, puis redémarrez un codespace, un nouveau `GITHUB_TOKEN` est généré.\n\n<!-- Don't delete this comment. It prevents a formatting issue. -->\n\n### Recherche de l’adresse à laquelle se connecter\n\nPour trouver l’adresse d’un port transféré, entrez `gh codespace ports`. Si vous avez plusieurs codespaces, sélectionnez le codespace approprié dans la liste qui s’affiche.\n\nCopiez l’adresse et collez-la quelque part pour l’utiliser ultérieurement.\n\n### Trouver le GITHUB\\_TOKEN\n\n1. Démarrez une session SSH pour votre codespace.\n\n   ```shell\n   gh codespace ssh\n   ```\n\n2. Si vous avez plusieurs codespaces, sélectionnez le codespace approprié dans la liste qui s’affiche.\n\n3. Affichez le `GITHUB_TOKEN`.\n\n   ```shell\n   echo $GITHUB_TOKEN\n   ```\n\n   Le jeton est une chaîne commençant par `ghu_`.\n\n4. Copiez le jeton.\n\n   > \\[!IMPORTANT]\n   > Ne partagez ce jeton d’accès avec personne.\n\n5. Quittez la session SSH.\n\n   ```shell\n   exit\n   ```\n\n### Utilisation de curl pour accéder à un port transféré\n\nDans un terminal sur votre ordinateur local, entrez :\n\n```shell\ncurl ADDRESS -H \"X-Github-Token: TOKEN\"\n```\n\nRemplacez `ADDRESS` et `TOKEN` par les valeurs que vous avez copiées.\n\n### Utilisation de Postman pour accéder à un port transféré\n\n1. Ouvrez Postman.\n\n2. Créez une nouvelle requête GET.\n\n3. Collez l’adresse que vous avez copiée précédemment en tant qu’URL de requête.\n\n   ![Capture d’écran de l’URL du port transféré, collée dans Postman en tant qu’URL de requête GET. L’URL est mise en surbrillance.](/assets/images/help/codespaces/postman-screenshot-url.png)\n\n4. Sous l’onglet **En-têtes**, créez une entrée où la clé est « X-Github-Token » et la valeur est le `GITHUB_TOKEN` que vous avez copié précédemment.\n\n   ![Capture d’écran d’un GITHUB\\_TOKEN factice, collé dans Postman comme valeur de la clé X-GitHub-Token. La clé et la valeur sont mises en évidence.](/assets/images/help/codespaces/postman-screenshot-key-token.png)\n\n5. Cliquez sur **Envoyer**.\n\n## Transfert automatique d’un port\n\nVous pouvez ajouter un port transféré à la configuration GitHub Codespaces pour le référentiel, afin que le port soit automatiquement transféré pour tous les codespaces créés à partir du référentiel. Après avoir mis à jour la configuration, tous les codespaces créés précédemment doivent être reconstruits pour que la modification s’applique. Pour plus d’informations sur le fichier de configuration de conteneur de développement, consultez [Présentation des conteneurs de développement](/fr/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers#applying-configuration-changes-to-a-codespace).\n\n1. Dans votre codespace, ouvrez le fichier de configuration du conteneur de développement que vous souhaitez mettre à jour. En règle générale, ce fichier est `.devcontainer/devcontainer.json`.\n\n2. Ajouter la propriété `forwardPorts`\n\n   ```json\n   \"forwardPorts\": [NUMBER],\n   ```\n\n   Remplacez `NUMBER` par le numéro de port que vous voulez transférer. Il peut s’agir d’une liste de numéros de port séparés par des virgules.\n\n3. Enregistrez le fichier .\n\n## Étiquetage d’un port\n\nLorsque vous ouvrez un codespace dans le navigateur ou dans l’application de bureau VS Code, vous pouvez étiqueter un port transféré pour en faciliter l’identification dans une liste.\n\n1. Ouvrez le terminal dans votre codespace.\n\n2. Cliquez sur l’onglet **PORTS**.\n\n3. Cliquez avec le bouton droit sur le port que vous souhaitez étiqueter, puis cliquez sur **Définir l’étiquette du port**.\n\n   ![Capture d’écran du menu contextuel d’un port transféré avec l’option « Définir l’étiquette du port » mise en évidence avec un encadré orange.](/assets/images/help/codespaces/set-port-label.png)\n\n4. Tapez une étiquette pour votre port, puis appuyez sur Entrée.\n\n   ![Capture d’écran de l’étiquette « Préproduction » ajoutée en tant qu’étiquette personnalisée pour un port transféré.](/assets/images/help/codespaces/label-text-box.png)\n\n### Étiquetage automatique d’un port transféré\n\nVous pouvez étiqueter un port et écrire la modification dans un fichier de configuration de conteneur de développement pour le dépôt. Si vous effectuez cette opération pour un port qui est automatiquement transféré à l’aide de la propriété `forwardPorts`, l’étiquette est automatiquement appliquée à ce port transféré pour tous les codespaces qui seront créés dans le dépôt avec ce fichier de configuration.\n\n1. Ouvrez le terminal dans votre codespace.\n\n2. Cliquez sur l’onglet **PORTS**.\n\n3. Cliquez avec le bouton droit sur le port dont vous souhaitez ajouter l’attribut d’étiquetage à la configuration du codespace, puis cliquez sur **Définir l’étiquette et mettre à jour devcontainer.json**.\n\n   ![Capture d’écran du menu contextuel d’un port transféré, avec l’option « Définir l’étiquette et mettre à jour devcontainer.json » mise en évidence avec un encadré orange.](/assets/images/help/codespaces/update-devcontainer-to-add-port-option.png)\n\n4. Tapez une étiquette pour votre port, puis appuyez sur Entrée.\n\n   ![Capture d’écran de l’étiquette « Préproduction » ajoutée en tant qu’étiquette personnalisée pour un port transféré.](/assets/images/help/codespaces/label-text-box.png)\n\n5. Si votre dépôt contient plusieurs fichiers de configuration de conteneur de développement, vous êtes invité à choisir le fichier que vous souhaitez mettre à jour.\n\n   Le fichier de configuration de conteneur de développement est mis à jour pour inclure la nouvelle étiquette dans la propriété `portsAttributes`. Par exemple :\n\n   ```jsonc\n   // Use 'forwardPorts' to make a list of ports inside the container available locally.\n   \"forwardPorts\": [3333, 4444],\n\n   \"portsAttributes\": {\n     \"3333\": {\n       \"label\": \"app-standard-preview\"\n     },\n     \"4444\": {\n       \"label\": \"app-pro-preview\"\n     }\n   }\n   ```\n\n### Affichage des étiquettes de port sur la ligne de commande\n\nVous pouvez voir les étiquettes de port quand vous listez les ports transférés pour un codespace. Pour ce faire, utilisez la commande `gh codespace ports`, puis sélectionnez un codespace.\n\n</div>"}