Довідка
1. Що потрібно
- Телефон з Android 14 або новішим.
- Щоб перевірити підпис, потрібен лише підписаний файл; ключ не потрібен.
- Щоб підписувати: файл ключа і пароль до нього від Вашого кваліфікованого надавача електронних довірчих послуг (КНЕДП), увімкнене блокування екрана (PIN-код, графічний ключ або пароль) та інтернет.
2. Підтримувані файли ключів
| Файл | Що це | Примітка |
|---|---|---|
Key-6.dat | Контейнер ключа формату ІІТ (обидва різновиди) | Містить два ключі; для підпису застосунок обирає потрібний за сертифікатом. Сертифіката у файлі зазвичай немає. |
.pfx, .p12 | PKCS#12 | Захист ГОСТ 28147, ДСТУ 7624 «Калина» або AES. |
.pk8 | Зашифрований PKCS#8 | Сертифікат потрібно знайти або імпортувати окремо. |
.jks | Сховище ключів ПриватБанку | Сертифікат зазвичай уже всередині. |
Не підтримуються: файли .zs2, .sk та інші невідомі формати; захищені носії (токени, ID-картка) і хмарні ключі; ключі електронних печаток («Електронні печатки поки не підтримуються»).
Якщо сертифікат зазначає, що ключ зберігається в засобі КЕП (на захищеному носії), а Ви імпортуєте його з файлу, застосунок відмовить: такого файлу не мало б існувати. Дивіться «Ключ скомпрометовано».
3. Як імпортувати ключ
- Увімкніть блокування екрана, якщо його ще немає: налаштування Android → «Безпека» → «Блокування екрана».
- У застосунку відкрийте «Ключі» → «Додати ключ» і виберіть файл ключа у вікні вибору файлів.
- Введіть пароль ключа — той, що Ви встановили під час отримання ключа в надавача. Це не PIN-код телефона.
- Сертифікат. Якщо він є у файлі, застосунок візьме його звідти. Якщо ні — попросить дозволу звернутися до служби пошуку сертифікатів Вашого надавача (лише через HTTPS). Якщо надавач не має такої служби з HTTPS, застосунок покаже сторінку надавача, де можна завантажити сертифікат (
.cerабо.crt), і Ви імпортуєте його в цьому ж кроці. - Застосунок перевіряє ланцюжок сертифіката і те, що ключ справді відповідає сертифікату.
- Оберіть захист: пароль ключа (завжди) і, за бажанням, відбиток пальця.
- Ключ зʼявиться у списку з рівнем підпису, імʼям із сертифіката, надавачем і строком дії.
Збережіть оригінальний файл ключа поза телефоном. Застосунок не зберігає ні файл, ні пароль, а ключі не потрапляють у резервні копії Android і не переносяться на новий телефон. Оригінальний файл — Ваша резервна копія: він потрібен, щоб імпортувати ключ на новому телефоні або після вимкнення блокування екрана.
Якщо під час підписання пароль ключа введено неправильно, від 5-ї помилки застосунок показує, скільки спроб лишилося. Після 10-ї копію ключа під паролем буде видалено: підписувати можна буде лише відбитком пальця (якщо його ввімкнено), а щоб знову користуватися паролем, ключ потрібно імпортувати з файлу повторно.
4. Рівні підпису: УЕП і КЕП
Закон України «Про електронну ідентифікацію та електронні довірчі послуги» розрізняє кілька видів електронного підпису. Кваліфікований електронний підпис (КЕП) створюється лише засобом КЕП — захищеним пристроєм, у якому зберігається особистий ключ: захищеним носієм або хмарним сервісом кваліфікованого надавача. Файл ключа на телефоні таким засобом не є, хоч би яку бібліотеку використовував застосунок. Тому підпис файловим ключем на кваліфікованому сертифікаті — це УЕП на кваліфікованому сертифікаті, і застосунок ніколи не називає його КЕП.
| Позначка в застосунку | Що означає | Застосунок |
|---|---|---|
| «КЕП» | кваліфікований електронний підпис | перевіряє; не створює |
| «УЕП на кваліфікованому сертифікаті» | удосконалений електронний підпис, що базується на кваліфікованому сертифікаті електронного підпису | перевіряє; створює з файлового ключа — найвищий рівень, який він створює |
| «Удосконалений ЕП (сертифікат не кваліфікований)» | удосконалений підпис на сертифікаті, що не є кваліфікованим | перевіряє |
| «Електронний підпис» | електронний підпис без ознак удосконаленого | перевіряє |
| «Електронна печатка» | печатка юридичної особи | лише перевіряє |
Де потрібен саме КЕП
- Правочини, що потребують нотаріального посвідчення або державної реєстрації (частина шоста статті 17 Закону).
- Реєстраційні дії державних реєстраторів і нотаріусів, а також підписи вищих посадових осіб, перелічених у частині другій статті 17 Закону.
Інші органи влади й посадові особи можуть використовувати УЕП на кваліфікованому сертифікаті. Постанова Кабінету Міністрів України № 1298 допускає його й для електронних публічних послуг, якщо закон не вимагає саме КЕП. Чи прийме конкретний отримувач Ваш підпис, залежить від його вимог; якщо сумніваєтеся, уточніть заздалегідь.
5. Підписання
- «Відкрити» на головному екрані або передайте файл у «Цифровий підпис» з іншого застосунку.
- Після перевірки непідписаного файлу натисніть «Підписати». Для пакета непідписаних файлів — «Підписати все».
- Застосунок перевіряє сертифікат онлайн і показує екран перегляду.
- Перевірте, що саме підписуєте, і підтвердьте відбитком пальця або паролем ключа разом із блокуванням екрана.
- Збережіть результат або поділіться ним.
- Результат базового підписання. Один непідписаний файл, зокрема PDF або XML, або пакет 2–29 непідписаних файлів зберігається в одному контейнері ASiC-E з підписом XAdES і позначкою часу B-T. Вміст вхідних файлів у контейнері не змінюється.
- Екран перегляду показує сторінки PDF або назву, тип і розмір файлу; хеш SHA-256; імʼя з сертифіката, організацію, частково прихований податковий номер, надавача і строк дії; формат, рівень і службу позначок часу. Якщо в PDF є коментарі, заповнені поля, вкладені файли, скрипти чи попередні зміни, застосунок перелічить їх і попросить окремого підтвердження.
- Одне підтвердження стосується лише файлів на екрані перегляду. Перед тим як віддати результат, застосунок перевіряє створений підпис; якщо перевірка не пройшла, результат не видається.
- Обмеження базового підписання: до 29 файлів, до 32 МіБ на кожен документ; готовий контейнер — до 32 МіБ. Сукупний розмір вмісту також перевіряється під час підготовки.
6. Перевірка підписів
- «Відкрити» → файл
.p7s,.asice,.asics, підписаний PDF або XML. Для відокремленого підпису.p7sпотрібен також оригінальний файл. - Результат — «перевірено застосунком» з рівнем підпису. Це власна перевірка застосунку, а не кваліфікована. Кваліфіковану перевірку надає кваліфікований надавач; застосунок дає посилання «Перевірити на порталі ЦЗО».
- Без онлайн-перевірки (налаштування «Ніколи» або немає мережі) результат спирається лише на дані у файлі, і застосунок про це повідомляє.
На екрані результату перевірки можна зберегти як PDF або надрукувати через системний екран Android. Звіт містить дані перевірки, назву й хеш файлу; сам документ до нього не додається. Це звіт застосунку, а не кваліфікована перевірка.
7. Мережа і згода
Перед першим мережевим запитом застосунок показує екран згоди з кнопками «Дозволити» і «Не дозволяти». Що надсилається:
- серійні номери сертифікатів і дані їхніх видавців — службам статусу (OCSP, CRL) надавача, що видав сертифікат;
- ідентифікатори ключа — службі пошуку сертифікатів надавача (лише HTTPS), якщо у файлі ключа немає сертифіката;
- хеш, похідний від документа і його підпису, — службі позначок часу;
- запити довірчих даних — на czo.gov.ua.
Документи, ключі й паролі не надсилаються ніколи. Запити до частини служб статусу й позначок часу йдуть звичайним HTTP, бо так працюють ці служби (до решти — через HTTPS); їхні відповіді підписані, і застосунок їх перевіряє. Докладно — у політиці конфіденційності.
«Налаштування» → «Перевірка і мережа»: онлайн-перевірки «Завжди», «Питати» або «Ніколи» (якщо режим ще не вибрано, за чинного збереженого дозволу типовим є «Завжди», в інших випадках — «Питати»), дозвіл на мобільні дані, версія й дата довірчих даних та їх оновлення. Підписання завжди потребує перевірки статусу і позначки часу; якщо налаштування чи мобільна мережа заважають, застосунок пояснить це до підписання і запропонує одноразову перевірку.
8. Блокування екрана і ключі
- Імпорт вимагає блокування екрана: імпортовані ключі захищає Android Keystore, а він привʼязаний до блокування екрана.
- Якщо вимкнути блокування екрана або його буде примусово скинуто (наприклад, адміністратором пристрою), Android знищує ключі Keystore, що захищають імпортовані ключі, і ті стають непридатними. У списку ключів зʼявиться «Потрібен повторний імпорт з файлу ключа» — імпортуйте ключ з оригінального файлу. Скидання телефона до заводських налаштувань теж видаляє все.
- Зміна PIN-коду, графічного ключа чи пароля без вимкнення блокування ключів не знищує.
- Якщо додати в налаштуваннях Android новий відбиток пальця або видалити всі відбитки, перестане діяти лише копія ключа під відбитком; підписувати можна далі за паролем ключа. Щоб знову підписувати відбитком, увімкніть його для ключа в розділі «Ключі» і підтвердьте паролем ключа. Перед цим видаліть у налаштуваннях Android відбитки, яких Ви не знаєте: підписувати зможе кожен відбиток, зареєстрований на той момент.
9. Усунення проблем
Неправильний пароль
- Введіть пароль саме цього файлу ключа — той, що встановлено під час отримання ключа в надавача. Це не PIN-код телефона і не PIN захищеного носія.
- Перевірте розкладку клавіатури (українська чи англійська) і регістр: пароль чутливий до великих і малих літер.
- Переконайтеся, що обрано правильний файл: надавач міг видавати Вам ключі в різний час.
- Під час підписання діє ліміт спроб — дивіться імпорт ключа.
Сертифікат не знайдено
- У більшості файлів ключів сертифіката немає; застосунок шукає його в службі надавача через HTTPS. Дозвольте мережеві запити на екрані згоди.
- Якщо служба недоступна або надавач не підтримує HTTPS, завантажте свій сертифікат (
.cerабо.crt) із сайту надавача — посилання покаже застосунок — та імпортуйте його в тому ж кроці. - Сертифікат має відповідати саме цьому ключу: до нового ключа потрібен новий сертифікат.
- Сертифікатом, строк дії якого минув, підписувати не можна; зверніться до надавача, щоб отримати новий.
Надавач недоступний
- Перевірте інтернет і «Налаштування» → «Перевірка і мережа»: чи не обрано «Ніколи» і чи дозволено мобільні дані.
- Деякі мережі (корпоративні, публічні Wi-Fi, VPN) блокують звичайний HTTP, яким працює частина служб статусу і позначок часу. Спробуйте іншу мережу.
- Служба надавача може бути тимчасово недоступна — спробуйте пізніше.
- Без статусу сертифіката застосунок не підписує: постанова Кабінету Міністрів України № 1298 забороняє підписання, якщо статус не вдалося отримати. Перевірка підписів у такому разі покаже, що статус онлайн не перевірено.
- Якщо застосунок повідомляє, що адреса служби змінилася і потрібне оновлення, оновіть його в Google Play.
Неправильні дата або час
- Застосунок порівнює час телефона з часом служб надавача і позначок часу. Якщо різниця більша за 5 хвилин, підписання зупиняється з повідомленням «Неправильні дата або час на телефоні».
- Увімкніть автоматичні дату, час і часовий пояс: налаштування Android → «Система» → «Дата й час». Потім повторіть підписання.
Інші повідомлення
- «Електронні печатки поки не підтримуються» — ключ печатки організації в цій версії імпортувати не можна.
- Ключ із захищеного носія у файлі — дивіться «Ключ скомпрометовано».
- Файл завеликий — дивіться обмеження в розділі «Підписання».
- Підписання вимкнено, бо довірчі дані старші за 180 днів або вийшло критичне оновлення, — оновіть застосунок у Google Play.
10. Ключ скомпрометовано
Ключ вважається скомпрометованим, якщо файл ключа або пароль міг потрапити до інших людей: телефон чи носій втрачено або викрадено, хтось знає пароль, зʼявилися підписи, яких Ви не створювали.
- Не підписуйте цим ключем.
- Невідкладно повідомте надавача (КНЕДП), що видав сертифікат, і попросіть заблокувати або скасувати сертифікат. Контакти надавача показує застосунок: «Ключі» → ключ → «Ключ скомпрометовано»; вони є також на сайті надавача і в переліку надавачів на czo.gov.ua. Способи — телефоном, в електронному кабінеті чи особисто — залежать від надавача.
- Видаліть ключ із застосунку («Ключі» → ключ → «Видалити») та з інших пристроїв.
- Отримайте в надавача новий ключ і сертифікат.
- Перегляньте документи, підписані після можливої компрометації, і за потреби повідомте контрагентів.
Якщо втрачено телефон: ключ у застосунку захищений блокуванням екрана і паролем ключа або відбитком пальця, але все одно повідомте надавача, бо файл ключа міг зберегтися деінде. Телефон можна стерти віддалено через сервіс Google для пошуку пристроїв (android.com/find); тоді імпортовані ключі буде знищено.
Ваш обовʼязок за законом. Стаття 12 Закону України «Про електронну ідентифікацію та електронні довірчі послуги» зобовʼязує тих, хто користується електронними довірчими послугами, зберігати особистий ключ у таємниці, невідкладно повідомляти надавача про підозру чи факт компрометації ключа і не використовувати ключ, якщо його скомпрометовано або сертифікат скасовано чи заблоковано.
Заблокувати або скасувати сертифікат може лише надавач; StalkerSoft цього зробити не може.
11. Підтримка
- support@stalkersoft.com — відповідаємо протягом 3 робочих днів. Напишіть версію застосунку (розділ «Довідка» в застосунку), модель телефона і версію Android, що Ви робили і код помилки; можна додати файл діагностики — у ньому немає документів, імен і ключів.
- Не надсилайте нам файлів ключів, паролів і документів.
- Вразливості — на security@stalkersoft.com, отримання підтверджуємо протягом 48 годин. Дивіться сторінку Безпека.
- На відгуки в Google Play відповідаємо щотижня.