Descripción general
Un túnel permite que tu sitio se conecte a un servicio de la red privada de tu empresa, como una API interna de inventario, sin que ese servicio sea accesible al público.
Tu equipo de TI ejecuta el cliente de túnel de OpenAI, un pequeño programa que transmite solicitudes y respuestas entre el sitio y el servicio.
Conecta el sitio solo a los servicios que tu organización le permita usar. Limita el acceso a los datos y las acciones que necesita.
Un túnel no reemplaza la autenticación ni los controles de acceso del servicio. No da al sitio acceso a toda tu red ni determina qué información pueden ver los visitantes.
Disponibilidad
Los túneles se están habilitando gradualmente en los Espacios de trabajo de Enterprise que cumplen los requisitos. Deben estar habilitados en tu Espacio de trabajo antes de que puedas conectar uno a un sitio.
Un administrador del Espacio de trabajo debe habilitar Permitir que los miembros conecten túneles privados tanto para el propietario del sitio como para la persona que conecte el túnel.
Antes de comenzar
Trabaja con el propietario del sitio, el administrador de tu Espacio de trabajo, tu equipo de TI y la persona responsable del servicio privado.
Identifica el servicio, los datos y las acciones que el sitio necesita, y las personas que deberían poder usarlos.
Confirma qué sitio usará la conexión y quién administrará el sitio, el cliente de túnel y el servicio privado.
Elige una computadora o un servidor que pueda ejecutar el cliente de túnel de OpenAI y conectarse al servicio mediante HTTP o HTTPS. Confirma que tu organización permita la conexión.
Pide al responsable del servicio que confirme a qué datos y acciones puede acceder el sitio y que configure la autenticación y los controles de acceso del servicio.
Instala el cliente de túnel
Tu equipo de TI instala y ejecuta el cliente de túnel de OpenAI en una computadora o un servidor que pueda conectarse al servicio privado.
Para obtener instrucciones de instalación e implementación, consulta la documentación oficial de tunnel-client.
En macOS con Homebrew instalado, ejecuta:
brew install openai/tools/tunnel-client
tunnel-client --version
Guarda las credenciales de ejecución en el equipo que ejecuta el cliente. No incluyas claves de API ni contraseñas en el contenido del sitio, el código que se ejecuta en el navegador, las capturas de pantalla ni los mensajes al equipo de soporte.
Prepara la conexión
Usa un túnel disponible para el Espacio de trabajo del sitio. Trabaja con tu equipo de TI para conectar el sitio y pide al responsable del servicio que configure la autenticación y limite el acceso a los datos y las acciones que el sitio necesita.
Antes de compartir el sitio, pruébalo con datos de muestra que no sean sensibles. Verifica que las acciones previstas funcionen y que el sitio no pueda acceder a datos ni realizar acciones que tu organización no haya autorizado.
Revisa el acceso antes de compartir
Revisa a qué datos y acciones puede acceder cada visitante a través del sitio. Mantener el servicio en una red privada no hace que un sitio compartido públicamente sea privado.
Para que el sitio sea público, Permitir Sites públicos con túneles privados debe estar habilitado tanto para el propietario del sitio como para la persona que lo publique. El Espacio de trabajo también debe permitir la publicación de acceso público. Si un sitio que ya es público necesita un túnel nuevo, hazlo privado antes de agregar la conexión.
Conectar un túnel no da al sitio acceso a las cuentas conectadas de un visitante ni cambia los permisos de ese visitante para las aplicaciones conectadas.
Para conocer los controles del Espacio de trabajo, consulta: administrar Sites de ChatGPT en tu Espacio de trabajo.
Soluciona problemas de conexión
No puedes encontrar ni conectar un túnel
Pide al administrador de tu Espacio de trabajo que verifique lo siguiente:
Si los túneles están disponibles en el Espacio de trabajo del sitio.
Si Permitir que los miembros conecten túneles privados está habilitado tanto para el propietario del sitio como para la persona que conecte el túnel.
No cambies de organización ni amplíes el acceso del sitio a la red para eludir una restricción del Espacio de trabajo.
El cliente de túnel no está listo
Pide a tu equipo de TI que verifique si el cliente de túnel está en ejecución, tiene credenciales válidas y puede conectarse al servicio privado. No incluyas claves de API ni otros secretos en los registros compartidos.
El sitio se abre, pero una operación del servicio falla
Si una acción falla mientras el túnel está conectado, revisa la autenticación y los controles de acceso del servicio privado. La conexión puede funcionar aunque el sitio no tenga permiso para realizar esa acción.
Registra la acción que falló, su código de respuesta o ID de solicitud y cuándo funcionó por última vez.
No se puede publicar un sitio que usa un túnel para que sea accesible al público
Pide al administrador de tu Espacio de trabajo que verifique que Permitir Sites públicos con túneles privados esté habilitado tanto para el propietario del sitio como para la persona que lo publique. El Espacio de trabajo también debe permitir la publicación de acceso público. No basta con habilitar Permitir que los miembros conecten túneles privados.
Elimina el acceso
Para eliminar el acceso de un sitio, trabaja con tu administrador y tu equipo de TI para quitar su conexión al túnel. Verifica que las solicitudes de ese sitio ya no lleguen al servicio.
Para interrumpir la conexión del cliente, tu equipo de TI puede detener el cliente de túnel. Esto puede afectar a otros Sites que usen el mismo túnel. Revocar una clave de ejecución bloquea las solicitudes futuras de credenciales, pero es posible que no interrumpa una conexión que ya esté activa.
Ponte en contacto con soporte
Si el problema persiste, ponte en contacto con el soporte de OpenAI. Incluye:
La URL del sitio y el Espacio de trabajo.
El identificador del túnel, si está visible.
El paso que falló y el error exacto.
El ID de la solicitud y la marca de tiempo, incluida la zona horaria.
El estado del cliente y los registros sin información sensible, si están disponibles.
No envíes claves de API, contraseñas ni datos del servicio privado.