Подписание протоколов в приложении Android
Нативная подпись Android работает в установленном приложении с доступным криптографическим компонентом. В приложении используется путь ProSign с JCSP и предусмотренным выбором JaCarta/Rutoken. Обычная страница в мобильном браузере не включает этот механизм автоматически. Заранее проверьте конкретное устройство, модель носителя, доступ к своему ключу и привязку сертификата.
| Что встречается в инструкции | Что это значит |
|---|---|
| Нативное приложение | Установленная сборка TesLab, которая может обращаться к компонентам Android. |
| ProSign | Используемый приложением путь к криптографическому компоненту и поддерживаемому носителю. |
| Проверка сервером | Заключительная проверка переданной подписи. Локальный успех на телефоне её не заменяет. |
В этой статье
Подготовка устройства
- Используйте установленную поддерживаемую сборку TesLab для Android, предоставленную вашей лабораторией.
- Заранее проверьте совместимость конкретного носителя, способа подключения и устройства с ответственным за рабочие места ЭЦП.
- Подготовьте свой действующий сертификат и доступ к соответствующему ключу.
- Проверьте состояние лицензии криптографического компонента.
- Войдите в приложение под своей учётной записью и проверьте привязку сертификата.
- Обеспечьте устойчивую сеть и достаточный заряд на время обработки документов.
Не считайте поддержку семейства носителей гарантией для любой модели и любого телефона. Важен весь комплект: устройство, способ подключения, носитель, установленная сборка и доступный ключ. Проверить этот комплект нужно до момента срочного подписания большого пакета.
Первое обращение к сертификатам
- Подключите подготовленный носитель предусмотренным для него способом.
- Откройте действие электронной подписи в профиле или готовом к подписи протоколе.
- Прочитайте системные запросы доступа к устройству или ключу и предоставьте необходимые разрешения для выбранного носителя.
- При вопросе «Какой токен Вы используете?» выберите «JaCarta» или «RuToken» по фактическому носителю.
- Если тип неизвестен, вариант «Не знаю» запускает поиск по предусмотренным вариантам. Такой поиск может занять больше времени.
- Дождитесь списка сертификатов. Проверьте владельца, срок и идентификатор своего сертификата.
Выбор типа носителя запоминается на устройстве. Если впоследствии используется другое семейство токенов, прежний выбор может мешать поиску. Проверьте доступную настройку смены носителя или обратитесь к ответственному, не заменяя привязку сертификата на случайный найденный вариант.
Лицензия КриптоПро
Перед перечислением сертификатов программа проверяет состояние лицензии JCSP. При неактивной или истёкшей лицензии может открыться окно «Лицензия КриптоПро» с предложением ввести серийный номер.
- Сверьте показанное состояние лицензии.
- Если требуется активация, получите подходящий лицензионный номер по принятому в лаборатории порядку.
- Введите номер в предназначенное для него поле и дождитесь результата.
- При отказе прочитайте сообщение и код. Повторный ввод того же неподходящего номера не исправляет причину.
Лицензионный номер криптокомпонента, серийный номер сертификата и PIN носителя имеют разное назначение. Не вводите PIN в поле лицензии. Отмена активации может остановить дальнейшее действие подписи.
Привязка сертификата в приложении
В личном кабинете откройте «Электронная подпись». Выберите действие привязки или «Загрузить новую подпись», если сертификат перевыпущен. После получения списка явно подтвердите нужный сертификат.
Программа использует выбранный ключ для служебного подтверждения и регистрирует привязку на сервере. Дождитесь сообщения «Сертификат привязан» или «Сертификат заменён». Затем снова откройте сведения и проверьте результат.
Сертификат, уже привязанный через компьютер, не копируется на Android вместе с профилем. Привязка задаёт идентификатор, а сам ключ должен быть доступен мобильному криптографическому компоненту. Если носитель отсутствует, приложение не может подписать документ только по сохранённой серверной привязке.
Выбор протоколов
- Откройте журнал и получите документы «На подпись» либо откройте конкретный утверждённый протокол.
- Проверьте, что вы назначены ожидаемым подписантом.
- Откройте «Подписание протоколов ЭЦП».
- У каждой выбранной строки сверьте номер, дату и адрес.
- Скачайте и просмотрите печатные формы. Удалите из выбора документы, которые требуют доработки или ещё не проверены.
- Отметьте подтверждение просмотра всех подписываемых документов.
Небольшой экран не отменяет проверку содержимого. Если таблицы невозможно уверенно прочитать на телефоне, заранее используйте удобное устройство для просмотра соответствующих документов, а перед подписанием убедитесь в правильности актуального набора и версии.
Выполнение подписи
- Нажмите «Подписать» и проверьте сертификат, если открылось окно выбора.
- При запросе PIN или доступа подтвердите операцию собственным ключом.
- Дождитесь серверной подготовки. Затем программа последовательно подпишет документы выбранного набора.
- Не отключайте носитель во время операции и следите за запросами, которые могут появиться поверх приложения.
- Прочитайте итоговое количество успешных и ошибочных документов.
- После отправки дождитесь серверной проверки и проверьте отметки в карточке.
Состав набора во время выполнения блокируется. Передача приложения в фон, потеря сети, отключение носителя или закрытие окна могут прервать остаток обработки. Уже принятые сервером подписи автоматически не отменяются.
Результат и частичные ошибки
| Состояние | Значение |
|---|---|
| Подготовка документов | Сервер ещё готовит материалы; подпись по всему набору не завершена. |
| Подписывается | В данный момент обрабатывается конкретная строка. |
| Подписано в окне операции | Подпись передана серверу; затем проверяется её принятие. |
| Проверка подписи | Окончательный результат ещё ожидается. |
| Подписано ЭЦП в карточке участника | Положительный результат для этого подписанта. |
| Ошибка | Откройте пояснение и устраните причину перед повтором. |
Если часть документов не подписалась, обновите состояние и повторите действие для нужного остатка. Общая статья о личной ЭЦП подробно объясняет серверную проверку и состав участников.
Если сертификаты не находятся
- Убедитесь, что используется Android-приложение с ProSign, а не обычная вкладка мобильного браузера.
- Проверьте подключение носителя, системное разрешение и выбранное семейство токена.
- Проверьте состояние лицензии и наличие нужного сертификата с ключом.
- Если профиль ограничивает выбор привязанным сертификатом, подключите именно его носитель или выполните обоснованную замену после перевыпуска.
- При ошибке PIN или криптографического компонента прочитайте точное сообщение и действуйте по порядку поддержки носителя.
Для диагностики сообщите модель устройства и носителя, сборку приложения, этап, текст и код ошибки. Не отправляйте PIN и закрытый ключ. Если носитель распознаётся, но сервер отклоняет подпись из-за СНИЛС или назначения участника, решать нужно сведения и полномочия, а не переустановку драйвера.
Работа без интернета
Локально заполненный протокол можно подготовить к дальнейшей передаче после восстановления сети, но описанный процесс подписи требует сервера. Сначала отправьте очередь, проверьте актуальные результаты, выполните утверждение по установленному порядку и только затем подписывайте.
Подготовка полевых протоколов описана в инструкции для работы без интернета, а проверка отправки очереди в статье о синхронизации.
Вернуться к оглавлению руководства специалиста ИЛ.
Подготовить телефон до работы с документами
- Используйте установленную сборку, принятую в организации, и проверьте совместимость конкретного носителя с устройством.
- Войдите под своей учётной записью, обеспечьте сеть и заряд, подключите носитель предусмотренным способом.
- Проверьте доступность своего сертификата и его привязку. PIN вводится только в предусмотренном окне компонента, его не включают в переписку об ошибке.
- Просмотрите документ, выберите свой сертификат и выполните предусмотренный цикл подписи.
- Дождитесь серверной проверки и проверьте результат каждой строки. Не рассчитывайте на подписание протокола без интернета.
Поддержка семейства носителей не гарантирует работу любой модели телефона и любого способа подключения. Если сертификат не найден, выясните этап сбоя до повторных попыток подписания.