GetFileDetectResult - Security Center - Centre de documentation Alibaba Cloud

Obtient les résultats de détection de fichiers par lots via HashKey.

Description de l'opération

Vous pouvez obtenir les résultats de détection uniquement pour les fichiers qui ont été soumis à la détection. Les résultats de détection sont conservés pendant 5 heures et peuvent être interrogés de manière répétée au cours de cette période. Pour soumettre des fichiers à la détection, reportez-vous à CreateFileDetect.

Identifiant unique du fichier

Toutes les opérations liées à la détection de fichiers incluent le paramètre HashKey, qui représente l'identifiant unique du fichier en cours de détection et qui est utilisé pour interroger les résultats de détection. Seul le hachage MD5 ou SHA-256 du contenu complet du fichier est pris en charge.

Interroger les résultats de détection

Vous pouvez filtrer les propriétés des fichiers en utilisant le champ FileLabel dans le champ d'extension Ext. Par exemple, vous pouvez combiner les propriétés encrypted et Zip pour filtrer les archives chiffrées. Étiquettes de fichier prises en charge pour les types de fichiers compressés : Zip, RAR, 7-Zip, XAR, ZLib, GZip et tar. Vous pouvez utiliser le champ Highlight dans le champ d'extension Ext pour localiser les segments de code malveillant dans les fichiers web shell. Le champ Highlight est de type liste. Chaque élément de la liste correspond à une plage de code, et les nombres représentent le décalage en caractères depuis le début du fichier.

Avant d'interroger les résultats de détection de fichiers, effectuez les étapes suivantes dans l'ordre :

Appelez CreateFileDetectUploadUrl pour obtenir les paramètres de chargement OSS.
Utilisez les informations de signature renvoyées pour charger le fichier vers OSS à l'aide d'un formulaire. Pour plus d'informations sur la méthode de chargement, consultez la documentation sur le chargement de formulaire OSS PostObject.
Appelez CreateFileDetect pour soumettre une tâche de détection de fichier.
Appelez GetFileDetectResult pour interroger le résultat de la détection.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

yundun-sas:GetFileDetectResult

get

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
SourceIp	string	Non	L'adresse IP source de la requête.	183.46.XX.XX
HashKeyList	array	Oui	La liste des identifiants de fichiers. Un maximum de 200 éléments peut être spécifié.
	string	Non	L'identifiant unique du fichier.	0a212417e65c26ff133cfff28f9c****
Type	integer	Oui	Le type de fichier à détecter. Valeurs valides : 0 : détection de fichiers malveillants	0

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
RequestId	string	L'identifiant de la requête, qui est un identifiant unique généré par Alibaba Cloud pour cette requête. Vous pouvez l'utiliser pour résoudre les problèmes.	24A20733-10A0-4AF6-BE6B-E3322413BB68
ResultList	array<object>	La liste des résultats de détection.
	object	Les informations sur le résultat de détection du fichier.
HashKey	string	L'identifiant du fichier.	0a212417e65c26ff133cfff28f6c****
Result	integer	Le résultat de la détection du fichier. Valeurs valides : 0 : Fichier sûr. 1 : Fichier suspect. 3 : Détection en cours. Attendez la fin de la détection.	0
Score	integer	Le score de détection du fichier. La correspondance entre les plages de scores et les niveaux de risque est la suivante : 0–60 : Sûr. 61–70 : À risque. 71–80 : Suspect. 81–100 : Malveillant. Important Un score plus élevé indique un fichier plus suspect. Ce champ n'est renvoyé que lorsque Result est 1 (fichier suspect). Ce champ n'est pas renvoyé lorsque Result est 0 ou 3.	100
VirusType	string	Le type de virus. Valeurs valides : Trojan : Cheval de Troie. WebShell : Web shell. Backdoor : Porte dérobée. RansomWare : Rançongiciel. Scanner : Scanner. Stealer : Voleur d'identifiants. Malbaseware : Logiciel de base contaminé. Hacktool : Outil de piratage. Engtest : Programme de test du moteur DPI. Downloader : Cheval de Troie téléchargeur. Virus : Virus infectant les fichiers. Miner : Programmes de minage. Worm : Vers. DDoS : Cheval de Troie DDoS. Malware : Logiciel malveillant. RiskWare : Logiciel à risque. Proxytool : Outil proxy. Suspicious : Programme suspect. MalScript : Script malveillant. Rootkit : Rootkit. Exploit : Exploits de vulnérabilité. Remarque Ce paramètre n'est pas pris en charge lorsque Result est 0 ou 3. Ce champ n'est renvoyé que lorsque Result est 1 (fichier suspect). Ce champ n'est pas renvoyé lorsque Result est 0 ou 3.	WebShell
Code	string	Le code de résultat. Une valeur de 200 indique un succès. Toute autre valeur indique un échec. Vous pouvez utiliser ce champ pour déterminer la cause de l'échec.	200
Message	string	Les informations détaillées sur le code d'erreur.	successful
Ext	string	Les informations étendues du résultat de détection.	{ "HighLight": [ [ 23245, 23212 ] ], "FileLabel": [ "PE32", "Zip", "SFX", "encrypted" ] }
Compress	boolean	Indique si le fichier est identifié comme une archive compressée. true : Oui. false : Non. Remarque Ce paramètre n'est pas pris en charge lorsque Type est 6.	false

L'exemple suivant montre un résultat unique dans la liste des résultats de détection. Les autres champs de réponse sont omis.

Fichier sûr (Result est 0). Score et VirusType ne sont pas renvoyés :

{"Result": 0}

Fichier suspect (Result est 1). Score et VirusType sont renvoyés :

{"Result": 1, "Score": 100, "VirusType": "WebShell"}

Exemples

JSON format

{
  "RequestId": "24A20733-10A0-4AF6-BE6B-E3322413BB68",
  "ResultList": [
    {
      "HashKey": "0a212417e65c26ff133cfff28f6c****",
      "Result": 0,
      "Score": 100,
      "VirusType": "WebShell",
      "Code": "200",
      "Message": "successful",
      "Ext": "{\n    \"HighLight\":\n    [\n        [\n            23245,\n            23212\n        ]\n    ],\n    \"FileLabel\":\n    [\n        \"PE32\",\n        \"Zip\",\n        \"SFX\",\n        \"encrypted\"\n    ]\n}",
      "Compress": false
    }
  ]
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur
400	RequestTooFrequently	Request too frequently, please try again later
400	GetResultFail	Get result fail, found no detect record for this file or result has been expired
400	InvalidApiDetectType	Unsupported Api Detect Type.
500	ServerError	ServerError
500	SystemBusy	System busy, please try again later.
403	NoPermission	caller has no permission

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.