Messages REST Qualys

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 3 minutes de lecture

    • Les messages REST Qualys sont utilisés pour appeler 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 modifications apportées à l’enregistrement de méthode de message REST ont un impact sur la demande envoyée à Qualys pour récupérer des informations sur la 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ètre requis.
    Détails Tous

    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 des 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 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 Tous

    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étails des politiques de PC Qualys récupère les détails complets de la politique, tels que les technologies et les sections.

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

    Paramètre requis.
    show_user_controls Booléen
    • Définissez la valeur 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 1 pour afficher la section d’annexe dans la sortie XML. Lorsqu’il n’est pas spécifié.

    Message REST des résultats de PC Qualys

    Le message REST Résultats PC Qualys 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. 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éfinies 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 obtenez la valeur « 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 Tous

    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) Sélectionnez 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 correction. Lorsqu’elles ne sont pas spécifiées, les informations de rattrapage ne sont pas incluses dans la sortie.

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

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

    Tableau 5. Paramètres de message REST de l’intégration de l’hôte de la politique Qualys PCRS
    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 ${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 :
      Changer la valeur à 1 augmente le temps nécessaire pour récupérer 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 pour récupérer les données de posture.