Configurando uma solicitação WebSocket

URL

Para abrir uma conexão WebSocket, você é obrigado a inserir a URL do WebSocket do endpoint ou endereço IP da URL do WebSocket que você deseja verificar (os protocolos de wss:// ws:// e criptografados são suportados). Por exemplo, wss://echo.websocket.org/

Para ativar um modo de entrada mais visualmente amigável, clique no interruptor Detalhado na parte superior da seção.

Você pode converter a URL em um valor dinâmico ou parâmetro de contexto aqui. Por exemplo, para alterar dinamicamente a URL de destino.

Enviar dados

Se você precisar transferir dados para o ponto final de destino, no campo Enviar dados, especifique uma mensagem em um formato de sequência ou binário. O Dotcom-Monitor enviará a mensagem para o ponto final do destino usando o protocolo WebSocket e aguardará a resposta.

O Dotcom-Monitor suporta expressões de Razor nas mensagens WebSocket. Para enviar uma sequência que contenha uma expressão razor, insira-a no campo Enviar dados e use o Script prepare para definir o tipo de mensagem para a expressão Razor. Caso contrário, a mensagem será analisada e enviada como texto. Use o seguinte trecho no campo Preparar script para notificar o sistema de que a mensagem deve ser analisada com o mecanismo Razor:

ProcessPostDataByRazor(currentTask);

Além do mecanismo Razor, o Dotcom-Monitor permite alterar dinamicamente os dados do corpo de solicitação usando máscaras de dados. Para saber como usar a sintaxe e máscaras de dados razor em dados enviados e configurar a carga útil de mudança dinâmica, consulte Como alterar dinamicamente a carga útil na solicitação HTTP.

Validação de resposta (validação de conteúdo)

Para validar uma sequência de mensagens recebida do WebSocket, você pode afirmar palavras-chave no cenário de execução de chamadas. O sistema aguardará a resposta do ponto de extremidade de destino e verificará a mensagem recebida para a presença da palavra-chave especificada na cadeia de caracteres. Se a palavra-chave não for detectada nas respostas do soquete, um erro será gerado.

Nos campos Palavra-chave , você pode especificar uma palavra ou frase que deseja pesquisar na mensagem de resposta. Use o texto sem formatação para especificar uma palavra-chave:

Note que uma palavra-chave é sensível a maiúsões.

Prepare script e poste script

Os campos podem conter código C#, que pode ser usado para solicitações específicas e dados de URL ou para validar ou publicar cabeçalhos personalizados. Consulte o artigo “Use Prepare Script and Post Script” ou entre em contato com suporte técnico para obter mais detalhes sobre o uso.

O cenário dinâmico da execução da chamada WebSocket pode ser especificado no campo Preparar script. O cenário dinâmico pode incluir uma série de operações com dados binários ou de string.

Operações binárias formatadas (msg como Base64 codificada):

  • ValidateBinary(string msg) – verifica se uma resposta WebSocket é igual aos dados binários especificados.
  • ValidebinaryContains(string msg) – verifica se uma resposta do WebSocket contém dados binários especificados.
  • SendBinary (string msg) – envia uma mensagem binária para um WebSocket.

Operações formatadas por texto:

  • SendText(string msg) – envia uma sequência de texto para um WebSocket.
  • ValidateText(string msg) – verifica se uma resposta de um WebSocket é igual a uma cadeia de caracteres especificada.
  • ValidateTextContains(string msg) – verifica se uma resposta WebSocket contém uma cadeia de caracteres especificada.

Nos casos em que qualquer afirmação foi especificada no campo Preparar script, o sistema aguardará a afirmação especificada na resposta e prosseguirá com a execução do script assim que a validação for bem sucedida. Se uma mensagem com a afirmação especificada não for recebida e o tempo limite de conclusão da tarefa for atingido, o erro de validação será gerado.

O Dotcom-Monitor permite que você inclua quantas operações forem necessárias no script Preparar. No entanto, se o tempo limite de conclusão da tarefa de teste for atingido, a execução do script será encerrada.

Observe que os campos enviar dados e validação de conteúdo são ignorados se o campo Preparar script contém etapas correspondentes no cenário dinâmico. Por exemplo, se as seguintes etapas forem incluídas no script, o campo Enviar dados e validação de conteúdo será ignorado:

(currentTask).SendText("This is a test");
(currentTask).ValidateText("This is a test");

Onde o parâmetro currentTask não está associado ao nome da tarefa e reflete a tarefa que está sendo processada no momento.

Verificação de SSL/Certificado

A Verificação de Certificado SSL do Secure Socket Layer inclui as seguintes opções de validação:

  • Autoridade: verifica se uma cadeia de certificados contém um certificado raiz confiável ou não confiável.
  • Nome Comum (CN): valida que um endereço que você navega corresponde ao certificado de endereço ao qual o endereço foi assinado.
  • Data: verifica a data de validade do certificado.
  • Revogação: valida que a cadeia de confiança do certificado não contém um certificado revogado.
  • Uso: verifica uma cadeia de certificados para o uso inadequado de um certificado intermediário.
  • Lembrete de expiração em dias: um lembrete que notifica (como um erro) sobre a expiração do certificado.
  • Certificado do Cliente: nome do certificado do cliente.

Limite de validação de tempo (em segundos)

Insira o número de segundos que o serviço deve aguardar uma resposta da página da Web antes de encerrar a execução da solicitação e retornar um erro. Se isso for deixado em branco, o tempo limite padrão para uma solicitação será de 60 segundos.

Autenticação Básica

O esquema básico de autenticação é usado para permitir que os usuários acessem conteúdo em alguns sites. Uma vez fornecidas as credenciais de login serão passadas junto com o cabeçalho de solicitação para o servidor web.

  • Nome de usuário: Contém um nome de usuário para acesso básico ou autenticação de resumo HTTP/S.
  • Senha do usuário: Contém uma senha para acesso básico ou autenticação de resumo HTTP/S.

Não confunda autenticação básica com outros esquemas de autenticação como autenticação portadora que envolve tokens portadores e OAuth 2.0 que usa tokens de acesso.

Leia o nome de usuário básico de autenticação e artigos de senha e APIs baseados em OAuth 2.0 para obter mais informações.

Cabeçalhos

A opção permite adicionar quaisquer cabeçalhos personalizados adicionais, se necessário.

  • Nome do cabeçalho: especifique o nome do parâmetro, pois ele aparecerá na solicitação.
  • Valor: digite o valor associado ao nome do parâmetro.

Opções de DNS

O recurso Opções DNS permite que os usuários escolham como as solicitações de DNS (Domain Name Server, servidor de nome de domínio) são feitas durante uma tarefa de monitoramento.

Para especificar o modo de resolução do nome do host, na seção Modo de Resolução DNS, selecione um dos modos disponíveis. Para obter mais informações sobre a configuração de recursos, consulte opções de modo DNS.

A seção DNS Hosts personalizados contém mapeamentos de endereços IP para nomes de host.

Para especificar o mapeamento, digite o endereço IP e o nome do host nos campos apropriados.

Exemplos:

192.168.107.246 example.com user.example.com userauth.example.com tools.example.com
192.168.107.246 example.com
192.168.107.246 user.example.com
192.168.107.246 userauth.example.com

Veja também: Opções de modo DNS.

Filtro de erros

Você pode definir um filtro para ignorar tipos de erro e códigos específicos. Na seção Filtro de Erros , você pode filtrar determinados erros configuráveis pelo usuário. Por exemplo, os erros de DNS podem ser filtrados com base em quem é responsável pelas operações do servidor DNS. Você pode criar filtros que ignorarão erros específicos que você sabe que podem ocorrer e não são relevantes para o objetivo de um dispositivo específico.

Além disso, você pode configurar o sistema para ignorar uma série de códigos de erro usando um painel ou vários códigos de erro usando ponto e vírgula como separador.

Por exemplo, se em um determinado dispositivo, você não se importa com 404 erros, você pode filtrar-los para que você não receba alertas quando eles são detectados.

Observe que, se um erro corresponder às condições do filtro, o erro não será refletido nos relatórios e não poderá ser rastreado.