Intégrations d’appels multiples

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

Comme une intégration d’appel unique, une intégration d’appel multiple doit également avoir retrieveData() implémenté. 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 plus de processus pour extraire plus de données. Lors de la transmission de true à hasMoreData(), un appel à setNextRunParameters() est effectué pour fournir un contexte au processus suivant.

La méthode setNextRunParameters() accepte un seul objet qui fournit des informations de contexte à utiliser par le prochain appel à retrieveData(). Cet objet est utilisé pour passer l’état aux appels ultérieurs pour retrieveData(). Un exemple de cas d’utilisation consiste à transmettre un objet qui indique le numéro de page 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 indique 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