Проверка репутации файлов

Запрос

Запрос проверки репутации файла содержит следующие параметры:

• action – запрос на выполнение действия с Kaspersky Private Security Network (значение check_file).
• data.hash_type – алгоритм хеширования. Возможные значения:
  • sha256;
  • md5.

  В одном запросе вы можете указать только один алгоритм хеширования (например, только SHA256). Если хеш файла не соответствует значению data.hash_type, запрос не будет обработан, в ответе будет ошибка 203 hash type mismatch.

• data.hashes – хеш файлов (массив): MD5 (строка 16 байт) или SHA256 (строка 32 байта).

Чтобы проверить репутацию файла:

1. Запустите REST-клиент на любом компьютере локальной сети организации, имеющем доступ к серверу по используемому адресу Kaspersky Private Security Network.
2. В списке методов выберите метод POST.
3. В поле адреса запроса введите адрес, по которому доступен API KPSN.
4. В рабочей области введите тело запроса в формате JSON. См. пример ниже.
5. Отправьте запрос сервису File Reputation.

   В окне REST-клиента отобразится ответ с результатом выполнения запроса.

Пример тела запроса

{

"action": "check_file",

"data": {

"hash_type": "sha256",

"hashes": [

"9279fa6a314fb0728f7cfd93669cf7f35cc01b6389fd220664919f455b307203"

]

}

}

Ответ

На основе ответа о репутации файла вы можете оценить безопасность использования этого файла. Ответ содержит следующую информацию:

Пример ответа:

{

  "data": [

    {

       "hash": "9279fa6a314fb0728f7cfd93669cf7f35cc01b6389fd220664919f455b307203",

       "reputation": 2,

"firstRequest": "1601-00-01T00:00:01Z",

"users": 123,

"product": "program",

"vendor": "company",

"client_data": "true",

"groupSharing": {

"high": 30,

"low": 20,

"trusted": 10,

"untrusted": 40

},

"geoSharing": {

"fr": 25,

"it": 19,

"uk": 15,

"es": 12,

"mx": 10,

"00": 17

}

    }

  ]

}