Mensagens REST da Qualys

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura

    • As mensagens REST da Qualys são usadas para fazer chamadas para a Qualys API para buscar os dados de conformidade.

    As mensagens REST a seguir são enviadas com o sistema de base.

    Mensagem REST das políticas de PC da Qualys

    A mensagem REST de políticas de PC da Qualys recupera dados de política da Qualys. As mudanças no registro do método de mensagem REST afetam a solicitação feita à Qualys para recuperar informações de política.

    Tabela 1. Parâmetros de mensagem REST das políticas de PC da Qualys
    Nome do Parâmetro Valor Descrição
    ação lista Indica o tipo de operação solicitada.

    Parâmetro obrigatório.
    detalhes Tudo

    Indica o nível de detalhe mostrado para políticas recuperadas.

    É seguro para modificar de acordo com sua necessidade.

    Mensagem REST dos controles DO PC da Qualys

    A mensagem REST de controles do PC da Qualys recupera informações de controles de conformidade para diferentes IDs de controle da Qualys.

    Tabela 2. O PC da Qualys controla os parâmetros de mensagem REST
    Nome do Parâmetro Valor Descrição
    ação lista Indica o tipo de operação solicitada.

    Parâmetro obrigatório.
    detalhes Tudo

    Indica o nível de detalhe mostrado para controles recuperados.

    É seguro para modificar de acordo com sua necessidade.

    Mensagem REST detalhada das políticas de PC da Qualys

    A mensagem REST Detalhes das políticas do PC da Qualys recupera os detalhes completos da política, como tecnologias e seções.

    Tabela 3. Parâmetros de mensagem REST detalhados das políticas de PC da Qualys
    Parâmetro Valor Descrição
    ação lista Indica o tipo de operação que está sendo solicitada.

    Parâmetro obrigatório.
    show_user_controls Booliano
    • Defina como 1 para incluir controles definidos pelo usuário (UDCs) na saída XML.

    • UDCs não especificados não são incluídos.

    Este é um parâmetro opcional. É seguro para modificar de acordo com sua necessidade.
    show_apdency Booliano

    (Opcional) Defina como 1 para mostrar a seção do apêndice na saída XML. Quando não especificado.

    Mensagem REST DE resultados do PC da Qualys

    A mensagem REST de resultados do PC da Qualys recupera registros de postura de conformidade da Qualys.

    Tabela 4. Parâmetros de mensagem REST DE resultados do PC da Qualys
    Campo de origem Valor Descrição
    ação lista Indica o tipo de operação solicitada.

    Parâmetro obrigatório. Mudanças não são recomendadas.
    show_extended_evidence Booliano
    • Defina como 1 para mostrar as informações de evidência estendidas na saída.
    • Definido como 0 ou quando não especificado, as informações de evidência estendida não são mostradas na saída.
    Nota:
    • Não é possível especificar mostrar_extended_evidence: 1 na mesma solicitação que hide_evidence: 1 . Isso resulta em um erro. A evidência estendida faz parte dos dados de evidência e é mostrada somente quando os dados de evidência são mostrados.
    • Este parâmetro não é enviado com o sistema de base.
    causa_de_falha Booliano

    Se você passar "1", a Qualys retornará a causa da falha.

    Se você passar "0", a Qualys não retornará esses atributos.

    Nota:
    Este parâmetro não é enviado com o sistema de base.
    policy_id Mostra registros de informações de postura de conformidade para uma política especificada. Um ID de política válido é necessário.
    detalhes Tudo

    Indica o nível de detalhe mostrado para posturas recuperado.

    É seguro modificar conforme sua exigência.
    show_remediation_info (Opcional) Defina como 1 para mostrar informações de correção na saída XML ou CSV. Por padrão, a saída não inclui as informações de correção. Quando não especificado, as informações de correção não são incluídas na saída.

    Mensagem REST DE integração de host da política PCRS da Qualys

    A Integração de Host da Política PCRS da Qualys recupera os dados do host da Qualys e os processa em sua instância.

    Tabela 5. Parâmetros de mensagem REST DE integração de host da política PCRS da Qualys
    Nome do Parâmetro Valor Descrição
    policyId (LastRunDatetime)

    IDs de política para avaliação de conformidade.

    Integração de resultados de testes PCRS da Qualys

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

    Tabela 6. Parâmetros de mensagem REST DE integração de resultados de testes PCRS da Qualys
    Nome do Parâmetro Valor Descrição
    Evidência necessária (LastRunDatetime)
    • O valor padrão é 0, o que indica que os dados de evidência não serão recuperados para a postura do host.
    • Defina o valor como 1 para recuperar os dados de evidência.
      Nota:
      Mudar o valor para 1 aumenta o tempo necessário para buscar dados de postura.
    CompacçãoNecessário
    • O valor padrão é 1, o que indica que a saída será compactada.
    • Defina o valor como 0 se você não quiser que os dados sejam compactados.
      Nota:
      Não compactar os dados aumenta o tempo necessário para buscar dados de postura.