--- sourceDocument: Gestão de segurança do Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/security-management Release : - xanadu ft:locale : - pt-BR ft:publication_title : - Gestão de segurança do Xanadu ft:clusterId : - security bundleId : - security workflow : - Technology --- # Mensagens REST da Qualys # Mensagens REST da Qualys {#ariaid-title1} * Versão de lançamento: Xanadu * * Atualizado 1 de ago. de 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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. {#qualys-rest-messages__table_v2g_x1q_dt__entry__3} | 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. | [Tabela 1. Parâmetros de mensagem REST de detecção de host da Qualys] {#qualys-rest-messages__table_v2g_x1q_dt} ## 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. {#qualys-rest-messages__table_v2g_x1q_du__entry__3} | 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. | [Tabela 2. Parâmetros de mensagem REST da base de conhecimento da Qualys (preenchimento)] {#qualys-rest-messages__table_v2g_x1q_du} ## 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. {#qualys-rest-messages__table_v2g_x1q_dv__entry__3} | 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. | [Tabela 3. Parâmetros de mensagem REST da base de conhecimento da Qualys (baseada em data)] {#qualys-rest-messages__table_v2g_x1q_dv} ## 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. {#qualys-rest-messages__table_v2g_x1q_dw__entry__3} | 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. | [Tabela 4. Parâmetros de mensagem REST de tíquetes da Qualys] {#qualys-rest-messages__table_v2g_x1q_dw}