Visão geral

Um túnel permite que seu Site se conecte a um serviço na rede privada da sua empresa, como uma API interna de estoque, sem tornar esse serviço acessível publicamente.

Sua equipe de TI executa o cliente de túnel da OpenAI, um pequeno programa que encaminha solicitações e respostas entre o Site e o serviço.

Conecte-se apenas a serviços que sua organização permite que o Site use. Limite o acesso aos dados e às ações de que ele precisa.

Um túnel não substitui a autenticação nem os controles de acesso do serviço. Ele não dá ao Site acesso à sua rede inteira nem determina quais informações os visitantes podem ver.

Disponibilidade

Os túneis estão sendo disponibilizados gradualmente para espaços de trabalho Enterprise elegíveis. Eles precisam estar habilitados no seu espaço de trabalho para que você possa conectar um túnel a um Site.

Um administrador do espaço de trabalho precisa habilitar Permitir que membros conectem túneis privados tanto para o proprietário do Site quanto para a pessoa que conecta o túnel.

Antes de começar

• Trabalhe em conjunto com o proprietário do Site, o administrador do espaço de trabalho, a equipe de TI e a pessoa responsável pelo serviço privado.

• Identifique o serviço, os dados e as ações de que o Site precisa e as pessoas que devem poder usá-los.

• Confirme qual Site usará a conexão e quem gerenciará o Site, o cliente de túnel e o serviço privado.

• Escolha um computador ou servidor que possa executar o cliente de túnel da OpenAI e acessar o serviço por HTTP ou HTTPS. Confirme se sua organização permite a conexão.

• Peça ao responsável pelo serviço para confirmar quais dados e ações o Site pode acessar e configurar a autenticação e os controles de acesso do serviço.

Instale o cliente de túnel

Sua equipe de TI instala e executa o cliente de túnel da OpenAI em um computador ou servidor que consiga acessar o serviço privado.

Para obter instruções de instalação e implantação, consulte a documentação oficial do tunnel-client.

No macOS com o Homebrew instalado, execute:

brew install openai/tools/tunnel-client

tunnel-client --version

Mantenha as credenciais de execução no host que executa o cliente. Não inclua chaves de API nem senhas no conteúdo do Site, no código executado no navegador, em capturas de tela ou em mensagens ao suporte.

Prepare a conexão

Use um túnel disponível no espaço de trabalho do Site. Conecte o Site com a ajuda da equipe de TI e peça ao responsável pelo serviço para configurar a autenticação e limitar o acesso aos dados e às ações de que o Site precisa.

Antes de compartilhar o Site, teste-o com dados de exemplo não sensíveis. Verifique se as ações previstas funcionam e se o Site não consegue acessar dados ou executar ações que sua organização não autorizou.

Revise o acesso antes de compartilhar

Revise quais dados e ações cada visitante pode acessar pelo Site. Manter o serviço em uma rede privada não torna privado um Site compartilhado publicamente.

Para tornar o Site público, Permitir Sites públicos com túneis privados precisa estar habilitado tanto para o proprietário do Site quanto para a pessoa que o publica. O espaço de trabalho também precisa permitir a publicação para acesso público. Se um Site já público precisar de um novo túnel, torne-o privado antes de adicionar a conexão.

Conectar um túnel não dá ao Site acesso às contas conectadas de um visitante nem altera as permissões desse visitante nos apps conectados.

Para saber mais sobre os controles do espaço de trabalho, consulte: Como gerenciar o ChatGPT Sites no seu espaço de trabalho.

Resolva problemas de conexão

Você não consegue encontrar ou conectar um túnel

Peça ao administrador do espaço de trabalho para verificar:

• Se os túneis estão disponíveis no espaço de trabalho do Site.

• Se Permitir que membros conectem túneis privados está habilitado tanto para o proprietário do Site quanto para a pessoa que conecta o túnel.

Não mude de organização nem amplie o acesso do Site à rede para contornar uma restrição do espaço de trabalho.

O cliente de túnel não está pronto

Peça à equipe de TI para verificar se o cliente de túnel está em execução, tem credenciais válidas e consegue acessar o serviço privado. Não inclua chaves de API nem outras informações secretas em logs compartilhados.

O Site abre, mas uma operação do serviço falha

Se uma ação falhar enquanto o túnel estiver conectado, verifique a autenticação e os controles de acesso do serviço privado. A conexão pode funcionar mesmo quando o Site não tem permissão para executar essa ação.

Registre a ação que falhou, seu código de resposta ou ID da solicitação e a última vez em que ela funcionou.

Não é possível publicar um Site que usa um túnel para acesso público

Peça ao administrador do espaço de trabalho para verificar se Permitir Sites públicos com túneis privados está habilitado tanto para o proprietário do Site quanto para a pessoa que o publica. O espaço de trabalho também precisa permitir a publicação para acesso público. Habilitar apenas Permitir que membros conectem túneis privados não é suficiente.

Remova o acesso

Para remover o acesso de um Site, trabalhe com o administrador e a equipe de TI para remover a conexão dele com o túnel. Verifique se as solicitações desse Site não chegam mais ao serviço.

Para encerrar a conexão do cliente, sua equipe de TI pode interromper a execução do cliente de túnel. Isso pode afetar outros Sites que usam o mesmo túnel. Revogar uma chave de execução bloqueia futuras solicitações de credenciais, mas pode não encerrar uma conexão já ativa.

Entre em contato com o suporte

Se o problema persistir, entre em contato com o suporte da OpenAI. Inclua:

• A URL do Site e o espaço de trabalho.

• O identificador do túnel, se estiver visível.

• A etapa que falhou e o erro exato.

• O ID da solicitação e a data e hora, incluindo o fuso horário.

• O status do cliente e os logs sem informações sensíveis, se disponíveis.

Não envie chaves de API, senhas nem dados do serviço privado.