Типы данных в схемах доменов

Раздел содержит описания типов данных, поддерживаемых схемами доменов, с особенностями их использования и примерами.

В таблице приняты следующие обозначения:

YYYY — год в четырехзначном формате.
MM — порядковый номер месяца (от 01 до 12).
DD — порядковый номер дня в месяце (от 01 до 31).
T — начало обозначения времени.
hh — часы в двузначном формате.
mm — минуты в двузначном формате.
ss — секунды в двузначном формате.
sss — миллисекунды в трехзначном формате.

Тип данных Описание Формат ввода-вывода Пример

Uuid

Универсальный уникальный идентификатор (UUID). Базовый тип.

Значение состоит из пяти групп шестнадцатеричных символов, разделенных дефисами:

<8 символов>-<4 символа>-<4 символа>-<4 символа>-<12 символов>

Используются только строчные буквы.

JSON-строка

"61f0c404-5cb3-11e7-907b-a6006ad3dba0"

Timestamp

Момент времени. Базовый тип.

JSON-строка может включать часовой пояс; при сохранении всегда приводится к времени UTC.

JSON-строка

"2024-08-10T10:31:41Z"

Date

Календарная дата в формате YYYY-MM-DD. Базовый тип.

JSON-строка

"2024-05-23"

Time

Время. Базовый тип. Допустимые форматы:

hh:mm:ss;
hh:mm:ss.sss.

JSON-строка

"05:35:22"

"05:35:22.111"

TimestampRange

Диапазон моментов времени. Базовый тип.

При сохранении всегда приводится к времени UTC.

Ниже представлены форматы значения даты-времени начала и окончания.

Только дата:

YYYY;
YYYY-MM;
YYYY-MM-DD.

Допустимы также формы "дата и время", состоящие из одной из вышеуказанных форм типа "только дата", за которой сразу следует "T", затем одна из нижеследующих форм представления времени, а за ней — необязательное значение смещения на часовой пояс:

hh:mm;
hh:mm:ss;
hh:mm:ss.sss.

JSON-строка

["2024-08-10T10:31:41Z", "2025-10-10T10:31:41Z"]

String

Строка. Базовый тип. Задается в двойных кавычках.

JSON-строка

"абвг123"

Text

Форматированный текст. Базовый тип.

JSON-объект

Ввод

{ "root": { "children": [ { "children": [ { "detail": 0, "format": 0, "mode": "normal", "style": "", "text": "просто ", "type": "text", "version": 1 }, { "detail": 0, "format": 2, "mode": "normal", "style": "", "text": "слово", "type": "text", "version": 1 }, { "detail": 0, "format": 0, "mode": "normal", "style": "", "text": " ", "type": "text", "version": 1 }, { "detail": 0, "format": 1, "mode": "normal", "style": "", "text": "Тест", "type": "text", "version": 1 } ], "direction": null, "format": "", "indent": 0, "type": "paragraph", "version": 1, "textFormat": 0, "textStyle": "" } ], "direction": null, "format": "", "indent": 0, "type": "root", "version": 1 } }

Вывод:

просто слово Текст

MAC

MAC-адрес. Базовый тип.

Значение — шесть двузначных шестнадцатеричных чисел, разделенных двоеточиями. Используются только заглавные буквы:

XX:XX:XX:XX:XX:XX

JSON-строка

"00:53:00:B8:DF:B8"

Integer

Целое число. Базовый тип.

JSON-число

255

Decimal

Число с заданной точностью. Базовый тип.

Дробная часть числа отделяется точкой. По умолчанию используется степень точности с одной цифрой после десятичного разделителя.

Если в параметрах указано количество знаков после запятой, используется это значение.

JSON-строка

0.9

Float

Число с плавающей точкой. Базовый тип.

Если в параметрах указано количество знаков после запятой, используется это значение.

JSON-число

0.999

Bool

Логическое значение. Базовый тип.

JSON-булево

True

False

Enum

Список предопределенных значений с возможностью выбрать одно значение. Базовый тип.

Для того чтобы использовать в схеме домена список, необходимо создать пользовательский тип данных.

JSON-строка

"CRITICAL"

IpAddress

Тип данных позволяет хранить IPv6 (по стандарту RFC 5952), IPv4, IPv4 в формате IPv6. Базовый тип.

IPv4 в нотации IPv6 записывается следующим образом:

Последние 32 младших бита записываются как IPv4-адрес.
В начале идут только нулевые поля и одно единичное, записанные в нотации IPv6.

JSON-строка

IPv6: "2001:0db8:85a3:0000:0000:8a2e:0370:7334"

IPv4: "192.0.2.128"

IPv4 в формате IPv6: "::ffff:192.0.2.128" (аналогично 192.0.2.128)

CIDR

Адрес подсети с маской в формате CIDR. Базовый тип.

Формат значения:

<IP-адрес>/<маска>

JSON-строка

IPv4: "198.51.100.0/22"

IPv6: "2001:db8::/48"

Reference

Значением является ссылка (например, на сущность). Базовый тип.

Ознакомьтесь с использованием атрибута типа Reference.

Ввод: JSON-строка, JSON-объект

Вывод: JSON-объект

Ввод (JSON-строка): "61f0c404-5cb3-11e7-907b-a6006ad3dba0"

Ввод (JSON-объект с обязательным полем id): \{"id": "61f0c404-5cb3-11e7-907b-a6006ad3dba0"}

Вывод (JSON-объект): \{"domainId": "exmpl.tld", "entityId": "Person", "id": "61f0c404-5cb3-11e7-907b-a6006ad3dba0"}

Workflow

Рабочий процесс. Базовый тип.

Значением является список состояний и переходов. В базе хранится одно значение для сущности на текущий момент.

Для того чтобы использовать в схеме домена рабочий процесс, необходимо создать пользовательский тип данных.

JSON-строка

"REPAIRING"

Array

Массив значений заданного типа данных. Структурный тип. Элементы массива указываются в квадратных скобках и разделяются запятой и пробелом.

Ознакомьтесь с заданием атрибута типа Array.

JSON-массив

[321, 123, 12344]

Table

Структурный тип. Данные хранятся в виде массива JSON, содержащего объекты с системными полями и полем значений атрибутов. Системное поле — rowId. Значение rowId не должно повторяться.

JSON-массив

Пример

[
  { rowId: 0, values: { doc: "b", releasedAt: "2024-11-01T02:00:00Z", checkSum: "09fabc" } },
  { rowId: 1, values: { doc: "c", releasedAt: "2024-12-01T02:00:00Z", checkSum: "09fa1c" } },
]

Calculation

Результат расчета по схеме. Базовый тип. Число с плавающей точкой.

JSON-число

100

Configuration

Ссылка на конфигурацию (уникальный идентификатор). Базовый тип.

Ознакомьтесь с описанием работы с атрибутом типа Configuration.

Тип Configuration не может использоваться в атрибутах-таблицах, массивах, а также при сортировке, фильтрации и поиске.

Ввод: JSON-строка

Вывод: JSON-строка

ID: active_connection

Description: active_connection

User: admin

Password: strongpassword

DB: DB55

Domain: exampledomain

Variable

Ссылка на переменную (уникальный идентификатор). Базовый тип.

Ознакомьтесь с описанием работы с атрибутом типа Variable.

Тип Variable не может использоваться в атрибутах-таблицах, массивах, а также при сортировке, фильтрации и поиске.

Ввод: JSON-строка

Вывод: JSON-строка

Переменная логина для LDAP-аутентификации:

user@example.com

URL

URL-адрес, ссылающийся на внешний ресурс. Базовый тип.

Может указываться как с лейблом, так и без него. Если лейбл не указан, отображается только URL-адрес.

Ограничение по числу символов для доменной зоны: от 2 до 6.
Ограничение по числу символов для лейбла: от 3 до 20.
В лейбле допустимо использовать строчные и заглавные буквы, цифры, дефис, подчеркивание и пробел.

Ввод: JSON-строка

Вывод: JSON-строка

С лейблом:
- Ввод: [Стартовая страница](http://example.com)
- Вывод: Стартовая страница
Без лейбла:
- Ввод: http://example.com
- Вывод: example.com

Identifier

Идентификатор в человекочитаемом формате. Базовый тип. Настраивается в схеме домена с помощью шаблона.

Ознакомьтесь с заданием атрибута типа Identifier.

JSON-строка

Используется шаблон типа "{@prefix}-{@YYYY}-{@MM}-{@DD}-{@inc}".

В пользовательском интерфейсе отображается идентификатор "INC-2025-03-21-4567".

Attachment

Значением является ссылка на файл и его метаданные. Базовый тип. Если тип данных используется в таблице или массиве, файлов может быть несколько. Файл может быть изображением или документом.

Ознакомьтесь с описанием работы с атрибутом типа Attachment.

Ввод: JSON-строка, JSON-объект

Вывод: JSON-объект

picture.jpg

Counter

Счетчик времени. Базовый тип.

Содержит ссылку на счетчик и его параметры:

id — идентификатор;
state — статус;
duration — интервал времени до срабатывания;
expiresAt — момент времени срабатывания;
startedAt — момент времени запуска;
lastPausedAt — момент времени последней остановки;
totalPausedTime — общее время, в течение которого счетчик был остановлен;
payload — полезная нагрузка.

RQL

Настройки фильтрации объектов. Структурный тип.

Включает идентификаторы домена и сущности, а также выражения фильтрации на языке RQL.

Тип RQL не может использоваться в атрибутах-таблицах, массивах, атрибутах связи, а также при сортировке, фильтрации и массовом редактировании.

JSON-объект

Пример ввода

{
  "domainId": "entities.tip.example",
  "entityId": "Artifact",
  "RQL": "id IN SELECT(@link.side2, FROM('current', @ioc_linked_malware, @link))"}
}

Пример вывода

Домен: entities.tip.example

Сущность: Artifact

RQL:

id IN SELECT(@link.side2, FROM('current', @ioc_linked_malware, @link))

Automation

Ссылка на автоматизацию (уникальный идентификатор). Базовый тип.

Ознакомьтесь с описанием работы с атрибутом типа Automation.

Тип Automation не может использоваться в атрибутах-таблицах, массивах, а также при сортировке, фильтрации и поиске.

JSON-строка

Была ли полезна эта страница?

Обратная связь