Цифровий підпис Українська

Help

For version 0.1.0. Button and screen names are given as in the English interface; signature level labels are given in Ukrainian, as the app shows them, with an explanation.

1. What you need

2. Supported key files

FileWhat it isNotes
Key-6.datIIT key container (both variants)Holds two keys; the app picks the signing key from the certificate. The file usually contains no certificate.
.pfx, .p12PKCS#12Protected with GOST 28147, DSTU 7624 (Kalyna) or AES.
.pk8Encrypted PKCS#8The certificate has to be looked up or imported separately.
.jksPrivatBank key storeUsually contains the certificate.

Not supported: .zs2, .sk and other unknown formats; hardware tokens, the ID card and cloud keys; electronic seal keys (the app says that electronic seals are not supported yet).

If a certificate says that its key is held in a qualified signature creation device (a protected token) but you import the key from a file, the app refuses: such a file should not exist. See If your key is compromised.

3. Importing a key

  1. Set a screen lock if you have none: Android settings → Security → Screen lock.
  2. In the app open Keys → Add key and choose the key file in the file picker.
  3. Enter the key password: the one set when you received the key from your provider. It is not the phone’s PIN.
  4. The certificate. If the file contains it, the app takes it from there. If not, the app asks for permission to contact your provider’s certificate lookup service (HTTPS only). If the provider has no such service over HTTPS, the app shows the provider’s page where you can download your certificate (.cer or .crt), and you import it in the same step.
  5. The app checks the certificate chain and that the key really matches the certificate.
  6. Choose the protection: the key password (always) and, if you like, your fingerprint.
  7. The key appears in the list with its signature level, owner, provider and validity.

Keep the original key file somewhere off the phone. The app keeps neither the file nor the password, and keys are excluded from Android backups and are not moved to a new phone. The original file is your backup: you need it to import the key on a new phone or after the screen lock is turned off.

If you enter a wrong key password when signing, the app shows how many attempts are left from the 5th mistake. After the 10th, the password-protected copy of the key is deleted: you can then sign only with your fingerprint (if you turned it on), and to use the password again you have to import the key from its file.

4. Signature levels: УЕП and КЕП

The Law of Ukraine “On Electronic Identification and Electronic Trust Services” distinguishes several kinds of electronic signature. A qualified electronic signature (КЕП) can only be made with a qualified signature creation device: a protected device that holds the private key, such as a hardware token or a qualified provider’s cloud service. A key file on a phone is not such a device, whatever software library the app uses. A signature made with a key file and a qualified certificate is therefore «УЕП на кваліфікованому сертифікаті», and the app never calls it КЕП.

Label in the appMeaningThe app
«КЕП»qualified electronic signatureverifies; does not create
«УЕП на кваліфікованому сертифікаті»advanced electronic signature based on a qualified certificate for electronic signatures (Law 2155-VIII, Art. 1 item 59)verifies; creates it from a key file, the highest level it creates
«Удосконалений ЕП (сертифікат не кваліфікований)»advanced electronic signature with a certificate that is not qualifiedverifies
«Електронний підпис»electronic signature without the features of an advanced oneverifies
«Електронна печатка»electronic seal of a legal entityverifies only

When only КЕП will do

Other public authorities and officials may use УЕП on a qualified certificate. Cabinet of Ministers Resolution No. 1298 also accepts it for electronic public services unless a law requires КЕП. Whether a particular recipient accepts your signature depends on their requirements; if in doubt, ask in advance.

This help explains the levels in general terms and is not legal advice.

5. Signing

  1. Tap Open on the home screen, or send a file to Цифровий підпис from another app.
  2. After an unsigned file has been checked, tap Sign. For a package of unsigned files, tap Sign all.
  3. The app checks the certificate online and shows the review screen.
  4. Check what you are signing, then confirm with your fingerprint, or with the key password together with the screen lock.
  5. Save the result or share it.

6. Verifying signatures

From the verification result you can save the report as PDF or print it through Android. The report contains the verification details and the file name and hash; it does not include the document itself. This is the app’s report, not a qualified validation.

7. Network use and consent

Before its first network request the app shows a consent screen with “Allow” and “Don’t allow”. What is sent:

Documents, keys and passwords are never sent. Requests to some status and time-stamping services use plain HTTP because that is how those services work (the others get HTTPS); their answers are signed and the app checks them. Details are in the privacy policy.

Settings → “Verification and network”: online checks “Always”, “Ask” or “Never” (if no mode has been chosen, the default is “Always” with current recorded consent allowed, and “Ask” otherwise), mobile data on or off, and the trust data version, date and update. Signing always needs a status check and a time stamp; if the setting or a mobile network prevents them, the app explains this before signing and offers a one-time check.

8. The screen lock and your keys

9. Troubleshooting

Wrong password

Certificate not found

Provider unreachable

Wrong date or time

Other messages

10. If your key is compromised

A key is compromised if the key file or its password may have reached someone else: the phone or a storage device was lost or stolen, someone knows the password, or signatures appeared that you did not make.

  1. Stop signing with this key.
  2. Tell the provider (КНЕДП) that issued the certificate without delay, and ask them to block or revoke the certificate. The app shows the provider’s contacts under Keys → the key → Key compromised; they are also on the provider’s website and in the list of providers on czo.gov.ua. How to do it (by phone, in an online account or in person) depends on the provider.
  3. Delete the key from the app (Keys → the key → Delete) and from other devices.
  4. Get a new key and certificate from your provider.
  5. Review documents signed after the possible compromise and tell the other parties if needed.

If your phone is lost: the key in the app is protected by the screen lock and the key password or your fingerprint, but still tell your provider, because the key file may exist elsewhere. You can erase the phone remotely with Google’s device finder (android.com/find); the imported keys are then destroyed.

Your duty under the law. Article 12 of the Law of Ukraine “On Electronic Identification and Electronic Trust Services” requires people who use electronic trust services to keep the private key secret, to tell their provider without delay about a suspected or actual compromise of the key, and not to use a key that is compromised or whose certificate is revoked or blocked.

Only the provider can block or revoke a certificate; StalkerSoft cannot.

11. Support