Разработка интеграции внешней системы (парковочного оборудования АП-ПРО) со СКУД RusGuard через gRPC API — для клиента, использующего RusGuard Soft на объекте (упоминается «янтарный комбинат», Калининград/Ленинград — точное название в источнике противоречиво).
Содержание
Технический протокол: RusGuard начиная с версии 3.3.1 не развивает SOAP — новые методы добавляются только в gRPC; под Linux интеграция возможна исключительно через gRPC. Рекомендуемая версия — RusGuard Soft 3.5.7 и выше (требует MS SQL Server 2019+, перед обновлением которого нужен бэкап RusGuardDB).
Порты и авторизация (подтверждено официальным письмом от RusGuard):
- RusGuard 3.x → порт 47908, gRPC по HTTP/2.
- RusGuard 4.x → порт 8433 (не путать с портом 8443 — это отдельный порт для связи АРМ с сервером RusGuard в версии 4, другое назначение).
- Авторизация — Basic access authentication (base64
username:demo_userв gRPC metadata, заголовокauthorization), канал — TLS/SSL.
Уже готовый задел (Python SDK от клиента/RusGuard):
client-8.py—RusGuardGrpcClient: подключение (connect()/close()), Basic Auth metadata, secure gRPC channel, стабыILDataServiceStubиILNetworkConfigurationServiceStub.grpc_wrappers-9.py— обёртки gRPC-ответов в Python-объекты:AcsEmployee,EmployeeGroup,AcsKey(поляkeynumber,rfidepc,cardtypeid,cardtypename,acsemployeeid,islost, даты действия),CardTypeи связанные сущности.main-2.py/main_import-3.py— рабочие сценарии: создание сотрудника →generate_key()→assign_acs_key_for_employee(...)сcard_type_id/index_number— то есть выпуск и привязка карты доступа уже реализованы как пример.Import-10.csv,requirements-6.txt— данные для пакетного импорта и зависимости окружения.
Целевой сценарий (уточнён в переписке): пользователю нужно только выгружать события прохода в реальном времени (не полный CRUD), интеграция на Python 3.12, изначально планировался Windows-сервер, но по факту работает из Linux-контейнера с версией RusGuard Soft 3.5.7.
Контекст со стороны RusGuard/АП-ПРО: переписка идёт между интегратором (руководитель ОР АП-ПРО — Максим Шелков) и стороной RusGuard (контакты упоминаются как Дмитрий Иванов, igor@3390017.ru) по вопросу интеграции парковочного оборудования АП-ПРО с установленной у клиента СКУД RusGuard. Со стороны RusGuard подтверждена готовность помогать («всю работу всё равно делать нам — мы особо не против»), и что у них уже был опыт интеграций с внешними «бюро пропусков» у других заказчиков.
Рекомендованный минимальный безопасный старт: сначала режим только чтения (connect() → получить типы карт → получить ключи сотрудника → вывести keynumber/rfidepc/cardtypename/islost), и только после проверки переходить к операциям записи.
Реквизиты: ИНН ООО «АП-ПРО» (Санкт-Петербург) — 7807189251.
Конкурентные/смежные бренды СКУД-оборудования (встречались в отдельных запросах пользователя, не обязательно закупались): KeyTex — российский бренд RFID-оборудования (считыватели, метки, антенны, линейка GATE для СКУД/учёта транспорта), производитель ООО «Витал Электроникс», Санкт-Петербург; BIOSMART — российский производитель СКУД-считывателей (подтверждено повторно: модель WR-10 — мультиформатный считыватель EM-Marine/Mifare/ISOProx II + NFC/BLE, интерфейсы RS-485(OSDP)/Wiegand, IP65, -40…+50°C, интеграция с контроллерами BioSmart Prox-E/UniPass).
Смежная система — ITV «Интеллект» (srv_intellect, MS SQL Server): в отдельном запросе пользователя фигурирует MS SQL база [srv_intellect].[dbo] с таблицами OBJ_DEPARTMENT и OBJ_PERSON (структура классической СКУД ITV «Интеллект»/Rubezh). В OBJ_PERSON уже заведены поля под интеграции с несколькими сторонними ACS-вендорами одновременно: rubeg8_zone_id (Рубеж-08), bolid_in_device/bolid_in_pku/bolid_user_type (Болид), percos20v2car/percos20v2comis1/percos20v2comis2/percos20v2comtype/percos20v2guest/percos20v2stop/percos20v2verify (Percos v2 — распознавание номеров ТС), ravelin_acs_type/ravelin_guest_card (Ravelin). То есть у клиента(ов) «Интеллект» используется как центральный хаб, а не только RusGuard — не выяснено, тот же ли это заказчик, что и в основной переписке про RusGuard выше.
Связано с
- solarstaff-project — родительский проект пользователя (СКУД, интеграции парковочного биллинга)
- traffic-control-billing-system-2 — ТЗ ASPP–AP-PRO, к которому относится эта интеграция
- max-digital-id — смежная схема верификации/событий проезда
Источник
- raw/_______________________________________RusGuard_________________________________ (2a39762a-2022-4026-b462-03c003db92ba).md (экспорт Perplexity)
Комментарии