Добавление сведений о репутации файла

Запрос

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

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

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

• data.force – устранение конфликтов добавления репутации файла (необязательный параметр). Kaspersky Private Security Network проверяет наличие добавленных ранее сведений о репутации файла в локальной репутационной базе и сведений в базе Kaspersky Security Network (KL-репутация). Возможные значения:
  • true – изменение текущей репутации на репутацию в запросе в любом случае.
  • false – изменение текущей репутации на репутацию в запросе, только если в Kaspersky Private Security Network нет сведений о репутации файла. Если в Kaspersky Private Security Network уже добавлены сведения о файле, репутация не будет изменена. Значение по умолчанию.
• data.hashes (массив):
  • data.hashes.hash – хеш файла: MD5 (строка 16 байт) или SHA256 (строка 32 байта).
  • data.hashes.reputation – репутация файла. Возможные значения:
    • 1 – доверенный;
    • 2 – недоверенный.
  • data.hashes.file_name – имя файла (строка до 256 символов).
  • data.hashes.description – дополнительное описание файла (строка до 1024 символов).

Чтобы добавить сведения о репутации файла:

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

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

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

{

"action": "add_file",

"data": {

"hash_type": "sha256",

"force": false,

"hashes": [

{

"hash": "9279fa6a314fb0728f7cfd93669cf7f35cc01b6389fd220664919f455b307203",

"reputation": 1,

"file_name": "file1.exe",

"description": "trust file, sha256 hash"

},

{

"hash": "9279fa6a314fb0728f7cfd93669cf7f35cc01b6389fd220664919f455b307204",

"reputation": 2,

"file_name": "file2.exe",

"description": "untrust file, sha256 hash"

}

]

}

}

Ответ

Ответ содержит следующую информацию:

• data.hash – хеш файла (массив): MD5 (строка 16 байт) или SHA256 (строка 32 байта).
• data.publish_status – результат выполнения запроса. Возможные значения:
  • true – сведения о файле успешно добавлены в локальную репутационную базу.
  • false – добавить сведения о файле в локальную репутационную базу не удалось. В локальной репутационной базе уже содержатся сведения о файле. Чтобы изменить сведения о файле, необходимо установить для параметра data.force значение true.

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

{

"data": [

{

"hash": "9279fa6a314fb0728f7cfd93669cf7f35cc01b6389fd220664919f455b307203",

"publish_status": true

},

{

"hash": "9279fa6a314fb0728f7cfd93669cf7f35cc01b6389fd220664919f455b307204",

"publish_status": false

}

]

}