Messages REST Qualys
Les messages REST Qualys sont utilisés pour passer des appels à l’API Qualys.
À partir de la version 12.9.2 de Qualys, vous pouvez choisir entre l’authentification de base ou OAuth. La méthode Qualys Cloud Authentication du paramètre d’instance est préconfigurée pour l’authentification de base. Si vous préférez utiliser OAuth, vous devez modifier le paramètre d’instance d’intégration, puis configurer le message REST directement pour l’OAuth.
Message REST de détection d’hôte Qualys
Le message REST de détection d’hôte Qualys effectue l’appel initial à l’API de détection de liste d’hôtes pour l’intégration de détection d’hôte Qualys.
| Nom de paramètre | Valeur | Description |
|---|---|---|
| action | liste | Indique le type d’opération demandée. Paramètre requis. Les changements ne sont pas nécessaires. |
| output_format | XML | Définit le format du rapport renvoyé par Qualys. Les différents scripts et transformations supposent XML, il n’est donc pas recommandé de modifier la valeur. |
| detection_processed_after | ${lastScanDate} | Affiche uniquement les détections dont l’état de détection a changé après une date et une heure définies. Pour les détections qui n’ont jamais changé, la date est appliquée à la dernière date de détection. |
| truncation_limit | 500 | Nombre d’hôtes à partir desquels récupérer les données, en fonction de la demande. Ce paramètre est utilisé à des fins de pagination. La valeur par défaut est 500, mais des valeurs plus grandes ou plus petites peuvent être utilisées. Ne réglez pas à moins de 100 car cela augmente considérablement la charge du système. Les valeurs plus petites nécessitent plus d’appels à l’API Qualys et les valeurs plus grandes entraînent des jeux de résultats de plus grande taille à traiter et des délais potentiels de récupération/traitement des données. |
| état | Nouveau, Corrigé, Actif, Rouvert | États de détection à récupérer à partir de Qualys. La valeur par défaut récupère tous les états. Pour les extractions de données volumineuses (souvent l’extraction initiale de données), il peut être avantageux d’exclure les états fixes de cette liste. Il est important d’inclure l’état Corrigé lors de la mise à jour des vulnérabilités déjà présentes dans le système. |
Message REST de la pagination de détection d’hôte Qualys
Le message REST Pagination de détection d’hôte gère les demandes de pagination adressées à l’API de détection d’hôte.
Lors de l’exécution de la détection de l’hôte principal, si l’API Qualys fournit une URL pour extraire la page de données suivante, ce message REST récupère ces données supplémentaires. Ces données sont utilisées par le gestionnaire de pagination de détection d’hôte.
Pagination de détection d’hôte REST est un message REST spécialisé et n’est pas destiné à être modifié.
Base de connaissances Qualys (remplissage) Message REST
Le message REST de la base de connaissances Qualys (remplissage) récupère les données de la base de connaissances Qualys en fonction du dernier horodatage modifié des données de vulnérabilité pour l’intégration de la base de connaissances Qualys.
Les modifications apportées à l’enregistrement de méthode de message REST ont un impact sur la demande de récupération des informations de la base de connaissances envoyée à Qualys.
Le tableau suivant présente les paramètres de demande qui sont envoyés.
| Paramètre | Valeur | Description |
|---|---|---|
| action | liste | Indique le type d’opération demandée. Paramètre requis. Les changements ne sont pas recommandés. |
| Détails | Tous | Indique le niveau de détail affiché pour les vulnérabilités récupérées. Peut être modifié en toute sécurité au besoin. |
| ID | ${qids} | Spécifie les QID à extraire de Qualys. Référencé dans le code. Les modifications ne sont pas recommandées. |
Base de connaissances Qualys (basée sur la date) Message REST
Le message REST de la base de connaissances Qualys (basé sur la date) est utilisé pour récupérer les données de la base de connaissances Qualys en fonction du dernier horodatage modifié des données de vulnérabilité. Ce message est utilisé par l’intégration de la base de connaissances Qualys.
Les modifications apportées à l’enregistrement de méthode de message REST ont un impact sur la demande de récupération des informations de la base de connaissances envoyée à Qualys.
Le tableau suivant présente les paramètres de demande qui sont envoyés.
| Champ source | Champ cible | Description |
|---|---|---|
| action | liste | Indique le type d’opération demandée. Paramètre requis. Les changements ne sont pas recommandés. |
| Détails | Tous | Indique le niveau de détail affiché pour les vulnérabilités récupérées. Peut être modifié en toute sécurité au besoin. |
| last_modified_after | ${dateStart} | Indique quand commencer à récupérer les données historiques. Utilisé par le code pour déterminer à la fois l’heure de début et pour aider à la pagination. Des modifications ou des suppressions ne sont pas recommandées. |
| last_modifiedbefore | ${dateFin} | Indique quand terminer la récupération des données historiques. Utilisé par le code pour déterminer à la fois l’heure de fin et pour aider à la pagination. Des modifications ou des suppressions ne sont pas recommandées. |
Message REST des tickets Qualys
Le message REST des tickets Qualys récupère les informations de ticket Qualys pour l’intégration des tickets Qualys. Les modifications apportées à l’enregistrement de méthode de message REST ont un impact sur les demandes envoyées à Qualys pour récupérer les informations des tickets.
La table affiche les paramètres de demande qui sont envoyés.
| Nom de paramètre | Valeur | Description |
|---|---|---|
| modified_since_datetime | ${lastRunDatetime} | Indique la date de dernière exécution de l’intégration et la date après laquelle extraire les données. Utilisé par le code. Les changements ne sont pas recommandés. |
| since_ticket_number | ${lastTicketNumber} | Indique le dernier ticket récupéré à partir de Qualys. Utilisé pour la pagination. Les changements ne sont pas recommandés. |
| show_vuln_details | 1 | Indique si les détails de la vulnérabilité sont récupérés. |