Messages REST Qualys

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 3 minutes de lecture

    • Les messages REST Qualys sont utilisés pour passer 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 de politiques de PC Qualys

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

    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ée.

    Paramètre requis.
    Détails Tout

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

    Il est sûr de modifier selon vos besoins.

    Message REST sur les contrôles de PC Qualys

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

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

    Paramètre requis.
    Détails Tout

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

    Il est sûr de modifier selon vos besoins.

    Message REST de détail des politiques de PC Qualys

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

    Tableau 3. Détail des politiques de PC Qualys Paramètres de message REST
    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.

    Il s’agit d’un paramètre facultatif. Il est sûr de modifier selon vos besoins.
    show_appendix Booléen

    (Facultatif) Définissez la valeur sur 1 pour afficher la section d’annexe dans la sortie XML. Lorsqu’il n’est pas spécifié.

    Message REST des résultats PC Qualys

    Le message REST de Qualys PC Results récupère les enregistrements de posture de conformité de Qualys.

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

    Paramètre requis. Il n’est pas recommandé d’apporter des modifications.
    show_extended_evidence Booléen
    • Définir sur 1 pour afficher les informations de preuves étendues dans la sortie.
    • Définissez sur 0 ou si elles ne sont pas spécifiées, les informations de preuves étendues ne sont pas affichées dans la sortie.
    Remarque :
    • Vous ne pouvez pas spécifier show_extended_evidence=1 dans la même demande que hide_evidence=1. Il en résulterait une erreur. La preuve étendue fait partie des données de preuve et elle 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 la réponse « 1 », Qualys renvoie la cause de l’échec.

    Si vous transmettez « 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 Tout

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

    Il est sûr de modifier selon vos besoins.
    show_remediation_info (Facultatif) Définissez la valeur 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 à partir de Qualys et les traite dans votre instance.

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

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

    Intégration des résultats des tests Qualys PCRS

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

    Tableau 6. Paramètres du message REST de l’intégration des résultats des tests Qualys PCRS
    Nom de paramètre Valeur Description
    evidenceRequired ${lastRunDatetime}
    • La valeur par défaut est 0, ce qui indique que les données de preuve ne seront pas récupérées pour la posture de l’hôte.
    • Définissez la valeur sur 1 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.
    compressionObligatoire
    • La valeur par défaut est 1, ce qui indique que la sortie sera compressée.
    • Définissez la valeur sur 0 si vous ne souhaitez pas que les données soient compressées.
      Remarque :
      Ne pas compresser les données augmente le temps nécessaire pour extraire les données de posture.