Scripts personnalisés

1. Sélectionnez Scripts personnalisés dans la section Avancé des paramètres de configuration.
2. Cliquez sur le bouton + Ajouter.
3. Modifiez le champ Nom prérempli si nécessaire.
4. Choisissez le Contexte d'exécution approprié pour votre script : :
   1. Avant la requête pour que les scripts soient exécutés avant l'envoi des requêtes.
   2. Après la réponse pour que les scripts soient exécutés après la réception des réponses.
   3. Paramètre pour les tâches qui impliquent plusieurs étapes ou le remplissage de formulaires. Vous pouvez utiliser ce contexte en conjonction avec la méthode setResultValue pour permettre aux scripts de renvoyer les résultats à AppScan.
5. Saisissez votre JavaScript dans le champ JavaScript (éditeur de code) et utilisez Ctrl+espace pour obtenir des suggestions automatiques dans l'environnement AppScan.
6. Cliquez sur Ajouter pour enregistrer votre script. Le script est ajouté à la liste et activé par défaut.
7. Vous pouvez choisir d'activer ou de désactiver un script de la liste des scripts personnalisés à l'aide de la case à cocher Activer.
8. Gérez vos scripts en utilisant la case à cocher Activer ou en modifiant, en supprimant ou en réorganisant les scripts dans la liste de scripts.
9. Cliquez sur Démarrer un examen complet pour démarrer l'examen.
10. Résultat : Les scripts activés sont exécutés pour chaque requête ou réponse. Vous pouvez consulter les détails des scripts dans Données > onglet Requêtes > Requête/Réponse.

    Vérifiez l'exactitude syntaxique et la compatibilité de votre script avec la version JavaScript prise en charge dans AppScan. Pour obtenir des instructions détaillées, reportez-vous à la section Code JavaScript.

    Remarque :

    • Les scripts personnalisés sont enregistrés dans le fichier de configuration des examens et peuvent être exportés avec un modèle. Ils ne sont pas inclus dans les résultats de l'examen.
    • Par défaut, les scripts personnalisés sont chiffrés lorsqu'ils sont exportés dans un modèle. Pour désactiver le chiffrement, définissez le paramètre Général : Chiffrer les données sensibles sur False dans la configuration des examens.

// Attach Authorization from stored global variable
var token = environment.globalVariables.get("Authorization");
if (token) request.headers.set("Authorization", token);

// Capture token from JSON response and store it for reuse
try {
		var result = JSON.parse(response.body);
		if (result && result.Authorization) {
			environment.globalVariables.addOrUpdate("Authorization", result.Authorization);
		}
} catch(e) { log(e); }

• Aucun objet de données (requête ou réponse) n'est disponible dans ce contexte ; leur utilisation renvoie une valeur nulle.
• Renvoie les valeurs avec setResultValue(value).

// Example: Return a unique email for registration flows
function random(n) { return Math.random().toString(36).slice(2, 2+n); }
var email = "test_" + Date.now() + "_" + random(6) + "@example.test";
setResultValue(email);

// Examples:
// Handle headers
request.headers.set("Authorization", "Bearer");
request.headers.add("X-Trace", "abc");

// Manipulate body
request.body = JSON.stringify( { user:"admin" });
if(request.body.includes("admin") { ... }

// Read path
if (request.path.startsWith("/api/v1")) { ... }

// Edit query
request.query.addOrUpdate("lang","en")
request.query.remove("debug")
request.query.getQueryString()

// Read method
if (request.method == "GET") { ... }

1. Variable globale : Les données des variables globales sont une structure de données clé-valeur conçue pour stocker des paires de données spécifiques à l'utilisateur. Les clés sont uniques (c'est-à-dire que deux éléments ne peuvent pas avoir la même clé, bien que plusieurs éléments puissent partager la même valeur), ce qui est utile pour partager des données entre des scripts en cours d'exécution.
2. Statut de l'examen : Contient des informations sur l'examen en cours.

   // Check the status of the scan
   environment.status.isInExplore();
   environment.status.isInTest();

• Fonctions restreintes : eval, Function (constructor), setTimeout, setlnterval. Si l'une d'entre elles est utilisée, le script échoue.
• Limites : Durée d'exécution maximale : 5 secondes ; limite de mémoire : 64 Mo. Le dépassement de ces limites entraîne l'échec du script.

  En cas d'échec, l'examen s'interrompt et les détails sont enregistrés dans UserScript.log.

• ES6 : Générateurs, appels résiduels
• ES8 : Mémoire partagée et opérations atomiques
• ES15 : Atomics.waitAsync, indicateur d'expressions régulières \v

1. Échecs de script : Vérifiez le dossier des journaux (par défaut : [UserDataFolder]\AppData\Roaming\HCL\AppScan Standard\logs) pour plus de détails sur l'erreur. Si vous rencontrez une exception non gérée, entourez votre code d'un bloc try...catch pour la gérer de manière appropriée.
2. Script non exécuté : Assurez-vous que le script est activé dans les paramètres de configuration.

   Si le problème est lié à la connexion/l'autorisation, envisagez de supprimer la valeur de négociation dans Configuration→ Configuration avancée → Ordre du package de sécurité pour empêcher AppScan de gérer ces authentifications automatiquement.