Технический паспорт
Справка для ИТ-службы и службы безопасности компании: версии частей платформы, алгоритмы шифрования и подписи, какие модели отвечают и где лежат данные. Общая схема — на странице «Как устроен 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).