KICS. Интеграция с Kaspersky Industrial CyberSecurity for Networks
Команда KAVSHELL KICS позволяет настроить интеграцию с Kaspersky Industrial CyberSecurity for Networks:
- Для настройки интеграции Kaspersky Industrial CyberSecurity for Nodes c Kaspersky Industrial CyberSecurity for Networks по протоколу TCP выполните следующую команду:
KAVSHELL KICS /ENABLE /SERVERS:<address>:<port> [/PINNED-CERTIFICATE:<full path to the TLS certificate file>] [/CLIENT-CERTIFICATE:<full path to the crypto-container>] [/CLIENT-PASSWORD:<password for the crypto-container>] [/TIMEOUT:<maximum server response timeout>] [/SYNC-PERIOD:<synchronization request period>] [/EVENTS-SENT-PERIOD:<maximum delay when sending events>] [/EVENTS-LIMIT:<1|0>] [/EVENTS-PER-HOUR:<maximum number of events per hour>] [/VIRTUAL-SPAN-ENABLE] [/VIRTUAL-SPAN-DISABLE] [/VIRTUAL-SPAN-ADD-RULES:<subnet IDs>] [/VIRTUAL-SPAN-REMOVE-RULES:<subnet IDs>] [/LOGIN:<user name>] [/PWD:<password>]
- Для настройки интеграции Kaspersky Industrial CyberSecurity for Nodes c Kaspersky Industrial CyberSecurity for Networks в режиме MQTT-издателя выполните следующую команду:
KAVSHELL KICS /ENABLE /KICS-MODE:MQTT-PUBLISHER /MQTT-SERVER:<address>:<port> [/MQTT-USER:<login name for authorization at the MQTT broker>] [/MQTT-PASSWORD:<password for authorization at the MQTT broker>] [/LOGIN:<user name>] [/PWD:<password>]
- Для настройки интеграции Kaspersky Industrial CyberSecurity for Nodes c Kaspersky Industrial CyberSecurity for Networks по протоколу UDP выполните следующую команду:
KAVSHELL KICS /ENABLE /KICS-MODE:UDP-DATA-DIODE /UDP-SERVER:<address>:<port> [/UDP-ENCRYPTION-DISABLE] [/UDP-ENCRYPTION-ENABLE] [/UDP-ENCRYPTION-KEY:
<full path to the encryption key>][/UDP-ENCRYPTION-PASSWORD:<password to the encryption key>] - Для настройки интеграции Kaspersky Industrial CyberSecurity for Nodes в качестве MQTT-подписчика выполните следующую команду:
KAVSHELL KICS /ENABLE /KICS-MODE:TELEMETRY /SERVERS:<address>:<port> [/PINNED-CERTIFICATE:<full path to the TLS certificate file>] [/CLIENT-CERTIFICATE:<full path to the crypto-container>] [/CLIENT-PASSWORD:<password for the crypto-container>] [/TIMEOUT:<maximum server response timeout>] [/SYNC-PERIOD:<synchronization request period>] [/EVENTS-SENT-PERIOD:<maximum delay when sending events>] [/EVENTS-LIMIT:<1|0>] [/EVENTS-PER-HOUR:<maximum number of events per hour>] [/VIRTUAL-SPAN-ENABLE] [/VIRTUAL-SPAN-DISABLE] [/VIRTUAL-SPAN-ADD-RULES:<subnet IDs>] [/VIRTUAL-SPAN-REMOVE-RULES:<subnet IDs>] /MQTT-SUBSCRIBER-ENABLE /MQTT-SERVER:<address>:<port> [/MQTT-USER:<login name for authorization at the MQTT broker>] [/MQTT-PASSWORD:<password for authorization at the MQTT broker>] [/LOGIN:<user name>] [/PWD:<password>]
Параметры команды
Параметр
Описание
/<ENABLE|DISABLE|SHOW>Обязательный параметр.
Позволяет включить, выключить или просмотреть статус интеграции Kaspersky Industrial CyberSecurity for Nodes с Kaspersky Industrial CyberSecurity for Networks.
/SERVERS:<address>:<port>Обязательный параметр.
Позволяет указать адрес и порт сервера Kaspersky Industrial CyberSecurity for Networks или адрес MQTT-брокера. Диапазон возможных значений порта: 1–65535.
/KICS-MODE:<TELEMETRY|MQTT-PUBLISHER|UDP-DATA-DIODE>Необязательный параметр.
Позволяет выбрать режим интеграции приложения с Kaspersky Industrial CyberSecurity for Networks.
TELEMETRY– режим отправки телеметрии напрямую на сервер Kaspersky Industrial CyberSecurity for Networks по протоколу TCP;MQTT-PUBLISHER– режим отправки телеметрии на сервер MQTT-брокера;UDP-DATA-DIODE– режим отправки телеметрии через диод данных по протоколу UDP.
Значение параметра по умолчанию –
TELEMETRY./PINNED-CERTIFICATE:<full path to the TLS certificate file>Необязательный параметр.
Позволяет добавить TLS-сертификат соединения Kaspersky Industrial CyberSecurity for Nodes с сервером Kaspersky Industrial CyberSecurity for Networks.
/CLIENT-CERTIFICATE:<full path to the crypto-container>Необязательный параметр.
Позволяет добавить криптоконтейнер – файл формата PFX, в котором в зашифрованном виде хранится клиентский сертификат для защиты соединения Kaspersky Industrial CyberSecurity for Nodes с сервером Kaspersky Industrial CyberSecurity for Networks.
/CLIENT-PASSWORD:<password for the crypto-container>Обязательный параметр, если передан параметр
/CLIENT-CERTIFICATE.Позволяет указать пароль для доступа к криптоконтейнеру.
/TIMEOUT:<maximum server response timeout>Необязательный параметр.
Позволяет указать максимальную продолжительность ожидания ответа от сервера Kaspersky Industrial CyberSecurity for Networks в секундах. По истечении времени ожидания Kaspersky Industrial CyberSecurity for Nodes пытается подключиться к другому серверу Kaspersky Industrial CyberSecurity for Networks, если их несколько. Диапазон доступных значений: 1–3600 сек. Значение по умолчанию – 30 сек.
/SYNC-PERIOD:<synchronization request period>Необязательный параметр.
Позволяет указать интервал между запросами на сервер Kaspersky Industrial CyberSecurity for Networks в минутах. При работе Kaspersky Industrial CyberSecurity for Nodes в качестве MQTT-издателя данный параметр задает интервал между запросами к MQTT-брокеру в случае потери соединения с брокером.
Диапазон доступных значений: 1–60 мин. Значение по умолчанию – 1 мин.
/EVENTS-SENT-PERIOD:<maximum delay when sending events>Необязательный параметр.
Позволяет указать максимальную продолжительность задержки отправки событий на сервер Kaspersky Industrial CyberSecurity for Networks. По истечении указанного времени приложение повторно пробует подключиться к тому же серверу или подключается к следующему в списке серверу, если их несколько.
Диапазон доступных значений: 1–3600 сек. Значение по умолчанию – 30 сек.
При использовании Kaspersky Industrial CyberSecurity for Nodes в качестве MQTT-подписчика не рекомендуется настраивать получение данных телеметрии более чем от 250 устройств с Kaspersky Industrial CyberSecurity for Nodes, настроенном в качестве MQTT-издателя, в случае, если в настройках MQTT-издателей задано минимальное значение параметра
/EVENTS-SENT-PERIOD– 1 сек. Если значение параметра равно 30 сек. и более, не рекомендуется настраивать получение данных более чем от 1000 MQTT-издателей./EVENTS-LIMIT:<1|0>Необязательный параметр.
Позволяет включить ограничение количества передаваемых событий. Если количество событий превышает установленные ограничения, приложение прекращает отправлять события.
/EVENTS-PER-HOUR:<maximum number of events per hour>Обязательный параметр, если передан параметр
/EVENTS-LIMIT:1.Позволяет указать максимальное количество передаваемых событий в час. Диапазон доступных значений: 10–65 535. По умолчанию установлено значение 3000 событий в час.
/PWD:<password>Необязательный параметр.
Пароль учетной записи KLAdmin или учетной записи пользователя с необходимыми разрешениями.
Если значение параметра не указано, приложение предложит ввести пароль в следующей строке.
/LOGIN:<user name>Необязательный параметр.
Имя учетной записи пользователя с необходимыми разрешениями.
Если значение параметра не указано, приложение предложит ввести имя учетной записи в следующей строке.
Значение параметра не нужно указывать, если вы ввели пароль от учетной записи KLAdmin.
/VIRTUAL-SPAN-ENABLEНеобязательный параметр.
Позволяет включить режим неизбирательного сбора телеметрии.
По умолчанию Kaspersky Industrial CyberSecurity for Nodes собирает сетевой трафик, поступающий на сетевые интерфейсы компьютера и предназначенный компьютеру, на котором установлено приложение. В неизбирательном режиме приложение собирает сетевой трафик для сетевых интерфейсов компьютера с установленным приложением со всех доступных подсетей. На основе собранного сетевого трафика приложение формирует расширенную телеметрию.
Не все сетевые адаптеры поддерживают неизбирательный режим сбора телеметрии (англ. Promiscuous mode). На этих сетевых адаптерах сбор расширенной телеметрии не работает.
/VIRTUAL-SPAN-DISABLEНеобязательный параметр.
Позволяет выключить режим неизбирательного сбора телеметрии.
/VIRTUAL-SPAN-ADD-RULES:<IPv4 addresses of the computer's network interfaces>Необязательный параметр.
Позволяет добавить подсети в виде адресов сетевых интерфейсов компьютера (соответствующие подсети приложение определяет по маске подсети сетевого интерфейса), либо адресов сетевых интерфейсов с подсетями в формате IPv4.
Приложение собирает сетевой трафик в неизбирательном режиме только для сетевых интерфейсов, настроенных на указанные подсети.
Например:
/VIRTUAL-SPAN-ADD-RULES:198.51.100.0; 198.51.100.0/24./VIRTUAL-SPAN-REMOVE-RULES:<subnet IDs>Необязательный параметр.
Позволяет удалить подсети с указанными идентификаторами. Список добавленных подсетей и их идентификаторы можно отобразить с помощью команды
KAVSHELL KICS /SHOW./MQTT-SUBSCRIBER-ENABLEНеобязательный параметр.
Позволяет включить режим MQTT-подписчика для получения телеметрии с диода данных.
По умолчанию режим MQTT-подписчика выключен.
/MQTT-SUBSCRIBER-DISABLEНеобязательный параметр.
Позволяет выключить режим MQTT-подписчика.
/MQTT-SERVER:<address>:<port>Обязательный параметр, если передан параметр
/KICS-MODE:MQTT-PUBLISHERили параметр/MQTT-SUBSCRIBER:ENABLE.Позволяет указать адрес и порт MQTT-брокера.
Значение порта по умолчанию для MQTT-брокера – 1883.
/MQTT-USER:<login>Обязательный параметр, если на MQTT-брокере настроена авторизация по логину и паролю.
Позволяет указать логин для авторизации на MQTT-брокере.
/MQTT-PASSWORD:<password>Обязательный параметр, если на MQTT-брокере настроена авторизация по логину и паролю.
Позволяет указать пароль для авторизации на MQTT-брокере.
/UDP-SERVER:<address>:<port>Обязательный параметр, если передан параметр
/KICS-MODE:UDP-DATA-DIODE.Позволяет указать адрес и порт сервера Kaspersky Industrial CyberSecurity for Networks.
/UDP-ENCRYPTION-ENABLEНеобязательный параметр.
Позволяет включить шифрование при передаче данных по протоколу UDP.
/UDP-ENCRYPTION-DISABLEНеобязательный параметр.
Позволяет выключить шифрование при передаче данных по протоколу UDP.
/UDP-ENCRYPTION-KEY:<full path to the encryption key>Обязательный параметр, если передан параметр
/UDP-ENCRYPTION-ENABLE.Позволяет указать путь к файлу ключа шифрования с расширением .PEM.
/UDP-ENCRYPTION-PASSWORD:<password to the encryption key>Обязательный параметр, если передан параметр
/UDP-ENCRYPTION-ENABLE.Позволяет указать пароль для ключа шифрования.
Пример
KAVSHELL KICS /ENABLE /SERVERS:123.4.5.6:8080 /PINNED-CERTIFICATE:c:\user\certs\cetr.pfx /PWD:p@ssw0rd
KAVSHELL KICS /DISABLE /PWD:p@ssw0rd
KAVSHELL KICS /SHOW
KAVSHELL KICS /VIRTUAL-SPAN-ENABLE /PWD:p@ssw0rd
KAVSHELL KICS /VIRTUAL-SPAN-REMOVE-RULES:1,2,3 /PWD:p@ssw0rd
KAVSHELL KICS /VIRTUAL-SPAN-ADD-RULES:192.168.73.0/24;192.168.73.0/24 /PWD:p@ssw0rd
KAVSHELL KICS /ENABLE /KICS-MODE:MQTT-PUBLISHER /MQTT-SERVER:1.2.3.4:1218 /MQTT-USER:User /MQTT-PASSWORD:p@ssw0rd /PWD:p@ssw0rd
KAVSHELL KICS /ENABLE /KICS-MODE:TELEMETRY /SERVERS:123.4.5.6:8080 /MQTT-SUBSCRIBER-ENABLE /MQTT-SERVER:1.2.3.4:1218 /MQTT-USER:User /MQTT-PASSWORD:p@ssw0rd /PWD:p@ssw0rd
KAVSHELL KICS /MQTT-SUBSCRIBER-DISABLE
KAVSHELL KICS /ENABLE /KICS-MODE:UDP-DATA-DIODE /UDP-SERVER:1.2.3.4:1234 /UDP-ENCRYPTION-ENABLE /UDP-ENCRYPTION-KEY:c:\user\username\123e4567-e89b-12d3-a456-426655440990.pem /UDP-ENCRYPTION-PASSWORD:p@ssw0rd
Коды возврата команды:
- 0 – команда выполнена успешно.
- -3 – недостаточно прав для выполнения команды.
- -5 – синтаксическая ошибка.