Messages REST Qualys

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 3 minutes de lecture

    • Les messages REST Qualys sont utilisés pour effectuer 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.

    Politiques de PC Qualys Message REST

    Le message REST Politiques 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 faite à Qualys pour récupérer les informations de politique.

    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ètres 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.

    Contrôles de PC Qualys Message REST

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

    Tableau 2. Contrôles 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ètres 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.

    Détails des politiques de PC Qualys Message REST

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

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

    Paramètres requis.
    show_user_controls Booléen
    • Définissez la valeur sur 1 pour inclure les contrôles définis par l’utilisateur (CDU) 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 1 pour afficher la section d’annexe dans la sortie XML. Lorsqu’il n’est pas spécifié.

    Résultats PC Qualys Message REST

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

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

    Paramètres requis. Les changements ne sont pas recommandés.
    show_extended_evidence Booléen
    • Définissez la valeur sur 1 pour afficher les informations de preuve étendues dans la sortie.
    • Défini sur 0 ou, lorsqu’il n’est pas spécifié, 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 les 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 renverra la cause de l’échec.

    Si vous transmettez « 0 », Qualys ne retourne 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 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.

    Politique Qualys PCRS Intégration de l’hôte Message REST

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

    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 la conformité.

    Intégration des résultats des tests Qualys PCRS

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

    Tableau 6. Intégration des résultats des tests Qualys PCRS Paramètres de message REST
    Nom de paramètre Valeur Description
    evidenceRequired (en anglais) ${lastRunDatetime}
    • La valeur par défaut est de 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 :
      Changer la valeur à 1 augmente le temps nécessaire pour extraire les données de posture.
    compressionrequise
    • 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 :
      Le fait de ne pas compresser les données augmente le temps nécessaire à l’extraction des données de posture.