# Установка встроенного приложения на 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` включена по умолчанию — она активирует режим дополнительной проверки МФУ при подключении к ПринтМенеджеру.

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

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

## Сброс аппарата к заводским настройкам
1. Авторизуйтесь на МФУ под учетной записью администратора.
2. Перейдите в меню "Инструменты пользователя" → "Функции аппарата".
3. Откройте раздел "Параметры системы" → "Инстр.адм.".
4. На третьей странице выберите "Стереть всю память" → "Форматирование" → "Стирание" → "Да".
6. Во время выполнения процедуры МФУ может несколько раз автоматически перезагрузиться.
7. После завершения сброса на экране появится окно для задания паролей супервизора и администратора.
8. Задайте необходимые пароли или оставьте поля пустыми, если установка паролей не требуется.

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

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

Задайте логин и пароль администратора: "Управление устройством" → "Конфигурация" → "Настройка устройства" → "Программировать/изменить администратора".

Отключите аутентификацию пользователя: "Управление устройством" → "Конфигурация" → "Настройка устройства" → "Управление аутентификацией пользователя" — нажмите "OK".

Проверьте, что включена авторизация администратора. Зайдите в "Управление устройством" → "Конфигурация" → "Настройка устройства" → "Управление аутентификацией администратора" и поставьте настройку "Аутентификация администратора пользователя" в состояние включено.

Настройте параметры SSL и импортируйте сертификат сайта ПринтМенеджера, если необходимо: "Управление устройством" → "Конфигурация" → "Безопасность" → "Сертификат сайта".

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

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

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

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

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

1. Откройте "Управление устройством" → "Конфигурация" → "Настройка устройства" → "Программировать/Изменить список устройств USB".
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".
4. Прокрутите вниз и выберите "Screen Device Settings".
5. Выберите "System Settings" → "Network Interface" → "External Interface Software Settings".
6. Выберите "Proximity Card Reader" из выпадающего списка.
7. Подключите картридер.
8. Нажмите "OK" во всех открытых диалогах.
9. Перезагрузите МФУ с таймаутом перед включением в 10 секунд.

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

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

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

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

> **Примечание:** пример токена, который можно использовать – `1a1d743c-6ca1-4510-b620-515132101db6`

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

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

где `<id_printer>` — идентификатор принтера в панели ПринтМенеджера → "Управление печатью" → "Принтеры".

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

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

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

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

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

Для корректной работы некоторых моделей требуется настройка драйверов в CUPS. Драйвер для устройства назначается в Лчином Кабинете → "Управление" → "Устройства", после раскрытия устройства перейдите на вкладку "Драйвер".

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