Вступ

В цьому документі описано порядок дій користувача для встановлення  програмного комплексу «Шифр-CaaS», а саме застосування «Агент ЄСКО».

Системні вимоги

Перед початком встановлення та роботи з програмним застосуванням необхідно переконатися, що програмне та апаратне забезпечення відповідає рекомендаціям розробника.
Мінімальні вимоги до апаратного забезпечення:

• Оперативна пам'ять: 512 МБ та вище;
• Процесор – 1,2 ГГц;
• LAN: 10 Мбіт/с.

Мінімальні вимоги до програмного забезпечення:

• Вимоги до ОС:
  • ОС Windows (Windows 7 і вище, Windows Server 2008 R2 з SP1 і вище);
  • ОС Ubuntu, Oracle Linux;
  • MacОS - Catalina (2019), Big Sur (2020), Monterey (2021), Ventura (2022), Sonoma (2023).
• Браузери, що підтримуються:
  • Internet Explorer 11;
  • Mozilla Firefox;
  • Google Chrome;
  • Safari.

Робота із захищеними носіями

Агент Єдиного сервісу криптографічних операцій підтримує роботу із захищеними носіями.

Захищений апаратний носій у пасивному режимі – підтримує збереження особистого ключа у захищеному ключовому контейнері. Доступ до ключа здійснюється за допомогою інтерфейсу PKCS#11.

До таких носіїв відносяться:

• Author Secure Token-338, 337 Series, Author Smart Card-337 Series.
• Plasticard TEllipse 3/4 (обов'язкове встановлення ПЗ).
• ІІТ Алмаз-1К (обов'язкове встановлення ПЗ: EKAlmaz1CInstall.exe (завантажити за посиланням ) та EUInstall.exe (доступне за посиланням), також необхідно перед генерацією ключа ініціалізувати носій у PKCS#11 сумісному режимі).
• ІІТ Кристал-1 (обов'язкове встановлення ПЗ: EKeyCrystal1Install.exe (завантажити за посиланням) та EUInstall.exe (доступне за посиланням), також необхідно перед генерацією ключа ініціалізувати носій у PKCS#11 сумісному режимі).
• Avest AvestKey.
• Efit Key.

Захищений апаратний носій у активному режимі – самостійно здійснює створення ЕП за допомогою особистого ключа у захищеному контейнері. Виконання операції з ЕП здійснюється за допомогою PKCS#11 інтерфейсу.

До таких носіїв відносяться:

• Author Secure Token-338, 337 Series, Author Smart Card-337 Series.
• Plasticard TEllipse 3/4 (обов'язкове встановлення ПЗ).
• ІІТ Алмаз-1К (обов'язкове встановлення ПЗ: EKAlmaz1CInstall.exe (завантажити за посиланням ) та EUInstall.exe (доступне за посиланням), також необхідно перед генерацією ключа ініціалізувати носій у PKCS#11 сумісному режимі).
• ІІТ Кристал-1 (обов'язкове встановлення ПЗ: EKeyCrystal1Install.exe (завантажити за посиланням) та EUInstall.exe (доступне за посиланням), також необхідно перед генерацією ключа ініціалізувати носій у PKCS#11 сумісному режимі).
• Avest AvestKey.
• Efit Key.

Підготовка робочого місця для роботи із застосунком «Агент ЄСКО»

Завантаження файлу дистрибутиву застосунку «Агент ЄСКО»

Для завантаження файлу дистрибутиву необхідно перейти у веб-браузері за посиланням - https://cryptocenter.cipher.com.ua/ до веб-сторінки Клієнта Єдиного сервісу криптографічних операцій, Рис.1. 

Рис. 1. Стартове вікно веб-ресурсу Клієнт ЄСКО

Навести на піктограму відповідної операційної системи, для якої необхідно завантажити дистрибутив (Рис.2) та натиснути на неї. Розпочнеться завантаження файлу дистрибутиву в папку Завантаження.

Рис. 2. Піктограми ОС для завантаження дистрибутиву

Встановлення застосунку «Агент ЄСКО» з дистрибутива

Операційна система Windows

Для інсталяції застосунку для ОС Windows (наведено приклад для ОС Windows 10 x64) необхідно послідовно виконати наступні дії.

Запустити завантажений файл дистрибутиву (наприклад, файл дистрибутиву Agent_UOS_windows-x32_3_0_5-b148.exe) від імені Адміністратора та слідувати підказкам «Майстра установки».

Після появи стартового вікна, необхідно обрати мову та натиснути «ОК».

Рис. 3. Стартове вікно «Майстра установки»

У вікні вітання майстра встановлення застосунку натиснути «Далі», Рис. 4.

Рис. 4. Вітання майстра встановлення застосунку

У наступному вікні обрати пункт «Я приймаю умови угоди» та натиснути «Далі», Рис. 5.

Рис. 5. Вікно ліцензійної угоди

У наступному вікну надається змога налаштувати параметри проксі-сервера, якщо доступ до мережі Інтернет з робочого місця користувача здійснюється за його допомогою. Для цього необхідно натиснути на поле «Потрібне налаштування проксі» та виконати певні налаштування, Рис. 6. 

Якщо доступ до мережі Інтернет з робочого місця користувача здійснюється без використання проксі-сервера, необхідно натиснути «Далі».

Рис. 6. Налаштування параметрів проксі-сервера

Вибір каталогу для інсталяції застосунку (Майстром установки запропонований каталог «за замовчуванням», за необхідності його можна змінити, натиснувши кнопку «Перегляд» та обрати необхідний каталог). Після цього натиснути «Далі», Рис. 7.

Рис. 7. Вибір шляху для встановлення застосунку

Вибір каталогу для розміщення ярликів застосунку (Майстром установки запропонований каталог «за замовчуванням», за необхідності його можна змінити, вказавши назву у відповідному полі). Також є можливість не створювати каталог для розміщення ярликів застосунку, створити ярлики тільки для користувача, який безпосередньо встановлює дистрибутив застосунку на ПК та працює під власним профілем в ОС або для всіх користувачів водночас. Для цього необхідно відмітити відповідні поля, Рис. 8. Після цього натиснути «Далі».

Рис. 8. Вибір шляху для встановлення ярликів застосунку

В наступному вікні є можливість не створювати ярлик для застосунку на робочому столі, для цього необхідно зняти відмітку у відповідному полі. За замовчуванням ярлик створюється. Після чого натиснути «Далі», Рис. 9.

Рис. 9. Налаштування додаткових параметрів ярлика застосунку

Далі починається розпакування та запис файлів на ПК, Рис. 10.

Рис. 10. Процес встановлення застосунку

Після завершення встановлення застосунку є можливість відразу його запустити, для чого необхідно натиснути «Готово», Рис. 11. У разі, коли немає потреби у його запуску необхідно зняти відмітку у відповідному полі.

Рис. 11. Завершення процесу встановлення застосунку

Налаштування роботи у разі наявності проксі-серверу

У випадку, якщо доступ до мережі Інтернет з робочого місця користувача здійснюється за допомогою проксі-сервера, необхідно виконати певні налаштування.

Нижче послідовно розглянуто варіанти налаштувань для різних браузерів.

Системні налаштування проксі в мережі

У відкритому системному вікні «Свойства: Интернет» у вкладці «Подключение» потрібно натиснути «Настройка сети», Рис. 12.

Рис. 12. Системні налаштування мережі

В налаштуваннях параметрів локальної мережі у розділі «Проксі-сервер» зазначити параметри проксі-сервера, що використовується (адресу та порт). Слід вказати опцію «Не использовать прокси-сервер для локальных адресов». Далі у розділі «Проксі-сервер» потрібно натиснути опцію «Дополнительно», Рис. 13.

Рис. 13. Налаштування параметрів локальної мережі

У розділі "Серверы" слід вказати опцію «Один прокси-сервер для всех протоколов» та вказати адреси – виключення у полі «Исключения» (127.0.0.1; local.cipher.kiev.ua; localhost), Рис. 14. Підтвердити зроблені налаштування, натиснувши на конпку "ОК".

Рис. 14. Параметри проксі-сервера

Браузери Google Chrome та Internet Explorer

Для зміни налаштувань проксі-сервера потрібно в браузері Google Chrome обрати розділ «Настройки», пункт «Система» та натиснути «Настройки прокси-сервера», Рис. 15.

Рис. 15 Налаштування браузера Google Chrome

Для браузера Internet Explorer потрібно обрати «Свойства браузера», Рис. 16.

Рис. 16. Налаштування браузера Internet Explorer

Обрані налаштування для обох браузерів є системними. Тому подальший сценарій налаштувань мережі є стандартним для ОС Windows.

Браузер Firefox

Для зміни налаштувань проксі потрібно в браузері Firefox обрати розділ «Налаштування», Рис. 17.

Рис. 17. Налаштування браузера Firefox

Далі послідовно обрати Налаштування: «Налаштування мережі -> Налаштувати», Рис. 18.

Рис. 18. Мережеві налаштування браузера

У вікні «Параметры соединения» в полі «Не использовать прокси для:» потрібно вказати адреси: local.cipher.kiev.ua; 127.0.0.1; localhost, Рис. 19.

Рис. 19. Додаткові параметри з'єднання

Налаштування параметрів проксі-серверу в конфігураційному файлі «Агент ЄСКО»

Для запуску застосування «Агент ЄСКО» з урахуванням проксі-сервера у мережі – потрібно внести зміни в налаштуваннях конфігураційного файлу. Для цього необхідно перейти до директорії, де інстальоване застосування «Агент ЄСКО», скоріше за все шлях буде таким:

C:\Program Files (x86)\Cipher\Agent_UOS\

Знайти файл Agent_UOS.vmoptions, який потрібно відредагувати за допомогою встановленого в ОС Windows текстового редактора Блокнот, Рис. 20.

Рис. 20. Файл налаштувань параметрів проксі-сервера застосування «Агент ЕСКО»

Далі за допомогою текстового редактора необхідно внести відповідні параметри проксі-серверу та зберегти зміни в файлі, Рис. 21.

Рис. 21. Редагування файлу налаштуваннь параметрів проксі-сервера застосування «Агент ЕСКО»

ПРИМІТКА!

Слід зауважити, що перед рядком, в якому вносяться зміни необхідно видаляти знак «решітки» - #, оскільки це є знак коментаря.

Розглянемо детальніше, опис параметрів:

Приклад файлу налаштувань:

Операційна система Linux

Для інсталяції застосунку для ОС Linux (наведено приклад для ОС OracleLinux 9.3 x64) необхідно послідовно виконати наступні дії.

Для встановлення завантаженого дистрибутиву в ОС (наприклад, файл дистрибутиву Agent_UOS_unix-3_0_5-b148.sh), необхідно запустити програму "Термінал" (Ctrl+Alt+T) та в командному рядку ввести команди:

• для здійснення переходу до каталогу, в який був завантажений дистрибутив:

• для запуску процесу інсталяції дистрибутива застосунку:

Після появи стартового вікна, необхідно обрати мову та натиснути «ОК», Рис. 22.

Рис. 22. Стартове вікно «Майстра установки»

Далі необхідно ввести пароль від імені суперкористувача та натиснути «Аутентифікація», Рис. 23.

Рис. 23. Вікно автентифікації суперкористувача

У вікні вітання майстра встановлення застосунку натиснути «Далі», Рис. 24.

Рис. 24. Вітання майстра встановлення застосунку

У наступному вікні обрати пункт «Я приймаю умови угоди» та натиснути «Далі», Рис. 25.

Рис. 25. Вікно ліцензійної угоди

У наступному вікну надається змога налаштувати параметри проксі-сервера, якщо доступ до мережі Інтернет з робочого місця користувача здійснюється за його допомогою. Для цього необхідно натиснути на поле «Потрібне налаштування проксі» та виконати певні налаштування, Рис. 26. 

Якщо доступ до мережі Інтернет з робочого місця користувача здійснюється без використання проксі-сервера, необхідно натиснути «Далі».

Рис. 26. Налаштування параметрів проксі-сервера

Вибір каталогу для інсталяції застосунку (Майстром установки запропонований каталог «за замовчуванням», за необхідності його можна змінити, натиснувши кнопку «Перегляд» та обрати необхідний каталог). Після цього натиснути «Далі», Рис. 27.

Рис. 27. Вибір шляху для встановлення застосунку

В наступному вікні є можливість не створювати ярлик для застосунку на робочому столі, для цього необхідно зняти відмітку у відповідному полі. За замовчуванням ярлик створюється. Після чого натиснути «Далі», Рис. 28.

Рис. 28. Налаштування додаткових параметрів ярлика застосунку

Далі починається розпакування та запис файлів на ПК, Рис. 29.

Рис. 29. Процес встановлення застосунку

Після завершення встановлення застосунку є можливість відразу його запустити, для чого необхідно натиснути «Готово», Рис. 30. У разі, коли немає потреби у його запуску необхідно зняти відмітку у відповідному полі.

Рис. 30. Завершення процесу встановлення застосунку

Ярлик застосунку буде розміщений у загальному списку встановлених в операційній системі програм, Рис. 31.

Рис. 31. Розміщення ярлику застосунку

Операційна система MacOS

Для інсталяції застосунку для MacOS (наведено приклад для MacOS Sonoma 14.4.1) необхідно послідовно виконати наступні дії.

Запустити завантажений файл дистрибутиву (наприклад, файл дистрибутиву Agent_UOS_macos_3_0_5-b148.dmg), Рис. 32. Натискаємо двічі на значку.

Рис. 32. Завантажений файл дистрибутиву застосунку

З'являється вікно, де зазначено про те, що цей дистрибутив з недовіреного джерела, так як він буде завантажений не з App Store, натискаємо «ОК», Рис. 33.

Рис. 33. Вікно-повідомлення про неможливість запустити дистрибутив

Далі необхідно перейти у розділ налаштувань ПК «Privacy&Security» та натиснути на кнопку «Open Anyway», Рис. 34.  

Рис. 34. Вікно налаштувань розділу «Privacy&Security»

Після цього з'явиться вікно, в якому необхідно ввести пароль/відбиток пальця для продовження встановлення, натиснувши «Use Password», Рис. 35.

Рис. 35. Введення паролю/вказівка відбитка пальцю

Повторно з'являється повідомлення про те, що дистрибутив завантажено з недовіреного ресурсу, знову треба погодитися натиснувши «Open», Рис. 36.

Рис. 36. Вікно-повідомлення про встановлення інсталятору з недовіреного ресурсу

Після цього запуститься «Майстер установки».

Після появи стартового вікна, необхідно обрати мову та натиснути «ОК», Рис. 37.

Рис. 37. Стартове вікно «Майстра установки»

У вікні вітання майстра встановлення застосунку натиснути «Далі», Рис. 38.

Рис. 38. Вітання майстра встановлення застосунку

У наступному вікні обрати пункт «Я приймаю умови угоди» та натиснути «Далі», Рис. 39.

Рис. 39. Вікно ліцензійної угоди

У наступному вікну надається змога налаштувати параметри проксі-сервера, якщо доступ до мережі Інтернет з робочого місця користувача здійснюється за його допомогою. Для цього необхідно натиснути на поле «Потрібне налаштування проксі» та виконати певні налаштування, Рис. 40. 

Якщо доступ до мережі Інтернет з робочого місця користувача здійснюється без використання проксі-сервера, необхідно натиснути «Далі».

Рис. 40. Налаштування параметрів проксі-сервера

Вибір каталогу для інсталяції застосунку (Майстром установки запропонований каталог «за замовчуванням», за необхідності його можна змінити, натиснувши кнопку «Перегляд» та обрати необхідний каталог). Після цього натиснути «Далі», Рис. 41.

Рис. 41. Вибір шляху для встановлення застосунку

В наступному вікні є можливість не створювати ярлик для застосунку на робочому столі, для цього необхідно зняти відмітку у відповідному полі. За замовчуванням ярлик створюється. Після чого натиснути «Далі», Рис. 42.

Рис. 42. Налаштування додаткових параметрів ярлика застосунку

Далі починається розпакування та запис файлів застосунку на ПК, Рис. 43.

Рис. 43. Процес встановлення застосунку

Після завершення встановлення застосунку є можливість відразу його запустити, для чого необхідно натиснути «Готово», Рис. 44. У разі, коли немає потреби у його запуску необхідно зняти відмітку у відповідному полі. 

Рис. 44. Завершення процесу встановлення застосунку

Ярлик застосунку буде розміщений у створеному для застосунку каталогу, Рис. 45.

Рис. 45. Розміщення ярлику застосунку

Робота з Клієнтом Єдиного сервісу криптографічних операцій

Запуск та початок роботи

У веб-браузері перейти за посиланням - https://cryptocenter.cipher.kiev.ua/ до веб-сторінки Клієнта Єдиного сервісу криптографічних операцій.

Покрокова інструкція та ознайомлення з інтерфейсом програмного комплексу:

• Стартове вікно Клієнту Єдиного сервісу криптографічних операцій у веб-браузері наведено на Рис. 46.

Рис. 46. Стартове вікно Клієнта ЄСКО

• Наступним кроком слід запустити застосунок «Агент ЄСКО», натиснувши на ярлик на робочому столі або запустити його, обравши зі списку встановлених на ПК програм, Рис. 47.

Рис. 47. Запуск застосунку «Агент ЄСКО»

• Далі відкривається вікно Агенту Єдиного сервісу криптографічних операцій. Це означає що застосунок «Агент ЄСКО» запущений, все працює коректно. Його слід згорнути та повернутися до веб-браузера, Рис. 48.

Рис. 48. Вікно застосунку «Агент Єдиного сервісу криптографічних операцій»

• У веб-сторінці одразу помітні зміни. Статус Агенту ЄСКО змінено на «Підключено» та став доступний для змін пункт «Тип ключа», Рис. 49.

Рис. 49. Стартове вікно веб-сторінки Клієнта Єдиного сервісу криптографічних операцій

Після виконання вищезазначених дій можна переходити до роботи з Клієнтом Єдиного сервісу криптографічних операцій:

• На вкладці «Особистий ключ» у розділі «Параметри сесії» слід вказати у хвилинах період активації ключа, за замовчуванням 15 хв.
• На вкладці «Особистий ключ» у розділі «Параметри ключа» слід вказати АЦСК/КНЕДП, у якому було отримано ключ.
• На вкладці «Тип ключа» необхідно обрати:

1. файл на диску;
2. PKCS#11 пристрої – активний режим (для роботи із захищенним носієм);
3. PKCS#11 пристрої – пасивний режим (для роботи із захищенним носієм).

• Заповнити поле Шлях до контейнеру (для роботи з файловим контейнером - обрати шлях до нього; для роботи з захищеним носіієм - обрати необхідний носій).
• Ввести Парольдо ключа чи PIN до захищеного носія, Рис. 50.

Рис. 50. Заповнення розділу «Параметри ключа»

• Після заповнення всіх полів, слід натиснути кнопку «Розпочати роботу з ключем» та одразу створюється криптографічний контекст, де відкривається робоча область, в якій стають доступні всі функції та операції Клієнта ЄСКО, Рис. 51.

Рис. 51. Робоча область Клієнта ЄСКО

Для більш детального ознайомлення щодо порядку роботи веб-ресурсу Клієнт Єдиного сервісу криптографічних операцій необхідно перейти за посиланням.