--- sourceDocument: Gestion de la sécurité Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/security-management Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Gestion de la sécurité Xanadu ft:clusterId : - security bundleId : - security workflow : - Technology --- # Messages REST Qualys # Messages REST Qualys {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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. {#qualys-rest-messages-cc__table_v2g_x1q_dt__entry__3} | 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. | [Tableau 1. Politiques de PC Qualys Paramètres de message REST] {#qualys-rest-messages-cc__table_v2g_x1q_dt} ## 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. {#qualys-rest-messages-cc__table_n3s_b1p_mxb__entry__3} | 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. | [Tableau 2. Contrôles de PC Qualys Paramètres de message REST] {#qualys-rest-messages-cc__table_n3s_b1p_mxb} ## 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. {#qualys-rest-messages-cc__table_v2g_x1q_du__entry__3} | 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. {#qualys-rest-messages-cc__ul_txc_rxc_qxb} 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é. | [Tableau 3. Détails des politiques de PC Qualys Paramètres de message REST] {#qualys-rest-messages-cc__table_v2g_x1q_du} ## 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. {#qualys-rest-messages-cc__table_v2g_x1q_dv__entry__3} | 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. {#qualys-rest-messages-cc__ul_sp1_swc_qxb} 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. {#qualys-rest-messages-cc__ul_onp_kc4_cyb} | | 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. | [Tableau 4. Résultats de PC Qualys Paramètres de message REST] {#qualys-rest-messages-cc__table_v2g_x1q_dv} ## 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. {#qualys-rest-messages-cc__table_v2g_x1q_dw__entry__3} | Nom de paramètre | Valeur | Description | |-|-|-| | policyId | ${lastRunDatetime} | ID de politiques pour l'évaluation de la conformité. | [Tableau 5. Politique Qualys PCRS Intégration de l'hôte Paramètres de message REST] {#qualys-rest-messages-cc__table_v2g_x1q_dw} ## Intégration des résultats des tests Qualys PCRS {#qualys-rest-messages-cc__section_apb_pgp_mxb} La table affiche les paramètres de demande qui sont envoyés. {#qualys-rest-messages-cc__table_bpb_pgp_mxb__entry__3} | 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. {#qualys-rest-messages-cc__ul_t25_kyc_qxb} | | 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. {#qualys-rest-messages-cc__ul_b5d_zyc_qxb} | [Tableau 6. Intégration des résultats des tests Qualys PCRS Paramètres de message REST] {#qualys-rest-messages-cc__table_bpb_pgp_mxb}