# Установка встроенного приложения на Epson

## Подготовка

Установите прошивку с поддержкой открытых платформ. Скачайте ПО с сайта: <https://openplatform.epson.biz/download/op/en/>

Запустите установку, следуйте указаниям мастера.

На сайте <https://openplatform.epson.biz/license-op/inputInformation.html> получите регистрационный ключ **Product Key** (потребуется серийный номер устройства).

## Установка пароля администратора (необязательно)

Для ограничения доступа пользователей к настройкам устройства можно установить пароль администратора.

Установка с панели управления:

1. На панели управления выберите "Настр.".
2. "Общие параметры" → "Администрир. системы" → "Настр. безопасности" → "Настройки администратора".
3. "Пароль администратора" → "Регистрация".
4. Введите новый пароль.
5. Введите пароль повторно.

## Подключение к ПринтМенеджеру

Необходимо произвести настройки, указанные ниже. Для этого:

1. Откройте административную панель Мониторинга и перейдите в раздел "Настройки принтеров":
   `https://адрес_сервера:8001/config/printer/printersettings/`
2. Кликните на ID нужного устройства. Откроется окно с настройками.

Обязательно нужно указать:

- **Хост** — IP-адрес хоста
- **Пароль** — пароль администратора устройства (если задан)
- **Настраиваемые атрибуты** — введите Product Key в формате JSON: `{"product_key": "xxx-xxxx-xxx-xxx"}`

Убедитесь, что МФУ подключён к ПринтМенеджеру:

1. Откройте панель ПринтМенеджера и перейдите в раздел "Принтеры": `https://адрес_сервера:8080/config/web/printer/`
2. Кликните на ID нужного устройства.

Убедитесь, что автоматически заполнены при импорте МФУ:
- **Идентификатор в CUPS**
- **Название**
- **Хост**
- **Сервер печати**

## Настройка HTTPS и сертификата

Для корректной передачи данных по HTTPS настройте импорт сертификата с сервера:

1. Зайдите на веб-интерфейс МФУ.
2. Перейдите во вкладку "Безопасность сети".
3. Перейдите во вкладку "Сертификат ЦС".
4. Нажмите "Импортировать" напротив свободного слота.
5. Загрузите сертификат с сервера: `/home/printum/certs/ca/printum_ca.crt`.

## Инициализация через консоль

Подключитесь по SSH к серверу и выполните:

```
cd /opt/printmanager
sudo docker-compose exec app bash
python ./manage.py epson_setup <printer_id> --insecure-server
```

где `printer_id` — идентификатор принтера в ПринтМенеджере, его можно посмотреть в административной панели ПринтМенеджера, в разделе "Управление печатью" → "Принтеры".

## Генерация токена

В Личном кабинете: "Управление" → "Устройства", выберите МФУ, нажмите "Токен не сгенерирован" → "Сгенерировать токен". В профиль МФУ добавится токен, необходимый для установки.

## Настройка картридера

Подключите картридер к заднему USB-порту устройства.

Для проверки корректности работы зайдите в панель управления устройства:
"System Settings" → "Card Reader" — приложите карту и нажмите "Check". Внизу страницы отображается последний прочитанный серийный номер карты.

## Ручная настройка

Зайдите в панель управления МФУ в браузере: `http://<ip_epson>/` и выполните описанные ниже активацию платформы и настройку аутентификации и прав доступа.

### Активация платформы

В "Epson Open Platform Settings" → "Product Key" введите ключ, полученный при подготовке.

### Настройка аутентификации

В "Epson Open Platform Settings" → "Authentication System" → "Basic" пропишите три ссылки:

- https://<ip_pm>/epson/login?access_token=<printer_app_token>
- https://<ip_pm>/epson/mainmenu?access_token=<printer_app_token>
- https://<ip_pm>/epson/notify?access_token=<printer_app_token>

где `ip_pm` — IP или хостнейм ПринтМенеджера, `printer_app_token` — токен соответствующего МФУ из Личного Кабинета.

### Настройка прав доступа

В "Access Control Settings" → "User Settings" добавьте пользователя `printum` с паролем `printum`. Поставьте все галочки.

## Сброс к заводским настройкам

Сброс выполняется только локально. На панели управления устройства нажмите "Домой", затем:

"Setup" → "System Administration" → "Reset Default Settings" → "Clear All Data and Settings" → "Yes".

## Удаление приложения

Для удаления приложения залейте стандартную прошивку (без поддержки Open Platform).