Intégrations d’appels multiples

Les scripts d’intégration à appels multiples (ou à pages multiples) sont un peu plus compliqués. Ils nécessitent plusieurs appels à une source de données pour récupérer des données.

À l’instar d’une intégration à appel unique, l’intégration à plusieurs appels doit également avoir retrieveData() implémentée. Dans le corps de retrieveData(), l’intégration utilise les méthodes hasMoreData() et setNextRunParameters() fournies par VulnerabilityIntegrationBase.

La méthode hasMoreData() accepte un seul booléen qui demande au VulnerabilityIntegrationController d’insérer d’autres processus pour extraire plus de données. Lorsque vous passez true à hasMoreData(), un appel à setNextRunParameters() est effectué pour fournir un contexte au processus suivant.

La méthode setNextRunParameters() accepte un objet unique qui fournit des informations de contexte à utiliser par l’appel suivant pour retrieveData(). Cet objet est utilisé pour transmettre l’état aux appels suivants pour retrieveData(). Un exemple de cas d’utilisation consiste à transmettre un objet qui indique le numéro et la taille de page actuels à un service Web.

Pour les intégrations d’appels multiples, chaque appel retrieveData() vérifie d’abord les paramètres de processus actuels. La méthode _getProcessParameters() est fournie à tous les VulnerabilityIntegrationBase pour faciliter l’obtention des paramètres définis par le processus précédent. S’il n’y a pas de paramètres, cela indiquerait qu’il s’agit du premier processus.

Voici une capture d’écran d’un exemple de script d’intégration d’appels multiples. Dans le prolongement de l’exemple d’intégration d’appel unique, ce script montre comment effectuer des appels vers un point de terminaison REST qui prend en charge la pagination de base. Il montre comment obtenir une seule page de données, reconnaître qu’il y a plus de données à récupérer, puis indiquer au processus suivant quelle page récupérer.

Figure 1. Script d’intégration d’appels multiples