Описание базы данных

Ниже приводится схема и описание таблиц базы данных, созданных для стандартного использования HBF-Server.

HBF-Server поддерживает PostgreSQL версии 14.8

Поскольку HBF-Server взаимодействует с этой базой данных самостоятельно, конечному пользователю не нужно беспокоиться о ее структуре и о том как хранятся данные.

Схема базы данных

На диаграмме ниже представлен визуальный обзор базы данных HBF-Server и связей между таблицами. В приведенном ниже Обзоре Таблиц, содержатся дополнительные сведения о таблицах и столбцах базы данных.

Обзор таблиц (сущности)

В этом разделе представлен обзор всех таблиц, созданных для стандартного использования HBF-Server. С последующим детальным описанием, что находится в каждой таблице.

Название таблицы	Описание	Соответствующие области взаимодействия интерфейса (API)
tbl_network	таблица tbl_network хранит информацию о IP Subnets c уникальным названием, CIDR и ссылкой на SG к сети которой она принадлежит	Отобразить список доступных сетей (Networks) Отобразить список доступных сетей (Networks) связанных с SG Отобразить SG по IP или CIDR Внести изменения в БД
tbl_host	в таблице tbl_host хранится информация о хостах (Host) с уникальным названием, UUID и ссылкой на SG к которой она принадлежит	Отобразить список доступных хостов (Hosts) Внести изменения в БД
tbl_host_ipset	в таблице tbl_host_ipset хранится информация о IP адресах, которыми оперирует Host	Отобразить список доступных хостов (Hosts) Внести изменения в БД
tbl_host_meta_info	в таблице tbl_host_meta_info хранится информация о metainfo хостов (ОС, платформа, версии и тд.)	Отобразить список доступных хостов (Hosts) с metainfo Внести изменения в БД
tbl_service	в таблице tbl_service хранится информация о сервисах (Service) с уникальным названием.	Отобразить список доступных сервисов (Service) Внести изменения в БД
tbl_service_transport_spec	в таблице tbl_service_transport_spec хранится информация о портахи и ICMP типах сообщений, которые слушает сервис (Service).	Отобразить список доступных сервисов (Services) Внести изменения в БД
tbl_sg	таблица tbl_sg хранит информацию о Security Groups (SG) с уникальным названием, правилом применяемым для входящих или исходящих пакетов, также возможностью включить логирование	Отобразить список Security Groups (SG) Внести изменения в БД
tbl_host2sg	в таблице tbl_host2sg хранится информация о связи хоста (Host) с группой безопасности (SG)	Отобразить список доступных хостов (Hosts) Внести изменения в БД
tbl_service2sg	в таблице tbl_svc2sg хранится информация о связи сервиса (Services) с группой безопасности (SG)	Отобразить список доступных сервисов (Services) Внести изменения в БД
tbl_svc_svc_rule	в таблице tbl_svc_svc_rule хранится информация о правилах между сервисами (Service to Service)	Отобразить список доступных правил (Service to Service) Внести изменения в БД
tbl_svc_fqdn_rule	в таблице tbl_svc_fqdn_rule хранится информация о правилах от сервиса до FQDN (Service to FQDN)	Отобразить список доступных правил (Service to FQDN) Внести изменения в БД
tbl_cidr_sg_rule	таблица tbl_ie_cidr_svc_rule хранит информацию CIDR-SVC правил для входящего и исходящего траффика с сетевым транспортным протоколом, бесклассовой междоменной маршрутизацией (CIDR) и диапазоном портов	Отобразить список доступных правил (Service to CIDR) Внести изменения в БД
tbl_ie_sg_sg_rule	таблица tbl_ie_sg_sg_rule хранит информацию SG-SG правил для входящего и исходящего траффика с сетевым транспортным протоколами и диапазоном портов	Отобразить список IE-SG-SG правил для входящего и исходящего траффика Внести изменения в БД
tbl_ie_sg_sg_icmp_rule	таблица tbl_ie_sg_sg_icmp_rule хранит информацию SG-SG правил для входящего и исходящего траффика через сетевой протокол ICMP	Отобразить список IE-SG-SG-ICMP правил для входящего и исходящего траффика Внести изменения в БД
tbl_cidr_sg_rule	таблица tbl_cidr_sg_rule хранит информацию CIDR-SG правил для входящего и исходящего траффика с сетевым транспортным протоколом, бесклассовой междоменной маршрутизацией (CIDR) и диапазоном портов	Отобразить список CIRD-SG правил для входящего и исходящего траффика Внести изменения в БД
tbl_cidr_sg_icmp_rule	таблица tbl_cidr_sg_icmp_rule хранит информацию CIDR-SG правил для входящего и исходящего траффика с сетевым протоколом ICMP, бесклассовой междоменной маршрутизацией (CIDR)	Отобразить список CIRD-SG правил для входящего и исходящего траффика Внести изменения в БД
tbl_fqdn_rule	таблица tbl_fqdn_rule хранит информацию SG-to-FQDN правил с сетевым транспортным протоколом и диапазоном портов	Отобразить список полных доменных имен (FQDN) Внести изменения в БД
tbl_sg_icmp_rule	таблица tbl_sg_icmp_rule хранит информацию SG:ICMP правил	Отобразить список правил SG:ICMP ограниченных по типу SG Внести изменения в БД
tbl_sg_rule	таблица tbl_sg_rules хранит информацию о правилах виртуального файрволла который можно настраивать для того чтобы контролировать входящий и выходящий трафик	Отобразить список SG правил ограниченных по условиям from -> to Внести изменения в БД
tbl_sg_sg_icmp_rule	таблица tbl_sg_sg_icmp_rule хранит информацию SG-SG:ICMP правил	Отобразить список правил SG-SG:ICMP ограниченных по типу SG from -> to Внести изменения в БД
tbl_sync_status	в таблице tbl_sync_status хранится информация об изменениях внесенных пользователем (дата последнего успешного изменения и кол-во изменённых строк)	Отобразить статус последнего успешного обновления БД

Подробное описание таблиц

Ниже приведены конкретные поля в каждой из таблиц, созданных для стандартного использования HBF-Server

tbl_network

Поле	Тип	Null	Ключ	Дополнительно
id	bigint		PRI	auto_increment
sg	bigint	YES	FK	внешний ключ к таблице tbl_sg.id
name	cname		ALT	длина значения не должна превышать 256 символов значения должно начинаться и заканчиваться символами без пробелов значение должно быть уникальным
network	cidr			значение от 7 до 19 байт пример `192.168.100.128/25` сетевые интервалы могут пересекаться

Ключи

Имя ключа	Тип	Поля
Alternative key	Simple Key	cname

tbl_host

Поле	Тип	Ключ	Дополнительно
id	bigint	PRI	auto_increment
uuid	uuid	UNI	Значение должно быть уникальным
name	cname	ALT	длина значения не должна превышать 256 символов значения должно начинаться и заканчиваться символами без пробелов значение должно быть уникальным

Ключи

Имя ключа	Тип	Поля
Alternative key	Simple Key	cname

tbl_host_ipset

Поле	Тип	Null	Ключ	По умолчанию	Дополнительно
host_id	bigint		FK		ссылается на tbl_host.id
addr	inet		UNI		Значение должно быть уникальным

Ключи

Имя ключа	Тип	Поля
tbl_host_ipset__ux_address	Уникальный индекс	host_id, (host(addr)::inet)

tbl_host_meta_info

Поле	Тип	Ключ	Дополнительно
host_id	bigint	FK	ссылается на tbl_host.id
host_name	cname
os	cname
platform	cname0
platform_family	cname0
platform_version	cname0
kernel_version	cname0

tbl_service

Поле	Тип	Null	Ключ	По умолчанию	Дополнительно
id	bigint		PRI		generated always as identity
name	cname		UNI		длина значения не должна превышать 256 символов значения должно начинаться и заканчиваться символами без пробелов значение должно быть уникальным

tbl_service_transport_spec

Поле	Тип	Null	Ключ	Дополнительно
svc_id	bigint		FK	ссылается на tbl_service.id
proto	ip_proto
ports	sg_rule_ports[]	да		Для TCP/UDP протоколов: обязательное поле ICMP протоколов: должно быть NULL
icmp_types	icmp_types	да		Для TCP/UDP протоколов: должно быть NULL Для ICMP протоколов: может быть определено

tbl_sg

Поле	Тип	Ключ	По умолчанию	Дополнительно
id	bigint	PRI		auto_increment
name	cname	ALT		длина значения не должна превышать 256 символов значения должно начинаться и заканчиваться символами без пробелов значение должно быть уникальным
logs	bool		false
trace	bool		false
default_action	chain_default_action		‘DROP’::chain_default_action	одно из двух значений: ACCEPT DROP

Ключи

Имя ключа	Тип	Поля
Alternative key	Simple Key	cname

tbl_host2sg

Поле	Тип	Null	Ключ	По умолчанию	Дополнительно
sg_id	bigint		FK		ссылается на tbl_sg.id
host_id	bigint		FK		ссылается на tbl_host.id. Хост может принадлежать только одной SG

Ключи

Имя ключа	Тип	Поля
fk_host2sg___sg	Внешний ключ	sg_id
fk_host2sg___host	Внешний ключ	host_id

tbl_service2sg

Поле	Тип	Null	Ключ	По умолчанию	Дополнительно
sg_id	bigint		FK		ссылается на tbl_sg.id
svc_id	bigint		FK		ссылается на tbl_service.id. Хост может принадлежать только одной SG

Ключи

Имя ключа	Тип	Поля
fk_svc2sg___sg	Внешний ключ	sg_id
fk_svc2sg___svc	Внешний ключ	svc_id

tbl_svc_fqdn_rule

Поле	Тип	Null	Ключ	По умолчанию	Дополнительно
id	bigint		PRI		auto_increment
svc_from	bigint		FK/ALT		внешний ключ к таблице tbl_service.id
fqdn_to	fqdn		ALT		длина значения не должна превышать 256 символов значение начинается со строки, которая содержит один или более символов, являющихся буквами нижнего регистра, цифрами, символом `.` или символами `_` и `-` (кроме первого символа, который не может быть `-` или `_`), и должна быть длиной от 1 до 62 символов затем может следовать любое количество строк, начинающихся с символа `.`, за которым идет один символ, являющийся буквой нижнего регистра, цифрой, символом `_` или символом `-`, и длина строки от 0 до 62 символов
proto	proto		ALT		одно из двух значений: tcp udp
ports	sg_rule_ports[]	YES			должно быть указано значение порта исходящего либо входящего трафика значение должно находиться в интервале от 1 до 65535 интервалы введённых значений портов для исходящего трафика не должны пересекаться
logs	bool			false
trace	bool			false
action	rule_action				одно из двух значений: ACCEPT DROP
priority	smallint			0	значения должны находиться в интервале от -32768 до 32767 чем ниже значение приоритета, тем выше приоритет имеет правило необязательное поле для заполнения, если значение не указать будет использоваться значение по умолчанию

Ключи

Имя ключа	Тип	Поля
Alternative key	Compound Key	svc_from fqdn_to proto

tbl_ie_cidr_svc_rule

Поле	Тип	Null	Ключ	По умолчанию	Дополнительно
id	bigint		PRI		auto_increment
proto	proto		ALT		одно из двух значений: tcp udp
cidr	cidr		ALT		значение cidr (диапазон ip адресов) в рамках одного правила (proto, sg, traffic) не должны пересекаться
svc	bigint		FK/ALT		внешний ключ к таблице tbl_service.id
traffic	traffic		ALT		ingress egress
ports	sg_rule_ports[]	YES			должно быть указано значение порта исходящего либо входящего трафика значение должно находиться в интервале от 1 до 65535 интервалы введённых значений портов для исходящего трафика не должны пересекаться
logs	bool
trace	bool
action	rule_action				одно из двух значений: ACCEPT DROP
priority	smallint			0	значения должны находиться в интервале от -32768 до 32767 чем ниже значение приоритета, тем выше приоритет имеет правило необязательное поле для заполнения, если значение не указать будет использоваться значение по умолчанию

Ключи

Имя ключа	Тип	Поля
Alternative key	Compound Key	proto cidr svc traffic

tbl_svc_svc_rule

Поле	Тип	Ключ	По умолчанию	Дополнительно
id	bigint	PRI		auto_increment
svc_from	bigint	FK/ALT		внешний ключ к таблице tbl_service.id
svc_to	bigint	FK/ALT		внешний ключ к таблице tbl_service.id
logs	bool		false
action	rule_action			одно из двух значений: ACCEPT DROP
priority	smallint		0	значения должны находиться в интервале от -32768 до 32767 чем ниже значение приоритета, тем выше приоритет имеет правило необязательное поле для заполнения, если значение не указать будет использоваться значение по умолчанию

Ключи

Имя ключа	Тип	Поля
Alternative key	Compound Key	svc_from svc_to

tbl_ie_sg_sg_rule

Поле	Тип	Null	Ключ	По умолчанию	Дополнительно
id	bigint		PRI		auto_increment
proto	proto		ALT		одно из двух значений: tcp udp
sg	bigint		FK/ALT		внешний ключ к таблице tbl_sg.id
sg_local	bigint		FK/ALT		внешний ключ к таблице tbl_sg.id
traffic	traffic		ALT		одно из двух значений: ingress egress
ports	sg_rule_ports[]	YES			должно быть указано значение порта исходящего либо входящего трафика значение должно находиться в интервале от 1 до 65535 интервалы введённых значений портов для исходящего трафика не должны пересекаться
logs	bool
trace	bool
action	rule_action				одно из двух значений: ACCEPT DROP
priority	smallint			0	значения должны находиться в интервале от -32768 до 32767 чем ниже значение приоритета, тем выше приоритет имеет правило необязательное поле для заполнения, если значение не указать будет использоваться значение по умолчанию

Ключи

Имя ключа	Тип	Поля
Alternative key	Compound Key	proto sg sg_local traffic

tbl_ie_sg_sg_icmp_rule

Поле	Тип	Ключ	По умолчанию	Дополнительно
id	bigint	PRI		auto_increment
sg	bigint	FK/ALT		внешний ключ к таблице tbl_sg.id
sg_local	bigint	FK/ALT		внешний ключ к таблице tbl_sg.id
traffic	traffic	ALT		одно из двух значений "ingress" или "egress"
ip_v	ip_family	ALT		одно из двух значений "IPv6" или "IPv4"
types	icmp_types			массив из smallint[] кодов типа ICMP
logs	Boolean		false
trace	Boolean		false
action	rule_action			одно из двух значений: ACCEPT DROP
priority	smallint		0	значения должны находиться в интервале от -32768 до 32767 чем ниже значение приоритета, тем выше приоритет имеет правило необязательное поле для заполнения, если значение не указать будет использоваться значение по умолчанию

Ключи

Имя ключа	Тип	Поля
Alternative key	Compound Key	sg sg_local traffic ip_v

tbl_cidr_sg_rule

Поле	Тип	Null	Ключ	По умолчанию	Дополнительно
id	bigint		PRI		auto_increment
proto	proto		ALT		одно из двух значений: tcp udp
cidr	cidr		ALT		значение cidr (диапазон ip адресов) в рамках одного правила (proto, sg, traffic) не должны пересекаться
sg	bigint		FK/ALT		внешний ключ к таблице tbl_sg.id
traffic	traffic		ALT		ingress egress
ports	sg_rule_ports[]	YES			должно быть указано значение порта исходящего либо входящего трафика значение должно находиться в интервале от 1 до 65535 интервалы введённых значений портов для исходящего трафика не должны пересекаться
logs	bool
trace	bool
action	rule_action				одно из двух значений: ACCEPT DROP
priority	smallint			0	значения должны находиться в интервале от -32768 до 32767 чем ниже значение приоритета, тем выше приоритет имеет правило необязательное поле для заполнения, если значение не указать будет использоваться значение по умолчанию

Ключи

Имя ключа	Тип	Поля
Alternative key	Compound Key	proto cidr sg traffic

tbl_cidr_sg_icmp_rule

Поле	Тип	Ключ	По умолчанию	Дополнительно
id	bigint	PRI		auto_increment
cidr	cidr	ALT		значение cidr (диапазон ip адресов) в рамках одного правила (ip_v, sg, traffic) не должны пересекаться
sg	bigint	FK/ALT		внешний ключ к таблице tbl_sg.id
traffic	traffic	ALT		ingress egress
ip_v	ip_family	ALT		одно из двух значений: IPv6 IPv4
types	icmp_types			массив из smallint[] кодов типа ICMP
logs	bool
trace	bool
action	rule_action			одно из двух значений: ACCEPT DROP
priority	smallint		0	значения должны находиться в интервале от -32768 до 32767 чем ниже значение приоритета, тем выше приоритет имеет правило необязательное поле для заполнения, если значение не указать будет использоваться значение по умолчанию

Ключи

Имя ключа	Тип	Поля
Alternative key	Compound Key	ip_v cidr sg traffic

tbl_fqdn_rule

Поле	Тип	Null	Ключ	По умолчанию	Дополнительно
id	bigint		PRI		auto_increment
sg_from	bigint		FK/ALT		внешний ключ к таблице tbl_sg.id
fqdn_to	fqdn		ALT		длина значения не должна превышать 256 символов значение начинается со строки, которая содержит один или более символов, являющихся буквами нижнего регистра, цифрами, символом `.` или символами `_` и `-` (кроме первого символа, который не может быть `-` или `_`), и должна быть длиной от 1 до 62 символов затем может следовать любое количество строк, начинающихся с символа `.`, за которым идет один символ, являющийся буквой нижнего регистра, цифрой, символом `_` или символом `-`, и длина строки от 0 до 62 символов
proto	proto		ALT		одно из двух значений: tcp udp
ports	sg_rule_ports[]	YES			должно быть указано значение порта исходящего либо входящего трафика значение должно находиться в интервале от 1 до 65535 интервалы введённых значений портов для исходящего трафика не должны пересекаться
logs	bool			false
action	rule_action				одно из двух значений: ACCEPT DROP
priority	smallint			0	значения должны находиться в интервале от -32768 до 32767 чем ниже значение приоритета, тем выше приоритет имеет правило необязательное поле для заполнения, если значение не указать будет использоваться значение по умолчанию

Ключи

Имя ключа	Тип	Поля
Alternative key	Compound Key	sg_from fqdn_to proto

tbl_sg_icmp_rule

Поле	Тип	Ключ	Дополнительно
id	bigint	PRI	auto_increment
ip_v	ip_family	ALT	одно из двух значений: IPv6 IPv4
types	icmp_types		массив из smallint[] кодов типа ICMP
sg	bigint	FK/ALT	внешний ключ к таблице tbl_sg.id
logs	bool
trace	bool
action	rule_action		одно из двух значений: ACCEPT DROP

Ключи

Имя ключа	Тип	Поля
Alternative key	Compound Key	ip_v sg

tbl_sg_rule

Поле	Тип	Null	Ключ	По умолчанию	Дополнительно
id	bigint		PRI		auto_increment
sg_from	bigint		FK/ALT		внешний ключ к таблице tbl_sg.id
sg_to	bigint		FK/ALT		внешний ключ к таблице tbl_sg.id
proto	proto		ALT		одно из двух значений: tcp udp
ports	sg_rule_ports[]	YES			должно быть указано значение порта исходящего либо входящего трафика значение должно находиться в интервале от 1 до 65535 интервалы введённых значений портов для исходящего трафика не должны пересекаться
logs	bool			false
action	rule_action				одно из двух значений: ACCEPT DROP
priority	smallint			0	значения должны находиться в интервале от -32768 до 32767 чем ниже значение приоритета, тем выше приоритет имеет правило необязательное поле для заполнения, если значение не указать будет использоваться значение по умолчанию

Ключи

Имя ключа	Тип	Поля
Alternative key	Compound Key	sg_from sg_to proto

tbl_sg_sg_icmp_rule

Поле	Тип	Ключ	По умолчанию	Дополнительно
id	bigint	PRI		auto_increment
ip_v	ip_family	ALT		одно из двух значений: IPv6 IPv4
types	icmp_types			массив из smallint[] кодов типа ICMP
sg_from	bigint	FK/ALT		внешний ключ к таблице tbl_sg.id
sg_to	bigint	FK/ALT		внешний ключ к таблице tbl_sg.id
logs	bool
trace	bool
action	rule_action			одно из двух значений: ACCEPT DROP
priority	smallint		0	значения должны находиться в интервале от -32768 до 32767 чем ниже значение приоритета, тем выше приоритет имеет правило необязательное поле для заполнения, если значение не указать будет использоваться значение по умолчанию

Ключи

Имя ключа	Тип	Поля
Alternative key	Compound Key	ip_v sg_from sg_to

tbl_sync_status

Поле	Тип	Null	Ключ	Дополнительно
id	bigint		PRI	auto_increment
total_affected_rows	bigint			при любой процедуре (удаление/добавление/редактирование) данных в таблицах будет учтена сумма всех изменённых строк
updated_at	timstamptz	YES		дата изменения

Описание базы данных

Схема базы данных​

Обзор таблиц (сущности)​

Подробное описание таблиц​

tbl_network​

tbl_host​

tbl_host_ipset​

tbl_host_meta_info​

tbl_service​

tbl_service_transport_spec​

tbl_sg​

tbl_host2sg​

tbl_service2sg​

tbl_svc_fqdn_rule​

tbl_ie_cidr_svc_rule​

tbl_svc_svc_rule​

tbl_ie_sg_sg_rule​

tbl_ie_sg_sg_icmp_rule​

tbl_cidr_sg_rule​

tbl_cidr_sg_icmp_rule​

tbl_fqdn_rule​

tbl_sg_icmp_rule​

tbl_sg_rule​

tbl_sg_sg_icmp_rule​

tbl_sync_status​

Схема базы данных

Обзор таблиц (сущности)

Подробное описание таблиц

tbl_network

tbl_host

tbl_host_ipset

tbl_host_meta_info

tbl_service

tbl_service_transport_spec

tbl_sg

tbl_host2sg

tbl_service2sg

tbl_svc_fqdn_rule

tbl_ie_cidr_svc_rule

tbl_svc_svc_rule

tbl_ie_sg_sg_rule

tbl_ie_sg_sg_icmp_rule

tbl_cidr_sg_rule

tbl_cidr_sg_icmp_rule

tbl_fqdn_rule

tbl_sg_icmp_rule

tbl_sg_rule

tbl_sg_sg_icmp_rule

tbl_sync_status