Qualys Mensagens REST

  • Versão de lançamento: Zurich
  • Atualizado 5 de set. de 2025
  • 4 min. de leitura

    • As mensagens REST da Qualys são usadas para fazer chamadas para a API da Qualys.

    Mensagem REST de detecção de host da Qualys

    A mensagem REST DO Qualys Host Detection faz a chamada inicial para a API de detecção de lista de hosts para a integração do Qualys Host Detection.

    Tabela 1. Parâmetros de mensagem REST de detecção de host da Qualys
    Nome do Parâmetro Valor Descrição
    ação lista Indica o tipo de operação solicitada.

    Parâmetro obrigatório. Mudanças não são necessárias.
    output_format XML Define o formato do relatório retornado pela Qualys.

    Os vários scripts e transformações assumem XML, portanto, mudanças no valor não são recomendadas.
    detection_processed_after (LastScanDate) Mostra somente detecções cujo status de detecção foi alterado após uma determinada data e hora. Para detecções que nunca foram alteradas, a data é aplicada à data da última detecção.
    truncation_limit 500

    O número de hosts dos quais recuperar dados, de acordo com a solicitação. Este parâmetro é usado para fins de paginação.

    O valor padrão é 500, mas valores maiores ou menores podem ser usados. Não defina em menos de 100, pois isso aumenta significativamente a carga do sistema.

    Valores menores exigem mais chamadas para a API da Qualys, e valores maiores resultam em conjuntos de resultados maiores para processar e possíveis tempos limite de recuperação/processamento de dados.
    status Novo, Fixo, Ativo, reaberto Status de detecção a serem recuperados da Qualys.

    O padrão é recuperar todos os status. Para extrações de dados grandes (geralmente a extração inicial de dados), pode ser benéfico excluir status fixos desta lista.

    É importante incluir o status Corrigido ao atualizar vulnerabilidades que já estão no sistema.

    Mensagem REST de paginação de detecção de host da Qualys

    A mensagem REST DE paginação de detecção de host lida com solicitações de paginação para a API de detecção de host.

    Quando a detecção do host primário é executada, se a API da Qualys fornecer uma URL para buscar a próxima página de dados, esta mensagem REST recuperará esses dados adicionais. Esses dados são usados pelo manipulador de paginação de detecção de host.

    REST DE paginação de detecção de host é uma mensagem REST especializada e não deve ser modificada.

    Mensagem REST da base de conhecimento da Qualys (preenchimento)

    A mensagem REST da Base de conhecimento da Qualys (preenchimento) recupera os dados da base de conhecimento da Qualys com base no carimbo de data/hora da última modificação dos dados de vulnerabilidade para a integração da Base de conhecimento da Qualys.

    As mudanças no registro do método de mensagem REST afetam a solicitação feita à Qualys para recuperar informações da base de conhecimento.

    A tabela a seguir mostra os parâmetros de solicitação que são enviados.

    Tabela 2. Parâmetros de mensagem REST da base de conhecimento da Qualys (preenchimento)
    Parâmetro Valor Descrição
    ação lista Indica o tipo de operação que está sendo solicitada.

    Parâmetro obrigatório. Mudanças não são recomendadas.
    detalhes Tudo

    Indica o nível de detalhe mostrado para vulnerabilidades recuperadas.

    Modificar conforme necessário.
    IDs (qids)

    Especifica quais QIDs recuperar da Qualys.

    Referenciado no código. Modificações não são recomendadas.

    Mensagem REST da base de conhecimento da Qualys (baseada em data)

    A mensagem REST da Base de conhecimento da Qualys (baseada em data) é usada para recuperar dados da base de conhecimento da Qualys com base no carimbo de data/hora da última modificação dos dados da vulnerabilidade. Esta mensagem é usada pela integração da Base de conhecimento da Qualys.

    As mudanças no registro do método de mensagem REST afetam a solicitação feita à Qualys para recuperar informações da base de conhecimento.

    A tabela a seguir mostra os parâmetros de solicitação que são enviados.

    Tabela 3. Parâmetros de mensagem REST da base de conhecimento da Qualys (baseados em data)
    Campo de origem Campo de destino Descrição
    ação lista Indica o tipo de operação solicitada.

    Parâmetro obrigatório. Mudanças não são recomendadas.
    detalhes Tudo Indica o nível de detalhe mostrado para vulnerabilidades recuperadas.

    Modificar conforme necessário.
    last_modified_after (DateStart) Indica quando começar a recuperar dados históricos.

    Usado pelo código para determinar a hora de início e para ajudar na paginação.

    Modificações ou remoção não são recomendadas.
    last_modifiedbefore (DateEnd)

    Indica quando terminar a recuperação de dados históricos. Usado pelo código para determinar a hora de término e para ajudar na paginação.

    Modificações ou remoção não são recomendadas.

    Mensagem REST de tíquetes da Qualys

    A mensagem REST DE tíquetes da Qualys recupera as informações do tíquete da Qualys para a Integração de tíquete da Qualys. As mudanças no registro do método de mensagem REST afetam as solicitações feitas à Qualys para recuperar informações do tíquete.

    A tabela mostra os parâmetros de solicitação que são enviados.

    Tabela 4. Parâmetros de mensagem REST de tíquetes da Qualys
    Nome do Parâmetro Valor Descrição
    modified_since_datetime (LastRunDatetime)

    Indica a data da última execução da integração e a data após a qual os dados serão extraídos.

    Usado pelo código. Mudanças não são recomendadas.
    since_ticket_number (LastTicketNumber)

    Indica qual tíquete foi recuperado pela última vez da Qualys.

    Usado para paginação. Mudanças não são recomendadas.
    show_vuln_details 1

    Indica se os detalhes da vulnerabilidade são recuperados.