Получение данных клиентского ПК

USB-токены и смарт-карты JaCartaAPI и SDKUSB-токены и смарт-карты JaCarta

getUserHostData

Получение данных об устройстве пользователя. Кумулятивная функция. Позволяет получить все данные за один вызов.

Работает при состоянии аутентификации выше, чем JCWebClient2.Vars.AuthState.binded. Текущее состояние аутентификации можно получить с помощью команды getLoggedInState.

Для получения информации о ПК необходима лицензия:

• пользователь устройства должен иметь пользовательскую лицензию. Для получения лицензии JC-WebClient обращается к серверу запросов на лицензию. Настроить URL сервера запросов на лицензию можно с помощью функции initialize (см. аргумент licensing.activationRequestUrl);
• должна быть лицензия-подписка. Настроить лицензию-подписку можно с помощью функции initialize (см. аргумент licensing.license_data).

Аргументы:

info

• Тип: String
• Допустимые значения: JCWebClient2.Vars.UserHostData
• Описание: Тип запрашиваемых данных.

Результат: PlainObject — объект, содержащий данные об устройстве. В качестве ключей используются значения из JCWebClient2.Vars.UserHostData.

getSystemInfo

Получить данные о системе.

Работает при состоянии аутентификации выше, чем JCWebClient2.Vars.AuthState.notBinded. Текущее состояние аутентификации можно получить с помощью команды getLoggedInState.

Для получения информации о ПК необходима лицензия:

• пользователь устройства должен иметь пользовательскую лицензию. Для получения лицензии JC-WebClient обращается к серверу запросов на лицензию. Настроить URL сервера запросов на лицензию можно с помощью функции initialize (см. аргумент licensing.activationRequestUrl);
• должна быть лицензия-подписка. Настроить лицензию-подписку можно с помощью функции initialize (см. аргумент licensing.license_data).

Аргументы:

info

• Тип: String
• Допустимые значения: JCWebClient2.Vars.OsInfo
• Описание: Тип запрашиваемых данных.

Результат: String — в зависимости от запроса возвращаются следующие данные:

• на запрос JCWebClient2.Vars.OsInfo.machineID — уникальный идентификатор рабочей станции. Для каждой ОС свое значение:
  • для Microsoft Windows — GUID;
  • для macOS — серийный номер;
  • для Linux — machine id;
• на запрос JCWebClient2.Vars.OsInfo.user — имя активного пользователя;
• на запрос JCWebClient2.Vars.OsInfo.osType — тип ОС: Microsoft Windows, macOS или Linux;
• на запрос JCWebClient2.Vars.OsInfo.osDescription — подробное описание ОС;
• на запрос JCWebClient2.Vars.OsInfo.osArchitecture — архитектура ОС: 32 или 64.

getSystemDateTime

Получение системных даты и времени операционной системы в UTC.

Работает при состоянии аутентификации выше, чем JCWebClient2.Vars.AuthState.notBinded. Текущее состояние аутентификации можно получить с помощью команды getLoggedInState.

Результат: PlainObject — объект с параметрами:

day

• Тип: Integer
• Описание: День.

month

• Тип: Integer
• Описание: Месяц.

year

• Тип: Integer
• Описание: Год.

hour

• Тип: Integer
• Описание: Часы.

minute

• Тип: Integer
• Описание: Минуты.

second

• Тип: Integer
• Описание: Секунды.

offset

• Тип: Integer
• Описание: Смещение до локального времени в секундах.

getIpConfig

Получить сетевые интерфейсы клиентского ПК.

Работает при состоянии аутентификации выше, чем JCWebClient2.Vars.AuthState.notBinded. Текущее состояние аутентификации можно получить с помощью команды getLoggedInState.

Для получения информации о ПК необходима лицензия:

• пользователь устройства должен иметь пользовательскую лицензию. Для получения лицензии JC-WebClient обращается к серверу запросов на лицензию. Настроить URL сервера запросов на лицензию можно с помощью функции initialize (см. аргумент licensing.activationRequestUrl);
• должна быть лицензия-подписка. Настроить лицензию-подписку можно с помощью функции initialize (см. аргумент licensing.license_data).

Результат: PlainObject — объект с параметрами:

hostname

• Тип: String
• Описание: Имя хоста.

interfaces

• Тип: Array

• Описание: Массив сетевых интерфейсов. Каждый элемент массива является объектом со следующими параметрами:

  description

  • Тип: String
  • Описание: Описание интерфейса.

  macAddress (Необязательный)

  • Тип: String
  • Описание: MAC-адрес.

  type

  • Тип: String
  • Допустимые значения: JCWebClient2.Vars.NetInterfaceType
  • Описание: Тип сетевого интерфейса.

  ipAddresses (Необязательный)

  • Тип: Array

  • Описание: Массив IP-адресов. Каждый элемент массива является объектом со следующими параметрами:

    protocol

    • Тип: String
    • Допустимые значения: JCWebClient2.Vars.NetProtocol
    • Описание: Протокол.

    address

    • Тип: String
    • Описание: Адрес.

getProcesses

Получение запущенных процессов с соответствующими им активными сетевыми соединениями.

Работает при состоянии аутентификации выше, чем JCWebClient2.Vars.AuthState.notBinded. Текущее состояние аутентификации можно получить с помощью команды getLoggedInState.

Для получения информации о ПК необходима лицензия:

• пользователь устройства должен иметь пользовательскую лицензию. Для получения лицензии JC-WebClient обращается к серверу запросов на лицензию. Настроить URL сервера запросов на лицензию можно с помощью функции initialize (см. аргумент licensing.activationRequestUrl);
• должна быть лицензия-подписка. Настроить лицензию-подписку можно с помощью функции initialize (см. аргумент licensing.license_data).

Результат: Array — массив из объектов со следующими параметрами:

name

• Тип: String
• Описание: Имя процесса.

path

• Тип: String
• Описание: Путь до исполняемого файла.

pid

• Тип: Integer
• Описание: PID процесса.

parentPid

• Тип: Integer
• Описание: PID процесса-родителя.

tcpConnections

• Тип: Array

• Описание: Массив активных TCP-соединений процесса. Каждый элемент массива является объектом со следующими параметрами:

  state

  • Тип: String
  • Допустимые значения: JCWebClient2.Vars.TcpConnectionState
  • Описание: Состояние соединения.

  localAddress (Необязательный)

  • Тип: PlainObject
  • Описание: Локальный адрес процесса. Структура объекта: Сетевой адрес.

  remoteAddress (Необязательный)

  • Тип: PlainObject
  • Описание: Удаленный адрес, с которым взаимодействует процесс через локальный адрес. Структура объекта: Сетевой адрес.

udpConnections

• Тип: Array

• Описание: Массив активных UDP-соединений процесса. Каждый элемент массива является объектом со следующими параметрами:

  localAddress (Необязательный)

  • Тип: PlainObject
  • Описание: Локальный адрес процесса. Структура объекта: Сетевой адрес.

  remoteAddress (Необязательный)

  • Тип: PlainObject
  • Описание: Удаленный адрес, с которым взаимодействует процесс через локальный адрес. Структура объекта: Сетевой адрес.