Mensagens REST da Qualys

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 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 de detecção de host da Qualys faz a chamada inicial para a API de detecção de lista de hosts para a integração de detecção de host da Qualys.

    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. As 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, não são recomendadas mudanças no valor.
    detecção_processada_após ${lastScanDate} Mostra somente detecções cujo status de detecção mudou após uma determinada data e hora. Para detecções que nunca mudaram, a data é aplicada à data da última detecção.
    truncation_limit 500

    O número de hosts dos quais os dados serão recuperados, 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 para 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 limites de recuperação/processamento de dados.
    status Novo, Corrigido, 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 útil excluir os status Fixo 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 de host primário é executada, se a API da Qualys fornece um URL para buscar a próxima página de dados, esta mensagem REST recupera 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 Todos

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

    É seguro modificar conforme necessário.
    IDs ${qids}

    Especifica quais QIDs serão recuperados 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 (baseada 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 Todos Indica o nível de detalhe mostrado para vulnerabilidades recuperadas.

    É seguro 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 de REST de tíquetes da Qualys

    A mensagem REST de tíquetes da Qualys recupera 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
    modificado_desde_data/hora ${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.
    desde_número_do_ticket ${lastTicketNumber}

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

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

    Indica se os detalhes da vulnerabilidade foram recuperados.