Подробный гайд: Установка плагина Saby (СБИС) на Astra Linux 1.8

Пошаговая установка плагина Saby (СБИС) на Astra Linux 1.8. Настройка зависимостей, работа с ЭЦП, устранение ошибок. Гайд для системных администраторов.

Подробный гайд: Установка плагина Saby (СБИС) на Astra Linux 1.8

Важно:

Плагин Saby (ранее известный как СБИС Плагин) разрабатывается компанией «Тензор» для работы с ЭДО, электронной подписью и сервисами экосистемы Saby. Официальная поддержка Linux включает Debian-совместимые дистрибутивы, к которым относится Astra Linux SE 1.8. Всегда сверяйтесь с официальной документацией и актуальными релизами.

Требования

Компонент	Минимальные требования
ОС	Astra Linux 1.8 (x86_64)
Права	`sudo` или доступ к `root`
Браузер	Chromium / Google Chrome / Firefox / Яндекс.Браузер (последние стабильные версии)
Зависимости	`libnss3`, `libgtk-3-0`, `libx11-6`, `pcscd`, `opensc`, `curl`, `apt-transport-https`
Интернет	Для скачивания пакета и расширений

Шаг 1: Подготовка системы

1. Обновите индексы и пакеты:

   sudo apt update && sudo apt upgrade -y

2. Установите базовые зависимости:

   sudo apt install -y libnss3 libgtk-3-0 libx11-6 pcscd opensc curl gpg

3. Запустите и включите службу работы с токенами/картами (если используется ЭЦП):

   sudo systemctl enable pcscd
   sudo systemctl start pcscd

Шаг 2: Скачивание пакета Saby

Официальный репозиторий или прямая ссылка предоставляется на сайте плагина.

На момент 2024–2026 гг. актуальный пакет находится по адресу:

https://plugin.saby.ru/

Перейдите на сайт, выберите Linux → DEB (x86_64).

2. Скачайте файл в домашнюю директорию:

   cd ~/Downloads
   curl -LO https://plugin.saby.ru/download/deb/saby-plugin_latest_amd64.deb

(Если прямая ссылка изменилась, скачайте вручную через браузер)

Шаг 3: Установка нативного компонента

1. Установите пакет:

   sudo dpkg -i saby-plugin_latest_amd64.deb

2. Если возникли ошибки зависимостей:

   sudo apt --fix-broken install -y

3. Проверьте установку:

   dpkg -l | grep saby-plugin
   saby-plugin --version

Ожидается вывод версии, например: Saby Plugin v3.14.2

Шаг 4: Установка расширения в браузер

Нативный компонент работает только в паре с расширением.

Выберите ваш браузер:

Chromium / Chrome / Яндекс.Браузер

Откройте chrome://extensions/
Включите Режим разработчика (справа вверху)

3. Нажмите Загрузить распакованное расширение или установите из магазина:

Chrome Web Store: Saby Plugin - chrome.google.com/webstore
Яндекс.Браузер: Дополнения - addons.opera.com
1. После установки значок Saby появится на панели. Нажмите на него → Разрешить доступ к файлам (если требуется).

Firefox

Откройте about:addons

2. Найдите Saby Plugin в официальном каталоге или установите вручную:

   # Если расширение в формате .xpi:
   firefox saby-plugin.xpi

В настройках Firefox разрешите взаимодействие с нативными приложениями.

В Astra Linux часто используется Chromium из репозитория astra-current. Убедитесь, что версия ≥ 90.

Особенности Astra Linux 1.8

Аспект	Рекомендация
Контроль запуска	Astra SE использует мандатный контроль (Parsec). Если плагин не запускается, проверьте метки: `ls -Z /usr/bin/saby-plugin`. При необходимости добавьте правило в `fly-admin-sec`.
Подпись пакета	Если `dpkg` ругается на отсутствие подписи, используйте: `sudo dpkg --force-signature -i saby-plugin_*.deb` (только если пакет скачан с официального сайта).
Браузерные политики	В некоторых сборках Astra отключена загрузка внешних расширений. Добавьте `--allow-external-extensions` в `/etc/chromium.d/custom-flags` или используйте групповые политики.
Токены/Рутокен	Для работы с ЭЦП установите `rtclient` или `JaCarta` драйверы. Проверьте видимость: `pcsc_scan`

Шаг 5: Проверка работы

Перезапустите браузер.
Перейдите на plugin.saby.ru/test или откройте любой сервис Saby (например, СБИС ЭДО).
Значок плагина должен стать зелёным или отображать статус Подключено.
В консоли браузера (F12 → Console) не должно быть ошибок Native Messaging host not found.

Если используется ЭЦП:

pkcs11-tool --module /usr/lib/opensc-pkcs11.so -L

Должны отобразиться сертификаты и ключи.

Устранение неполадок

Симптом	Решение
`dpkg: dependency problems`	`sudo apt --fix-broken install`
Браузер пишет `Плагин не найден`	Проверьте путь нативного хоста: `~/.config/Google/Chrome/NativeMessagingHosts/` или `/etc/opt/chrome/native-messaging-hosts/`. Файл `ru.saby.plugin.json` должен содержать корректный `path` к `/usr/bin/saby-plugin`
Не виден токен/карта	`sudo systemctl restart pcscd`, проверьте права: `sudo usermod -aG pcscd $USER`, перелогиньтесь
Ошибка Parsec/мандатный контроль	`sudo parsecacl -a allow -u $USER -f /usr/bin/saby-plugin -p rwx`
Плагин не обновляется	Удалите старую версию: `sudo apt remove saby-plugin`, установите заново

Важные рекомендации

Всегда используйте официальные источники. Сторонние сборки могут содержать уязвимости или нарушать политики безопасности Astra Linux.
Регулярно обновляйте плагин: sudo apt update && sudo apt upgrade saby-plugin
Резервное копирование сертификатов: Экспортируйте ЭЦП перед обновлением ОС или плагина.
Совместимость: Astra Linux 1.8 обновляется до ядра и библиотек Debian 10/11. При миграции на 2.x проверьте актуальность пакета Saby.

Официальные ресурсы

Сайт плагина: plugin.saby.ru
База знаний: help.saby.ru
Репозиторий Debian: plugin.saby.ru/repo/deb/ (если доступен)
Поддержка Astra Linux: wiki.astralinux.ru

Информация предоставлена в ознакомительных целях. Применение описанных настроек в системах, должно осуществляться только после согласования с ответственными за информационную безопасность и в соответствии с требованиями ФСТЭК, ФСБ и иных уполномоченных органов.