Reenvio WebSocket
Reenvio WebSocket cria sessões reutilizáveis para testar endpoints WebSocket. Use para reconectar com detalhes do handshake capturado, editar mensagens, enviar novos quadros e observar respostas do servidor.
Criar uma sessão
Você pode criar uma sessão de Reenvio WebSocket de duas maneiras:
- Clique com o botão direito em uma mensagem WebSocket capturada no Histórico WebSocket / SSE e escolha Enviar para Reenvio WS.
- Abra Reenvio WS e crie uma sessão manualmente com uma URL
ws://ouwss://.
Sessões manuais podem incluir cabeçalhos personalizados para cookies, tokens de autorização, negociação de protocolo ou valores de handshake específicos da aplicação.
Configurar a sessão
| Campo | Descrição |
|---|---|
| Nome | Rótulo legível da sessão. |
| URL | Endpoint WebSocket. A URL deve começar com ws:// ou wss://. |
| Cabeçalhos | Cabeçalhos opcionais de handshake enviados ao conectar. |
Se você alterar a URL ou os cabeçalhos, o Ogma salva a sessão antes de abrir a próxima conexão.
Conectar
Selecione uma sessão e clique em Conectar. O estado da conexão mostra se o socket está desconectado, conectando, aberto, fechando ou fechado.
Use Desconectar antes de trocar de alvo ou alterar detalhes do handshake. Reconecte após editar a URL ou os cabeçalhos para testar um novo caminho de servidor ou contexto autenticado.
Conectar apenas conclui o handshake WebSocket. Muitas aplicações exigem depois um quadro de autenticação ou inicialização antes de aceitar mensagens de negócio. Use a primeira mensagem capturada do cliente como referência, aguarde sua confirmação e só então envie sua mensagem modificada. Cookies, URLs assinadas e tokens capturados podem ter expirado.
Enviar mensagens
Use o editor de mensagens para editar um payload e enviá-lo pela sessão selecionada. Payloads de texto são enviados como quadros de texto WebSocket.
Alterne para o modo binário para bytes hexadecimais. Reenviar primeira mensagem WebSocket capturada ajuda a reenviar a inicialização, e Reenviar sequência de saída capturada envia as mensagens capturadas do cliente em ordem. Verifique as respostas na linha do tempo em vez de presumir que enviar uma sequência recriou o estado da aplicação.
O editor de protocolo aceita os modos WebSocket bruto e GraphQL gerenciado (graphql-transport-ws e o legado graphql-ws). Escolha o protocolo usado pelo alvo e forneça seus parâmetros de conexão. Preserve o cabeçalho de subprotocolo original quando necessário; solicitar o protocolo errado pode fazer o upgrade falhar.
Atualizar timestamps fica desativado por padrão. Ative apenas para requisições não assinadas que precisem de timestamps novos: alterar uma URL ou payload assinado pode invalidar sua assinatura. Reconexão automática tenta novamente após uma desconexão, mas uma nova conexão ainda pode exigir autenticação em nível de aplicação.
Mensagens capturadas enviadas do histórico mantêm seu payload original como ponto de partida, para que você possa alterar um campo por vez e comparar o comportamento.
Linha do tempo de mensagens
A linha do tempo registra quadros enviados e recebidos na sessão selecionada.
| Coluna | Descrição |
|---|---|
| Direção | Se o quadro foi enviado pelo cliente ou recebido do servidor. |
| Opcode | Tipo de quadro, como texto, binário, ping, pong ou fechamento. |
| Tamanho | Tamanho do payload. |
| Hora | Quando o Ogma observou o quadro. |
Selecione uma mensagem para inspecionar seu payload. Payloads JSON são formatados quando possível; o conteúdo bruto continua disponível para revisão exata.
Fluxo de testes
- Capture um fluxo WebSocket normal no Histórico WebSocket / SSE.
- Envie uma mensagem interessante do cliente para Reenvio WS.
- Reconecte e reenvie a mensagem original para confirmar o comportamento de referência.
- Modifique um campo, token, ID ou comando por vez.
- Registre comportamentos confirmados em Achados ou mantenha anotações em Notas.
Solução de problemas
| Sintoma | O que verificar |
|---|---|
| Upgrade rejeitado ou proibido | URL, Origin, cookies, autorização e valores assinados expirados na consulta. |
| Subprotocolo inválido ou não solicitado | Compare os cabeçalhos de upgrade com o handshake capturado e o modo de protocolo selecionado. |
| Conecta com sucesso e depois fecha | Inspecione a mensagem de sistema/fechamento e envie o quadro de inicialização ou autenticação exigido. |
| Mensagem enviada, mas sem resposta útil | Confirme IDs de assinatura, mensagens anteriores, autenticação e estado da aplicação; o transporte WebSocket não recria uma sessão de navegador automaticamente. |
Com MCP, use as ferramentas dedicadas de listagem/leitura de mensagens do Reenvio WS e de desconexão. As ferramentas de histórico capturado leem uma transcrição diferente; consulte a referência de ferramentas MCP.