Messages REST Qualys

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 5 minutes de lecture

    • Les messages REST Qualys permettent d’envoyer des appels à l’API Qualys afin d’extraire les données de conformité.

    Les messages REST suivants sont fournis avec le système de base.

    Message REST Politiques de PC Qualys

    Le message REST Politiques de PC Qualys récupère les données de politique de Qualys. Les changements apportés à l’enregistrement de la méthode de message REST ont un impact sur la demande faite à Qualys de récupérer les informations sur la politique.

    À partir des Intégration Qualys pour Opérations de sécurité versions 12.21.0 et 30.3.0 de la Gestion unifiée de l’exposition à la sécurité, la version de l’API a été mise à jour vers la version 5.0.

    Tableau 1. Politiques de PC Qualys Paramètres de message REST
    Nom de paramètre Valeur Description
    action liste Indique le type d’opération demandé.

    Paramètre requis.
    Détails Tous

    Indique le niveau de détail affiché pour les politiques récupérées.

    Vous pouvez modifier en toute sécurité selon vos besoins.

    Message REST des contrôles de PC Qualys

    Le message REST Qualys PC Controls récupère les informations de contrôles de conformité pour différents ID de contrôle à partir de Qualys.

    Tableau 2. Paramètres de message REST des contrôles du PC Qualys
    Nom de paramètre Valeur Description
    action liste Indique le type d’opération demandé.

    Paramètre requis.
    Détails Tous

    Indique le niveau de détail affiché pour les contrôles récupérés.

    Vous pouvez modifier en toute sécurité selon vos besoins.

    Message REST des détails des politiques de PC Qualys

    Le message REST Détails des politiques de PC Qualys récupère les détails complets de la politique, tels que les technologies et les sections.

    À partir des Intégration Qualys pour Opérations de sécurité versions 12.21.0 et 30.3.0 de la Gestion unifiée de l’exposition à la sécurité, la version de l’API a été mise à jour vers la version 5.0.

    Tableau 3. Paramètres de message REST de détail des politiques de PC Qualys
    Paramètre Valeur Description
    action liste Indique le type d’opération demandé.

    Paramètre requis.
    show_user_controls Booléen
    • Définissez la valeur sur 1 pour inclure les contrôles définis par l’utilisateur (UDC) dans la sortie XML.

    • Lorsqu’ils ne sont pas spécifiés, les CDU ne sont pas inclus.

    Ce paramètre est facultatif. Vous pouvez modifier en toute sécurité selon vos besoins.
    show_appendix Booléen

    (Facultatif) À définir sur 1 pour afficher la section d’annexe dans la sortie XML. Si non spécifié.

    Message REST des résultats des PC Qualys

    Le message REST des résultats des PC Qualys récupère les enregistrements de posture de conformité à partir de Qualys.

    Tableau 4. Paramètres de message REST des résultats des PC Qualys
    Champ source Valeur Description
    action liste Indique le type d’opération demandé.

    Paramètre requis. Les changements ne sont pas recommandés.
    show_extended_evidence Booléen
    • Définir sur 1 pour afficher les informations de preuve étendues dans la sortie.
    • Définissez la valeur sur 0 ou, lorsqu’elles ne sont pas spécifiées, les informations de preuve étendues ne sont pas affichées dans la sortie.
    Remarque :
    • Vous ne pouvez pas spécifier show_extended_evidence=1 dans la même requête que hide_evidence=1. Il en résulte une erreur. La preuve étendue fait partie des données de preuve et n’est affichée que lorsque des données de preuve sont affichées.
    • Ce paramètre n’est pas fourni avec le système de base.
    cause_of_failure Booléen

    Si vous réussissez « 1 », Qualys renvoie la cause de la défaillance.

    Si vous dépassez « 0 », Qualys ne renvoie pas ces attributs.

    Remarque :
    Ce paramètre n’est pas fourni avec le système de base.
    policy_id Affiche les enregistrements d’informations sur la posture de conformité pour une politique spécifiée. Un ID de politique valide est requis.
    Détails Tous

    Indique le niveau de détail affiché pour les postures récupérées .

    Vous pouvez modifier en toute sécurité selon vos besoins.
    show_remediation_info (Facultatif) À définir sur 1 pour afficher les informations de rattrapage dans la sortie XML ou CSV. Par défaut, la sortie n’inclut pas les informations de rattrapage. Lorsqu’elles ne sont pas spécifiées, les informations de rattrapage ne sont pas incluses dans la sortie.

    Message REST d’intégration de l’hôte de politique Qualys PCRS

    L’intégration de l’hôte de politique Qualys PCRS récupère les données de l’hôte et les traite dans votre instance.

    À partir des Intégration Qualys pour Opérations de sécurité versions 12.21.0 et 30.3.0 de la Gestion unifiée de l’exposition à la sécurité, la version de l’API a été mise à jour vers la version 5.0.

    Tableau 5. Politique Qualys PCRS Intégration de l’hôte Paramètres de message REST
    Nom de paramètre Valeur Description
    policyId ${lastRunDatetime}

    ID de politiques pour l’évaluation de conformité.

    Intégration des résultats des tests Qualys PCRS

    La table affiche les paramètres de demande envoyés.

    À partir des Intégration Qualys pour Opérations de sécurité versions 12.21.0 et 30.3.0 de la Gestion unifiée de l’exposition à la sécurité, la version de l’API a été mise à jour vers la version 5.0.

    Tableau 6. Paramètres de message REST d’intégration des résultats des tests Qualys PCRS
    Nom de paramètre Valeur Description
    evidenceRequired 1
    • La valeur par défaut est 1, ce qui indique que les données de preuve seront récupérées pour la posture de l’hôte.
    • Définissez la valeur sur 0 pour récupérer les données de preuve.
      Remarque :
      Le changement de la valeur sur 1 augmente le temps nécessaire pour extraire les données de posture.
    compressionRequired 0
    • La valeur par défaut est 0, ce qui indique que la sortie ne sera pas compressée.
    • Définissez la valeur sur 1 si vous souhaitez que les données soient compressées.
      Remarque :
      Le fait de ne pas compresser les données augmente le temps nécessaire pour extraire les données de posture.

    Politique PCRS complète Qualys Message REST d’intégration de l’hôte

    Qualys Comprehensive PCRS Policy Host Integration récupère les données de l’hôte et les traite dans votre instance.

    À partir des Intégration Qualys pour Opérations de sécurité versions 12.21.0 et 30.3.0 de la Gestion unifiée de l’exposition à la sécurité, la version de l’API a été mise à jour vers la version 5.0.

    Tableau 7. Politique PCRS complète Qualys Intégration de l’hôte Paramètres de message REST
    policyId ${policyId} ID de politiques pour l’évaluation de conformité.

    Intégration complète des résultats des tests PCRS Qualys

    La table affiche les paramètres de demande envoyés.

    À partir des Intégration Qualys pour Opérations de sécurité versions 12.21.0 et 30.3.0 de la Gestion unifiée de l’exposition à la sécurité, la version de l’API a été mise à jour vers la version 5.0.

    Tableau 8. Résultats complets des tests PCRS Qualys Paramètres d’intégration
    Nom de paramètre Valeur Description
    evidenceRequired 1
    • La valeur par défaut est 1, ce qui indique que les données de preuve seront récupérées pour la posture de l’hôte.
    • Définissez la valeur sur 0 pour récupérer les données de preuve.
      Remarque :
      Le changement de la valeur sur 1 augmente le temps nécessaire pour extraire les données de posture.
    compressionRequired 0
    • La valeur par défaut est 0, ce qui indique que la sortie ne sera pas compressée.
    • Définissez la valeur sur 1 si vous souhaitez que les données soient compressées.
      Remarque :
      Le fait de ne pas compresser les données augmente le temps nécessaire pour extraire les données de posture.