Exporter des données au format CSV, JSON ou SARIF

Cette section décrit comment exporter des résultats d'examen au format CSV, JSON ou SARIF.

L'API AppScan 360° renvoie les données au format JSON par défaut, ce qui est utile pour la consommation programmatique. Pour demander explicitement le format JSON, envoyez l'en-tête suivant :

Accept: application/json

Si vous avez besoin de données au format CSV (pour les feuilles de calcul), demandez le format CSV en envoyant l'en-tête suivant :

Accept: text/csv

Remarque : l'API AppScan 360° prend en charge OData V4 ($filter, $select) pour filtrer et sélectionner les champs renvoyés ; ceci s'applique aux réponses JSON et CSV.

Pour SARIF : l'interface utilisateur propose une boîte de dialogue Exporter qui peut générer des fichiers SARIF pour les problèmes SAST (voir la boîte de dialogue Exporter dans le produit). Si vous avez besoin de générer un fichier SARIF par programmation via l'API, la sortie SARIF est produite par l'API Rapports (un nœud final différent des nœuds finaux OData/d'exportation). Voir Exporter les données vers un fichier SARIF pour des exemples et des paramètres d'API.

Utilisation de l'API

Pour utiliser l'API, vous devez disposer d'un jeton d'accès valide et, pour obtenir un jeton d'accès, vous avez besoin d'une clé d'API associée à votre compte. Pour plus de détails, voir Génération de clés d'API.

Swagger

Pour obtenir les données au format CSV, il suffit de remplacer le « Type de contenu de réponse » par défaut « application/json » par « text/csv » avant de cliquer sur le bouton « Exécuter ».

Pour en savoir plus, reportez-vous à la documentation Swagger.

curl

Voici un exemple de commande curl qui renverra toutes les propriétés de toutes les applications accessibles à partir de votre compte (remplacez <access token> par un jeton d'accès valide) :

curl -X GET --header 'Accept: text/csv' --header 'Authorization: Bearer <access token>'
                    'https://<360domain>/api/v4/Apps'

Etant donné que l'API prend en charge OData, vous pouvez exploiter les paramètres de requête $filter et $select pour obtenir des données partielles. Dans l'exemple suivant, seules les applications présentant une évaluation des risques élevée sont extraites et chaque application contient 3 propriétés : ID, Nom et Evaluation des risques :

curl -X GET --header 'Accept: text/csv' --header 'Authorization: Bearer <access token>'
                    'https://<360domain>/api/v4/Apps?
                    $filter=RiskRating%20eq%20'\''High'\''&$select=Id%2CName%2CRiskRating'

Voir aussi :

Format CSV