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

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

- Запросить у технической поддержки Printum программу для Ricoh в формате `printum.zip`.
- Запросить ключ для активации приложения.
- Убедиться, что МФУ опрашивается сетевым агентом.

## Настройка сервера и подключение к ПринтМенеджеру

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

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

Убедитесь, что заполнены следующие поля:
- **Сервер печати** — заполняется автоматически при импорте МФУ в ПринтМенеджер;
- **Идентификатор в CUPS** — заполняется автоматически;
- **Название** — заполняется автоматически;
- **Хост** — заполняется автоматически.

Откройте панель администратора ПринтМенеджера: `https://адрес_сервера:8080/config/constance/config/`

Выберите "Настройка приложения для МФУ RICOH" и введите ключ, полученный у сотрудников поддержки.

> **Важно:** При сохранении ключа убедитесь в его целостности относительно оригинала. Различные программы удалённого подключения могут модифицировать данные ключа при копировании из буфера обмена.

Опция `RICOH_USE_UNLOCK_BY_PASSWD` включена по умолчанию — она активирует режим дополнительной проверки МФУ при подключении к ПринтМенеджеру.

> **Примечание:** Режим дополнительной проверки требует однократного ввода пароля для разблокировки. На практике некоторые модели могут блокироваться повторно в процессе эксплуатации. Чтобы этого избежать, можно отключить эту опцию.

Нажмите "Сохранить".

## Настройка аппарата

Зайдите на веб-интерфейс аппарата с правами администратора (по умолчанию для МФУ Ricoh логин — "admin", пароль — пустой).

Задайте логин и пароль администратора: "Device Management" > "Configuration" > "Device Settings" > "Program/Change Administrator".

Отключите аутентификацию пользователя: "Device Management" > "Configuration" > "Device Settings" > "User Authentication Management" — нажмите "OK".

Проверьте, что включена авторизация администратора.

Настройте параметры SSL и импортируйте сертификат сайта ПринтМенеджера, если необходимо: "Device Management" > "Configuration" > "Security" > "Site Certificate".

Авторизуйтесь на панели управления МФУ с правами администратора и удалите с главного экрана приложения, которые не должны быть доступны неавторизованным пользователям.

Для работы по протоколу HTTPS отключите проверку сертификатов в компоненте WebBrowser NX: "Device Management" > "Configuration" > "Screen" — прокрутите вниз, включите "Сохранить Cookie" и отключите проверку ошибок SSL. Нажмите "Ok" и перезагрузите МФУ.

## Получение параметров картридера

Для регистрации картридера необходимо знать его VID и PID.

## Регистрация картридера

1. Откройте "Device Management" > "Configuration" > "Device Settings" > "Program/Change USB Device List".
2. Добавьте VID:PID нужной модели картридера.
3. Сохраните изменения и перезагрузите устройство, если требуется.

Установка картридера зависит от типа панели управления.

**Панель G2:**
1. Войдите администратором.
2. Запустите "User Tools" из списка установленных приложений.
3. Нажмите "Screen Features".
4. Прокрутите вниз и выберите "Screen Device Settings".
5. Нажмите "IC card Software Settings".
6. Выберите "Proximity Card Reader".
7. Вернитесь назад и нажмите "Proximity Card Reader Settings".
8. МФУ попросит подключить картридер в USB-порт. После подключения появится информация об устройстве.
9. Перезагрузите МФУ.

**Панель G2.5:**
1. Войдите администратором.
2. Запустите "User Tools".
3. "Screen Features" > "Screen Device Settings".
4. Выберите "System Settings" > "Network Interface" > "External Interface Software Settings".
5. Выберите "Proximity Card Reader" из выпадающего списка.
6. Подключите картридер.
7. Нажмите "OK" во всех открытых диалогах.
8. Перезагрузите МФУ с таймаутом перед включением в 10 секунд.

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

1. Откройте Личный кабинет: "Управление" → "Устройства".
2. Выберите нужное устройство, перейдите на вкладку "Настройки" и заполните:
   - Логин — admin
   - Пароль — указанный в настройках устройства
3. Дождитесь синхронизации ПринтМенеджера и Мониторинга или запустите вручную.
4. Нажмите "Приложение не установлено" → "Установить приложение".
5. После завершения установки в консоли выведется пароль. **Сохраните его.**
6. Откройте веб-интерфейс МФУ: "Управление устройством" → "Конфигурация".
7. Найдите раздел "Настр. дополн. функций" и нажмите "Установить".
8. Выберите "Локальный файл" и укажите `printum.zip`.
9. Нажмите "Отобразить список дополнительных функций".
10. В открывшейся таблице выберите "Printum" и нажмите "Установить".
11. На экране устройства появится приложение Printum. Откройте его. При первом запуске потребуется пароль — укажите сгенерированный на шаге 5.

### Установка через консоль

Перед установкой убедитесь, что токен приложения добавлен:
1. Перейдите в панель Мониторинга: "МФУ" → "Настройки МФУ", выберите нужный МФУ.
2. Введите токен приложения.
3. Сохраните изменения.
4. Выполните ручную синхронизацию между Мониторингом и ПринтМенеджером.
5. Убедитесь, что токен появился в ПринтМенеджере.

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

```
cd /opt/printmanager
sudo docker-compose exec app bash
python ./manage.py ricoh_install <id_printer>
```

где `<id_printer>` — "Идентификатор МФУ" в панели ПринтМенеджера.

В результате будет сгенерирован пароль, который необходимо ввести на панели МФУ.

## Приложение по умолчанию

После установки зарегистрируйте приложение как приложение по умолчанию:

1. Авторизуйтесь на панели управления МФУ как администратор (admin без пароля).
2. Запустите "User Tools".
3. "Screen Features" > "Screen Device Settings" > "Function Priority".
4. Выберите нужный вариант и выйдите из системы.
5. Перезагрузите МФУ.

## Настройка драйверов в CUPS

Для корректной работы некоторых моделей требуется настройка драйверов в CUPS. Подробнее — в разделе «Выбор драйвера МФУ в CUPS» руководства администратора.

| Название модели | Драйвер в CUPS |
|----------------|----------------|
| Ricoh MP_C4503 | Ricoh MP C4504 PXL (цветной, дуплексная печать) |