Офіційний каталог функцій Doconut перераховує друк у браузері та експорт у PDF як можливості переглядача. Керування доступом до них все ще вимагає двох окремих рішень: чи Doconut показує відповідну дію і чи хост‑застосунок авторизує цю операцію для поточного користувача та документа.
Для точних контролів, підтримуваних вашою встановленою збіркою, розпочніть з документації Doconut та пакованих прикладів, доступних на офіційній сторінці завантаження Doconut. Не копіюйте ключі конфігурації або вихідний код з несумісної версії чи неперевіреної статті.
1. Спочатку визначте політику друку
Запишіть, хто може друкувати і за яких умов, ще до зміни панелі інструментів. Корисна політика відповідає на такі питання:
- Чи дозволено друк для кожного переглядача, лише певних ролей або конкретних документів?
- Чи залежить рішення від орендаря, статусу справи, класифікації документа або терміну дії?
- Чи потрібен водяний знак на друкованому виході?
- Чи слід аудиту події друку?
- Чи може користувач надрукувати старішу ревізію документа?
- Що має статися, коли дозволи змінюються під час відкритого попереднього перегляду?
Уникайте єдиного глобального булевого значення, коли реальне правило контекстуальне. Моделюйте друк як окрему операцію, щоб її можна було авторизувати незалежно від перегляду та завантаження.
2. Відокремте стан UI від авторизації
Хост‑сторінка може вирішити, чи показувати елемент керування друком, після отримання результату дозволу, що належить застосунку. Це підвищує зрозумілість для користувачів, які не можуть друкувати.
Проте приховування елемента не є межою авторизації. Користувач все ще може викликати відомий кінцевий пункт безпосередньо, повторити попередній запит або ініціювати друк у браузері на видимому вмісті. Кожен серверний маршрут, що генерує друкований вихід, має дотримуватись тієї ж політики.
Використовуйте різні стани в UI:
| Стан | Поведінка переглядача | Поведінка сервера |
|---|---|---|
| Друк дозволений | Показати підтримувану дію друку | Авторизувати та створити запитаний вихід |
| Друк заборонений | Приховати або вимкнути дію з чітким поясненням | Повернути відповідь «заборонено» |
| Політика невідома | Залишити дію недоступною під час завантаження дозволу | Не створювати вихід |
| Сесія закінчилася | Запросити користувача повторно автентифікуватися | Відхилити застарілий запит |
3. Захистіть кінцеву точку друку
Захистіть операцію застосунку, яка викликає друк або повертає друкований вихід. Рішення про авторизацію має враховувати належність до орендаря, власність, класифікацію, стан робочого процесу та ревізію документа. Визначайте документ на сервері, а не приймайте шлях або URL сховища, надані клієнтом.
Якщо ваш застосунок друкує через маршрут, специфічний для переглядача, замість створення PDF, застосуйте ту ж авторизацію перед викликом цього маршруту.
4. Налаштуйте встановлену версію переглядача
Після того, як серверне правило існує, налаштуйте інтерфейс Doconut, використовуючи саме ту опцію, яка задокументована для пакету та зразкових файлів, що постачаються з вашою версією. Онлайн‑демонстрації Doconut дозволяють спостерігати підтримувану поведінку переглядача перед тим, як ви зупинитесь на конкретній інтеграції. Перевірте:
- Де встановлюється параметр: конфігурація сервера, модель представлення або ініціалізація клієнта.
- Чи приховує він елемент панелі інструментів, вимикає дію чи впливає на згенерований вихід.
- Чи застосовується значення до окремого екземпляра переглядача чи глобально.
- Чи є друк і експорт окремими операціями.
- Чи змінила оновлення назву параметра або значення за замовчуванням.
Ставте офіційний зразок за основу правди. Приваблива назва властивості не є достатнім доказом того, що встановлений переглядач її розпізнає.
5. Чесно обробляти друк у браузері
Налаштування переглядача не може гарантувати, що видима інформація ніколи не буде надрукована або захоплена. Браузер може надрукувати сторінку‑хост, а користувачі можуть робити скріншоти або фотографії. Перехоплення клавіатури та CSS, специфічний для друку, можуть покращити очікуваний досвід, проте це легко обходиться на боці клієнта.
Якщо сторінка‑хост не повинна створювати корисну паперову копію, ваш застосунок може використати власне представлення, специфічне для друку, щоб замінити попередній перегляд пояснювальним повідомленням. Тримайте таку поведінку сторінки‑хост окремо від задокументованих елементів керування переглядачем Doconut.
Не описуйте це як захист документа. Використовуйте рендеринг на боці сервера, авторизацію, контрольовані експорти та видимі водяні знаки, коли ваша оцінка ризику вимагає більшого стримування.
6. Тримайте завантаження, експорт та друк окремо
Користувачі та розробники часто розглядають їх як один перемикач «тільки читання», проте вони представляють різні потоки даних:
- View відображає відрендерений вміст.
- Download повертає вихідний файл або інший збережений файл.
- Export створює похідний формат.
- Print створює друковане представлення або викликає друк у браузері.
Авторизуйте кожну операцію явно. Користувач, який не може друкувати, може все ж мати можливість завантажувати, або навпаки. Ваш інструментальний рядок має відображати рішення сервера, а не визначати їх.
7. Додайте корисні аудиторські події
Якщо друк є чутливим, фіксуйте рішення без журналювання самого документа. Подія може включати користувача, орендаря, ідентифікатор документа, ревізію, результат політики, мітку часу та кореляційний ID.
Записуйте як успішні, так і відхилені спроби. Якщо сервіс друку створює тимчасовий файл, також фіксуйте, чи завершено його очищення. Тримайте шляхи до файлів, токени, назви документів, що містять персональні дані, та друкований вміст поза звичайними журналами.
8. Тестуйте поза межами відсутньої кнопки
Інструментальна панель — лише перша перевірка. Додайте тести для всієї операції:
Авторизований користувач
- Очікувана дія друку видима.
- Запит на друк успішний для дозволеного документа.
- Використовується правильна ревізія.
- На згенерованому виводі з’являються необхідні позначки.
- Аудиторська подія фіксує успіх.
Неавторизований користувач
- Дія відсутня або вимкнена.
- Прямий запит до маршруту друку повертає відповідь «заборонено».
- Зміна ID документа не обходить правило.
- URL, скопійований з авторизованої сесії, не може бути використаний неналежним чином.
- Відмова не розкриває, чи інший орендар володіє документом.
Зміни стану
- Дозвіл, відкликаний під час сесії, застосовується до наступного запиту на друк.
- Закінчена сесія не може друкувати.
- Видалений або замінений документ генерує контрольовану помилку.
- Тимчасовий друкований вивід дотримується налаштованого правила зберігання.
Автоматизація браузера може перевіряти видимий стан та код відповіді. Інтеграційні тести мають незалежно перевіряти оцінку політики та авторизацію на рівні документа.
Поширені питання
Чи приховування кнопки друку зупиняє скорочення друку в браузері?
Ні. Це видаляє заплановану дію переглядача лише якщо встановлений переглядач реалізує таку поведінку. Друк у браузері та захоплення екрану потребують окремого розгляду і не можуть бути повністю запобігані кодом на боці клієнта.
Чи слід включати дозвіл на друк у URL перегляду?
Надавайте перевагу рішенню про авторизацію на боці сервера, прив'язаному до автентифікованого користувача, документа та операції. Якщо тимчасове посилання несе дозволи, обмежте його вузько, захистіть від журналів та реферерів і повторно перевіряйте чутливі дії.
Чи достатньо вимкнення друку для конфіденційних документів?
Ні. Це лише один контроль зручності або стримування. Конфіденційні робочі процеси також потребують захисту сховища, авторизації на рівні об’єкта, контрольованих експортів, правил зберігання, моніторингу та прийнятої моделі залишкового ризику.
Висновок
Надійна реалізація контролю друку Doconut починається на сервері і закінчується в інтерфейсі. Визначте політику, захистіть операцію, налаштуйте лише задокументований параметр для вашого встановленого переглядача, поясніть результат користувачам і протестуйте прямі запити, а також видимість інструментальної панелі. Використовуйте офіційну сторінку функцій, документацію, завантаження та демо як джерела реалізації, а не відтворюйте код продукту у статті.