Paramètres d'incident

Pour la réponse aux menaces EDR, vous devez préciser des paramètres de requête de base, par exemple, au format JSON :

task est le type de la tâche (voir ci-dessous).
targetHost est l'identifiant de l'ordinateur sur lequel le script doit être exécuté. Argument requis. Le script obtient cet argument à partir de l'événement.
responseEventIncidentArea est le nom de l'application qui a exécuté le script (par exemple, KUMA). Ce paramètre s'ajoute au nom de la tâche créée.

Pour configurer la réponse aux menaces EDR, vous devez préciser les paramètres de la tâche au format JSON dans le paramètre "KLINCDT_BODY": json.dumps(data). Par conséquent, l'application crée le [Response][KUMA] <task type> - <Date> <Time> - <ID> dans la console de Kaspersky Security Center.

Obtention du fichier – getFile

Paramètres de la tâche Obtention du fichier

Paramètre	Type	Description
`md5hash`	`string`	Hachage MD5 du fichier que vous souhaitez obtenir.
`sha256hash`	`string`	Hachage SHA256 du fichier que vous souhaitez obtenir.
`path`	`string`	Chemin d'accès au fichier que vous souhaitez obtenir.

Exemple

type getFile = {

task: 'getFile';

targetHost: string;

params: {

// an empty string or a valid md5 hash of the file

md5hash: string;

// an empty string or a valid sha256 hash of the file

sha256hash: string;

// the path to the file

path: string;

};

responseEventIncidentArea: string;

};

Supprimer le fichier – deleteFile

Paramètres de la tâche Supprimer le fichier

Paramètre	Type	Description
`md5hash`	`string`	Hachage MD5 du fichier que vous souhaitez supprimer.
`sha256hash`	`string`	Hachage SHA256 du fichier que vous souhaitez supprimer.
`path`	`string`	Chemin d'accès au fichier que vous souhaitez supprimer.
`searchInSubfolders?`	`boolean`	Recherchez le fichier que vous souhaitez supprimer dans les sous-dossiers.

Exemple

type deleteFile = {

task: 'deleteFile';

targetHost: string;

params: {

// an empty string or a valid md5 hash of the file

md5hash: string;

// an empty string or a valid sha256 hash of the file

sha256hash: string;

// the path to the file

path: string;

// recursive search for a file (subfolder), optional

searchInSubfolders?: boolean;

};

responseEventIncidentArea: string;

};

Placer le fichier en Quarantaine – quarantineFile

Paramètres de la tâche Placer le fichier en Quarantaine

Paramètre	Type	Description
`md5hash`	`string`	Hachage MD5 du fichier que vous souhaitez mettre en quarantaine.
`sha256hash`	`string`	Hachage SHA256 du fichier que vous souhaitez mettre en quarantaine.
`path`	`string`	Chemin d'accès au fichier que vous souhaitez mettre en quarantaine.

Exemple

type quarantineFile = {

task: 'quarantineFile';

targetHost: string;

params: {

// an empty string or a valid md5 hash of the file

md5hash: string;

// an empty string or a valid sha256 hash of the file

sha256hash: string;

// the path to the file

path: string;

};

responseEventIncidentArea: string;

};

Analyse IOC – iocScan

Paramètres de la tâche Analyse IOC

Paramètre	Type	Description
`ioc`	`string`	Chemin d'accès à l'archive ZIP contenant le fichier IOC au format base64 que vous souhaitez utiliser pour l'analyse. Argument requis. Saisissez cet argument manuellement.
`isolateHost`	`boolean`	Isolez l'ordinateur du réseau lorsqu'un indicateur de compromission est détecté pour empêcher la menace de se propager.
`scanCriticalAreas`	`boolean`	Exécutez la tâche Analyse des zones critiques lorsqu'un indicateur de compromission est détecté.
`quarantineObject`	`boolean`	Supprimez l'objet malveillant dès que l'indicateur de compromission est détecté. Avant de supprimer l'objet, Kaspersky Endpoint Security crée une copie de sauvegarde au cas où l'objet devrait être restauré ultérieurement. Kaspersky Endpoint Security déplace la copie de sauvegarde dans la Quarantaine.

Exemple

type iocScan = {

task: 'iocScan';

targetHost: string;

params: {

// the path to the zip archive with ioc files in base64 encoding

ioc: string;

// isolation of the computer from the network

isolateHost: boolean;

// critical areas scan

scanCriticalAreas: boolean;

// quarantine the file

quarantineObject: boolean;

};

responseEventIncidentArea: string;

};

Démarrez le processus – startProcess

Paramètres de la tâche Démarrez le processus

Paramètre	Type	Description
`executablePath`	`string`	Chemin d'accès au fichier exécutable utilisé pour lancer le processus.
`arguments?`	`string`	Arguments de ligne de commande supplémentaires pour le lancement du processus.
`workingFolder?`	`string`	Chemin d'accès au dossier de travail du processus.

Exemple

type startProcess = {

task: 'startProcess';

targetHost: string;

params: {

// the path to the file

executablePath: string;

// command line arguments, optional

arguments?: string;

// a working folder, optional

workingFolder?: string;

};

responseEventIncidentArea: string;

};

Fin du processus – terminateProcess

Paramètres de la tâche Fin du processus

Paramètre	Type	Description
`md5hash`	`string`	Hachage MD5 du fichier dont vous souhaitez arrêter le processus.
`sha256hash`	`string`	Hachage SHA256 du fichier dont vous souhaitez arrêter le processus.
`path`	`string`	Chemin d'accès au fichier que vous souhaitez supprimer.
`caseSensitive`	`boolean`	Le respect de la casse lors de la recherche du fichier.

Exemple

type terminateProcess = {

task: 'terminateProcess';

targetHost: string;

params: {

// an empty string or a valid md5 hash of the file

md5hash: string;

// an empty string or a valid sha256 hash of the file

sha256hash: string;

// the path to the file

path: string;

// case sensitive of the file name

caseSensitive: boolean;

};

responseEventIncidentArea: string;

};

Isolement du réseau pour l'ordinateur – isolateHost

Paramètres d'isolement du réseau pour l'ordinateur

Paramètre	Type	Description
`action`	`string`	Hachage MD5 du fichier que vous souhaitez obtenir.

Exemple

type isolateHost = {

task: 'isolateHost';

targetHost: string;

params: {

// 0 - turning off network isolation, 1 - turning on network isolation

action: number;

};

responseEventIncidentArea: string;

};

Prévention de l'exécution – preventExecution

Paramètres de Prévention de l'exécution

Paramètre	Type	Description
`hash`	`string`	Hachage MD5 du fichier dont vous souhaitez empêcher l'exécution.
`path`	`string`	Chemin d'accès au fichier dont vous souhaitez empêcher l'exécution.
`caseSensitive`	`boolean`	Le respect de la casse lors de la recherche du fichier.

Exemple

type preventExecution = {

task: 'preventExecution';

targetHost: string;

params: {

// a valid md5 hash of the file

hash: string;

// the path to the file

path: string;

// case sensitive of the file name

caseSensitive: boolean;

};

responseEventIncidentArea: string;

};

Analyse des logiciels malveillants – onDemandScan

Paramètres de la tâche Analyse des logiciels malveillants

Paramètre	Type	Description

`path`	`string`	Liste de fichiers et de dossiers séparés par des espaces pour l'analyse personnalisée.
`recursive`	`boolean`	Mode d'analyse récursif.
`type`	`number`	Zone d'analyse.
ScanObjectType = Enum("ScanObjectType", [ ("SystemMemory", 14), ("StartupObjectsAndRunningProcesses", 15), ("DiskBootSectors", 16), ("SystemBackupStorage", 17), ("Email", 18), ("Folder", 22), ("AllRemovableDrives", 23), ("AllNetworkDrives", 24), ("AllFixedDrives", 25)])

Exemple

type onDemandScan = {

task: 'onDemandScan';

targetHost: string;

// please note, this is an array

// array of scan object

params: [{

// enabling the scan object

enabled: boolean;

// an empty string or the path to the folder to scan

path: string;

// recursive scan mode

recursive: boolean;

// ID scan object

type: number;

}];

responseEventIncidentArea: string;

};

Haut de page