Перейти к содержанию

Технический паспорт

Справка для ИТ-службы и службы безопасности компании: версии частей платформы, алгоритмы шифрования и подписи, какие модели отвечают и где лежат данные. Общая схема — на странице «Как устроен Wikilect», здесь — точные значения.

Значения сверены с кодом и настройками выпуска 19.11.2026. Платформа обновляется часто, поэтому номера версий меняются. Где значение зависит от установки или пока не сверено, так и написано. Нужны значения на конкретную дату или для вашего контура — напишите в поддержку («Помощь, поддержка и обучение»).

Два варианта установки:

  • Облако Wikilect — платформа работает на наших серверах в России.
  • Свой контур — платформа стоит на серверах компании.

Версии частей платформы

Облако Wikilect

Часть Что стоит Версия
Кластер Kubernetes, управляемая служба облачного провайдера в России зависит от провайдера
База данных PostgreSQL с расширением pgvector, управляемая служба провайдера, основной сервер и копия на втором версию сообщаем по запросу
Кабинет (сервер) Python, Django, Django REST Framework Python 3.10, Django 4.1.7, DRF 3.14.0
Вход и пропуска djangorestframework-simplejwt, PyJWT 5.2.2, 2.6.0
Веб-сервер кабинета gunicorn с обработчиками uvicorn gunicorn 20.1.0, uvicorn 0.54.0
Фоновые задачи Celery 5.2.7
Очереди и кэш Redis 7.0.15
Шифрование секретов библиотека cryptography 40.0.2
Интерфейс статика (React, TypeScript), раздаёт nginx React 19.3.0, TypeScript 5.9.3, nginx 1.30.7
Сборка интерфейса Bun, Vite Bun 1.3.14, Vite 6.4.3
Хранилище файлов S3-совместимое объектное хранилище облачного провайдера в России служба провайдера
Шлюз моделей LiteLLM линия выпусков main-stable, точный номер — по запросу
Среды агентов контейнеры Linux на узле агентов; внутри — Python 3, Node.js, Bun обновляются вместе с агентом
Поиск по базе знаний модель векторов jina-embeddings-v5-text-nano и переранжировщик jina-reranker-v3 на нашем сервере; можно выбрать модель векторов через шлюз размер вектора в базе — 1024
Распознавание речи faster-whisper-large-v3-turbo на наших серверах; для диктовки — Yandex SpeechKit —

Свой контур

Комплект ставится на две машины: на первой — платформа, на второй — узел агентов.

Часть Что стоит Версия
Операционная система Ubuntu 24.04
Кластер k3s (Kubernetes на одной машине) актуальный стабильный выпуск k3s на день установки
База данных PostgreSQL с расширением pgvector PostgreSQL 16
Хранилище файлов SeaweedFS (S3-совместимое) 3.97
Шлюз моделей LiteLLM, образ закреплён по контрольной сумме v1.106.4
Скрытие персональных данных Microsoft Presidio с русской языковой моделью spaCy ru_core_news_lg —
Очереди и кэш Redis 7.0.15
Кабинет и интерфейс те же образы, что в облаке; версия — та, что выпущена на день установки или обновления см. таблицу выше
Поиск по базе знаний модель ai-forever/ru-en-RoSBERTa внутри контура —
Языковые модели и распознавание речи модели, которые выбрала компания зависит от установки
Среды агентов Docker на второй машине зависит от установки

Шифрование и подпись

При передаче

Проверено на адресах облака Wikilect (кабинет, интерфейс, узел агентов, эта документация).

Что Значение
Протоколы TLS 1.3 и TLS 1.2. TLS 1.0 и 1.1 отклоняются
Наборы шифров TLS 1.3 TLS_AES_256_GCM_SHA384, TLS_AES_128_GCM_SHA256, TLS_CHACHA20_POLY1305_SHA256
Наборы шифров TLS 1.2 ECDHE-RSA-AES256-GCM-SHA384, ECDHE-RSA-AES128-GCM-SHA256, ECDHE-RSA-CHACHA20-POLY1305 (обмен ключами ECDHE — прямая секретность)
Сертификат Let's Encrypt, ключ RSA 2048 бит, подпись SHA-256 с RSA, продлевается автоматически
HTTP обычный адрес по HTTP перенаправляется на HTTPS (код 308)
HSTS max-age=31536000; includeSubDomains — браузер год ходит только по HTTPS
Куки входа только по HTTPS (признак Secure)

Документация (docs.wikilect.com) — статический сайт без данных пользователей. Для старых браузеров он дополнительно принимает наборы TLS 1.2 без GCM.

Свой контур. Снаружи — только HTTPS на порту 443, сертификат компании. Защиту связи внутри контура настраиваем при установке вместе с ИТ компании под её требования.

При хранении

Что Как защищено
Пароли Только хеш: PBKDF2 с HMAC-SHA256, 390 000 повторов, у каждого пароля своя случайная соль (стандартный механизм Django 4.1). Сам пароль не хранится. Минимальная длина пароля — 8 символов
Вход через AD / AD FS и единый вход Пароль у нас не хранится вовсе: проверку делает служба каталогов компании
Ключи доступа к моделям, ключи своих провайдеров моделей Зашифрованы в базе: Fernet (AES-128 в режиме CBC и проверка целостности HMAC-SHA256). Ключ шифрования — отдельный секрет платформы, не тот, что подписывает пропуска
Секретные переменные агента и группы, пароль и пропуск машины агента, SSH-ключ среды агента Зашифрованы тем же способом (Fernet). Наружу через интерфейс показываются только имена переменных, без значений
Секрет приложения для единого входа (SSO), секрет бота корпоративного мессенджера Зашифрованы тем же способом (Fernet)
Разговоры, документы, файлы Защищены средствами площадки хранения: в облаке — провайдера, в своём контуре — ИТ компании. Подробности — по запросу ИТ-службы через поддержку
Резервные копии сред агентов (облако) Шифруются перед отправкой в хранилище копий
Настройки подключённых внешних систем (серверы MCP) Шифрование части настроек ещё дорабатывается. Ключи внешних систем храните в секретных переменных группы — они зашифрованы

Подпись пропусков и сессий

Что Значение
Пропуск человека (JWT) Подпись HMAC-SHA256 (HS256). Ключ подписи — отдельный секрет, только в окружении платформы, в коде и образах его нет. Без ключа кабинет не запускается
Срок пропуска Скользящий: продлевается, пока человек пользуется, не чаще раза в сутки. После входа через единый вход — 12 часов с продлением
Отзыв Пропуск можно отозвать («выйти везде», смена пароля, выход из пространства); проверка отзыва встроена в каждый вход
Смена ключа подписи Возможна в любой момент. Пропуска людей на старом ключе сразу перестают действовать; машинам агентов на короткое время смены принимается только их сохранённый пропуск
Сессии и одноразовые ссылки Подписываются секретным ключом Django (HMAC-SHA256), отдельным от ключа пропусков

Какие модели отвечают и где работают

Все обращения к языковым моделям идут через шлюз моделей. Напрямую из среды агента к модели не ходят. Модель выбирается у поля ввода, модель по умолчанию задаёт администратор для группы.

Задача Облако Wikilect Свой контур
Ответы агента Модели крупных разработчиков: семейства GPT (OpenAI), Claude (Anthropic), Gemini (Google) и другие — по подпискам Wikilect через наш шлюз или через посредников-агрегаторов моделей Модели, которые выбрала компания: развёрнутые внутри контура или облачные модели компании
Где модель обрабатывает запрос У разработчика модели или посредника. Они могут находиться за пределами России Внутри контура — если модель стоит в контуре; иначе у того облака, которое выбрала компания
Поиск по базе знаний (векторы) Своя модель на наших серверах; по выбору — модель векторов через шлюз Своя модель внутри контура
Переранжирование результатов поиска Своя модель на наших серверах Модель, выбранная компанией
Распознавание речи Свои модели на наших серверах; диктовка — Yandex SpeechKit (Россия) Своя модель внутри контура; облачную службу можно подключить отдельно
Скрытие персональных данных перед моделью Шлюз умеет заменять метками имена, телефоны, почту, ИНН, СНИЛС, паспорт, номера карт; включено ли в вашем пространстве — уточните в поддержке Включается при установке

Что уходит в модель: вопрос, история текущего разговора и то, что агент нашёл для ответа (фрагменты документов, результаты инструментов). Ключи доступа к моделям у провайдеров принадлежат Wikilect (облако) или компании (свой контур). Каждому человеку и агенту шлюз выдаёт свой ключ со своими лимитами.

Где лежат данные

Что Где хранится Сколько хранится Кто видит
Учётные записи, оргструктура, права, настройки База данных PostgreSQL Пока пространство существует Администратор пространства; сотрудник — свою учётную запись
Разговоры в кабинете и история ответов агента База данных PostgreSQL Без срока. По заявлению человека обезличиваем По общему правилу доступа: сотрудник — своё, руководитель — свой отдел и ниже; общие разговоры — их участники
Загруженные документы, вложения, записи встреч Хранилище файлов (S3) Пока их не удалили. Незавершённые загрузки удаляются через 48 часов По общему правилу доступа, как разговор или раздел, к которому файл приложен
База знаний: текст документов и поисковый индекс База данных (векторы pgvector) и хранилище файлов Пока документ есть в источнике и в базе знаний Те, кому открыта база знаний; агент — с правами человека
Рабочие файлы агента Среда агента (отдельный контейнер) на узле агентов Пока существует среда Сам человек и его агент. Общий агент — участники его разговоров
Секреты и ключи База данных, зашифрованы (см. «При хранении») Пока их не удалили или не заменили Значения не показываются никому через интерфейс; используются только платформой
Журналы работы платформы Журналы контейнеров Обрезаются по объёму (свой контур: по 10 МБ, 5 файлов на контейнер) Сотрудники Wikilect (облако) или ИТ компании (свой контур)
Журнал расхода моделей База шлюза моделей Без срока Администратор пространства (экран расхода), сотрудники Wikilect
Резервные копии Облако: база — каждую ночь в отдельное хранилище, у базы есть рабочая копия на втором сервере; среды агентов — каждую ночь, в зашифрованном виде. Свой контур: каждую ночь на первую машину Среды агентов в облаке — 7 дневных и 4 недельные копии. Свой контур — 7 дней, дальше копии забирает ИТ компании по своим правилам Сотрудники Wikilect (облако) или ИТ компании (свой контур)

Где физически. Облако Wikilect: кабинет, база, файлы, среды агентов и резервные копии — на серверах в России. За пределы России может уходить только запрос к облачной языковой модели (см. «Какие модели отвечают»). Свой контур: всё на серверах компании; наружу уходят только запросы к моделям, если компания сама подключила внешнюю модель.

В копию своего контура входят база кабинета, файлы и секреты установки. База шлюза моделей (подключённые модели, журнал расхода) в ночную копию не входит: после восстановления модели подключаются заново.

Чего в продукте пока нет

Пишем прямо, чтобы ИТ-служба могла учесть это заранее:

  • Шифрования разговоров и файлов самим продуктом — шифруются диски площадки.
  • Единого журнала аудита для администратора: входы, неудачные входы, смена ролей и прав отдельно не записываются. Журналы есть по отдельным областям.
  • Настройки срока хранения разговоров — в работе; сейчас разговоры хранятся без срока.
  • Входа по SAML и SCIM. Второй фактор — на стороне службы каталогов компании (AD FS).