Présentation

Un tunnel permet à votre Site de se connecter à un service du réseau privé de votre entreprise, comme une API interne de gestion des stocks, sans rendre ce service accessible au public.

Votre équipe informatique exécute le client de tunnel d’OpenAI, un petit programme qui transmet les requêtes et les réponses entre le Site et le service.

Connectez uniquement des services que votre organisation autorise le Site à utiliser. Limitez l’accès aux données et aux actions dont il a besoin.

Un tunnel ne remplace pas l’authentification ni les contrôles d’accès du service. Il ne donne pas au Site accès à l’ensemble de votre réseau et ne détermine pas les informations que les visiteurs peuvent voir.

Disponibilité

Les tunnels sont en cours de déploiement dans les espaces de travail Enterprise éligibles. Ils doivent être activés pour votre espace de travail avant que vous puissiez en connecter un à un Site.

Un administrateur de l’espace de travail doit activer Autoriser les membres à associer des tunnels privés pour le propriétaire du Site et la personne qui connecte le tunnel.

Avant de commencer

• Collaborez avec le propriétaire du Site, l’administrateur de votre espace de travail, votre équipe informatique et la personne responsable du service privé.

• Identifiez le service, les données et les actions dont le Site a besoin, ainsi que les personnes qui doivent pouvoir les utiliser.

• Confirmez quel Site utilisera la connexion et qui gérera le Site, le client de tunnel et le service privé.

• Choisissez un ordinateur ou un serveur capable d’exécuter le client de tunnel d’OpenAI et de joindre le service via HTTP ou HTTPS. Confirmez que votre organisation autorise la connexion.

• Demandez au responsable du service de confirmer les données et les actions auxquelles le Site peut accéder et de configurer l’authentification et les contrôles d’accès du service.

Installer le client de tunnel

Votre équipe informatique installe et exécute le client de tunnel d’OpenAI sur un ordinateur ou un serveur capable de joindre le service privé.

Pour les instructions d’installation et de déploiement, consultez la documentation officielle de tunnel-client.

Sur macOS, avec Homebrew installé, exécutez :

brew install openai/tools/tunnel-client

tunnel-client --version

Conservez les identifiants d’exécution sur l’hôte qui exécute le client. N’incluez pas de clés API ni de mots de passe dans le contenu du Site, le code côté navigateur, les captures d’écran ou les messages envoyés à l’assistance.

Préparer la connexion

Utilisez un tunnel disponible dans l’espace de travail du Site. Collaborez avec votre équipe informatique pour connecter le Site et demandez au responsable du service de configurer l’authentification et de limiter l’accès aux données et aux actions dont le Site a besoin.

Avant de partager le Site, testez-le avec des données d’exemple non sensibles. Vérifiez que les actions prévues fonctionnent et que le Site ne peut pas accéder à des données ni effectuer des actions que votre organisation n’a pas autorisées.

Vérifier les accès avant le partage

Vérifiez les données et les actions auxquelles chaque visiteur peut accéder via le Site. Le fait de conserver le service sur un réseau privé ne rend pas privé un Site partagé publiquement.

Pour rendre le Site public, l’option Autoriser les Sites publics avec des tunnels privés doit être activée pour le propriétaire du Site et la personne qui le publie. L’espace de travail doit également autoriser la publication en accès public. Si un Site déjà public a besoin d’un nouveau tunnel, rendez-le privé avant d’ajouter la connexion.

La connexion d’un tunnel ne donne pas à un Site accès aux comptes connectés d’un visiteur et ne modifie pas les autorisations de ce visiteur pour les applications connectées.

Pour les paramètres de contrôle de l’espace de travail, consultez : Gérer ChatGPT Sites pour votre espace de travail.

Résoudre un problème de connexion

Vous ne trouvez pas de tunnel ou ne pouvez pas en connecter un

Demandez à l’administrateur de votre espace de travail de vérifier :

• Si les tunnels sont disponibles dans l’espace de travail du Site.

• Si l’option Autoriser les membres à associer des tunnels privés est activée pour le propriétaire du Site et la personne qui connecte le tunnel.

Ne changez pas d’organisation et n’accordez pas au Site un accès plus large au réseau pour contourner une restriction de l’espace de travail.

Le client de tunnel n’est pas prêt

Demandez à votre équipe informatique de vérifier que le client de tunnel est en cours d’exécution, dispose d’identifiants valides et peut joindre le service privé. N’incluez pas de clés API ni d’autres secrets dans les journaux partagés.

Le Site s’ouvre, mais une opération du service échoue

Si une action échoue alors que le tunnel est connecté, vérifiez l’authentification et les contrôles d’accès du service privé. La connexion peut fonctionner même si le Site n’est pas autorisé à effectuer cette action.

Notez l’action qui a échoué, son code de réponse ou l’identifiant de la requête, ainsi que la date et l’heure de sa dernière exécution réussie.

Impossible de publier un Site utilisant un tunnel en accès public

Demandez à l’administrateur de votre espace de travail de vérifier que l’option Autoriser les Sites publics avec des tunnels privés est activée pour le propriétaire du Site et la personne qui le publie. L’espace de travail doit également autoriser la publication en accès public. L’option Autoriser les membres à associer des tunnels privés ne suffit pas à elle seule.

Supprimer l’accès

Pour supprimer l’accès d’un Site, collaborez avec votre administrateur et votre équipe informatique afin de supprimer sa connexion au tunnel. Vérifiez que les requêtes provenant de ce Site ne parviennent plus au service.

Pour interrompre la connexion du client, votre équipe informatique peut arrêter le client de tunnel. Cela peut affecter d’autres Sites utilisant le même tunnel. La révocation d’une clé d’exécution bloque les futures demandes d’identifiants, mais n’interrompt pas nécessairement une connexion déjà active.

Contacter l’assistance

Si le problème persiste, contactez l’assistance OpenAI. Indiquez :

• L’URL du Site et son espace de travail.

• L’identifiant du tunnel, s’il est visible.

• L’étape qui a échoué et l’erreur exacte.

• L’identifiant de la requête et l’horodatage, avec le fuseau horaire.

• L’état du client et ses journaux, après suppression des informations sensibles, s’ils sont disponibles.

N’envoyez pas de clés API, de mots de passe ni de données du service privé.