Подписание протоколов в приложении Android

В документации мы постарались ответить на частые вопросы по работе TesLab, с которыми сталкиваются пользователи.
Если Вы не нашли ответ на свой вопрос, напишите нам.

Подписание протоколов в приложении Android

На Android доступны два самостоятельных варианта: TesLab X и TesLab ProSign. Выберите инструкцию для установленного приложения. Для обоих вариантов нужны свой сертификат с закрытым ключом и служба носителя: JaCarta Service или Панель управления Рутокен.

  • TesLab X: используется установленный APK со встроенным КриптоПро. Отдельное приложение TesLab ProSign для этого варианта не нужно.
  • TesLab ProSign: отдельное Android-приложение для входа по сертификату и подписания протоколов. Его инструкция приведена ниже в этой же статье.

Мобильный браузер и ярлык сайта не заменяют установленное приложение для этих способов подписи.

В этой статье
Два маршрута подписи Android: внутри TesLab X и в отдельном TesLab ProSign, с общей подготовкой службы токена
Настройка службы токена общая. Дальнейшие шаги различаются для TesLab X и отдельного TesLab ProSign; результат обоих вариантов проверяют в карточке протокола.

Установить необходимые приложения

  1. Установите выбранное приложение: актуальный APK TesLab X из принятого в организации источника либо APK TesLab ProSign с сайта TesLab. Для работы внутри TesLab X устанавливать второе приложение не требуется.
  2. Для JaCarta установите JaCarta Service. Назначение сервиса описано у производителя.
  3. Для Рутокен установите Панель управления Рутокен от АО «Актив-Софт»: Google Play или RuStore.
JaCartaРутокен
Примеры USB-носителей JaCartaПримеры USB-носителей Рутокен

Используйте собственный действующий сертификат и соответствующий закрытый ключ. Проверьте совместимость конкретной модели носителя, способа подключения и телефона. Фотографии помогают определить семейство, но не гарантируют поддержку любой изображённой модели. Для работы подготовьте сеть и достаточный заряд устройства.

Подключить токен и проверить доступ

Если используется JaCarta

  1. Откройте JaCarta Service и подключите носитель способом, предусмотренным для вашей модели: напрямую, через совместимый переходник или поддерживаемый считыватель.
  2. Если Android запросит доступ JaCarta Service к подключённому устройству, проверьте название носителя и разрешите доступ.
  3. Убедитесь, что устройство появилось в списке JaCarta Service. После этого откройте выбранное приложение TesLab.
Пример системного запроса доступа JaCarta Service к токену
Пример разрешения доступа. Подпись кнопки зависит от версии Android; разрешайте доступ только к своему носителю.
Носитель отображается в списке JaCarta Service
Признак готовности службы: подключённый носитель виден в списке. Показанные вкладки Bluetooth относятся к этому примеру подключения.

Если используется Рутокен

  1. Запустите Панель управления Рутокен и выполните предложенную приложением настройку разрешений.
  2. Подключите USB-носитель напрямую или через подходящий OTG-переходник. Если телефон требует отдельного включения OTG, выполните это в его настройках.
  3. Для модели с NFC включите NFC и удерживайте носитель у считывающей области телефона во время обращения к ключу. Для Bluetooth-модели выполните её порядок сопряжения; обычному USB-токену Bluetooth не требуется.
  4. Проверьте, что в Панели управления появилась карточка устройства и доступны сведения о ключах и сертификатах. Затем вернитесь в выбранное приложение TesLab.

Настройки разрешений и фоновой работы различаются между телефонами. Если Android останавливает службу, используйте инструкцию по настройке Панели. Подключение разных моделей подробно описано в руководстве производителя. Обнаружение токена службой ещё не подтверждает доступность нужного ключа для подписи.

При первом обращении TesLab X может спросить «Какой токен Вы используете?». Выберите своё семейство. Вариант «Не знаю» проверяет оба; поиск может занять больше времени.

Выбор JaCarta, RuToken или поиска по обоим семействам в TesLab X
Выберите семейство подключённого носителя. Выбор запоминается на устройстве в рамках текущей сессии.

Проверить лицензию КриптоПро

Встроенный КриптоПро также требует действующей лицензии. В TesLab X при обращении к сертификатам и неактивной лицензии может появиться окно «Лицензия КриптоПро». В отдельном TesLab ProSign для проверки и активации предусмотрена кнопка «Лицензия» на экране авторизации. Получите подходящий лицензионный номер по принятому в организации порядку, введите его в поле «Серийный номер» и дождитесь результата.

Это поле не предназначено для PIN токена или номера сертификата. При отказе сохраните текст и код сообщения. Отмена активации останавливает дальнейший поиск сертификатов.

Вариант 1. Подписание внутри TesLab X

Этот раздел относится к установленному APK TesLab X. Выбор сертификата, просмотр PDF и отправка подписи выполняются внутри X; отдельный TesLab ProSign не запускается.

Проверить свой сертификат и привязку

Войдите в TesLab X под своей учётной записью. В разделе «Мой профиль» откройте «Электронная подпись». Если привязки нет, выберите и явно подтвердите свой сертификат. Для перевыпущенного сертификата используйте «Загрузить новую подпись».

Сверьте владельца, срок действия и идентификатор. При запросе ключа вводите PIN в предназначенном для него окне криптографического компонента. Дождитесь сообщения «Сертификат привязан» или «Сертификат заменён», затем повторно проверьте сведения.

Предварительная привязка через компьютер не обязательна. Если тот же сертификат уже привязан, заново регистрировать его на телефоне не нужно. Однако закрытый ключ вместе с профилем не копируется: его носитель должен быть доступен Android. Сведения своей учётной записи и СНИЛС в сертификате должны соответствовать друг другу. Подробнее о привязке и сроках: электронная подпись сотрудников.

Выбрать протоколы и просмотреть PDF

  1. Откройте журнал протоколов и действие «На подпись» либо конкретный готовый протокол. Документ должен быть утверждён, а вы назначены ожидаемым подписантом.
  2. В окне «Подписание протоколов ЭЦП» сверьте номера, даты и адреса, исключите неподготовленные документы.
  3. У каждой выбранной строки нажмите «Получить PDF для просмотра».
  4. В окне «Файл готов» выберите «Открыть» для просмотра PDF. «Сохранить» создаёт пользовательскую копию в выбранном месте, «Поделиться» передаёт файл другому приложению.
  5. Прочитайте каждый документ, проверьте объект, результаты, выводы и акт при его наличии. После этого отметьте «Подтверждаю, что я просмотрел(а) все подписываемые документы».
Мобильное окно Файл готов с действиями Открыть, Сохранить и Поделиться для учебного PDF
Для проверки содержимого выберите «Открыть». Если просмотрщик PDF на телефоне отсутствует, подготовьте его до подписания документов.

Кнопка «Подписать» доступна после получения PDF всех выбранных строк и подтверждения просмотра. Надпись «PDF получен для просмотра» не означает, что содержимое уже прочитано. Изменение набора или повторное получение файла сбрасывает флажок. Если документ неудобно читать на маленьком экране, подготовьте возможность полноценного просмотра до подписи.

Учебный протокол в мобильном окне: PDF получен, просмотр подтверждён, доступна кнопка Подписать 1
Перед запуском проверьте выбранные документы и число на кнопке. Подтверждение относится ко всему выбранному набору.

Выполнить подписание

  1. Нажмите «Подписать». Если появился список сертификатов, проверьте и выберите свой.
  2. Выполните запрос криптографического компонента на доступ к нужному ключу. Не отключайте носитель во время работы.
  3. Дождитесь передачи подписей выбранных документов. До обращения к ключу программа сверяет текущую версию PDF с полученной для просмотра.

При изменении версии получите новый PDF, прочитайте его и заново подтвердите просмотр. Во время подписи состав набора и повторный запуск блокируются. «Остановить», закрытие окна или потеря сессии прекращают ожидание и дальнейшую обработку, но не отзывают ранее переданные подписи.

Вариант 2. Подписание в TesLab ProSign

TesLab ProSign устанавливается и запускается как отдельное приложение. Настройте JaCarta Service или Панель управления Рутокен по общей инструкции выше, подключите свой носитель и убедитесь, что служба его обнаружила.

Подготовить сертификат и войти

  1. Заранее привяжите свой сертификат к учётной записи TesLab через профиль на компьютере или в TesLab X. Сам ProSign использует эту привязку для входа. Если нужна настройка компьютера, используйте отдельную инструкцию.
  2. Откройте TesLab ProSign. В поле «Сервер» укажите адрес сервера своей организации, например inzc.teslab.ru, без https:// и /api.
  3. Выберите JaCarta или Rutoken по подключённому носителю. Дождитесь списка ключей.
  4. Выберите свой сертификат, сверив владельца и срок действия. Введите PIN носителя в поле «Пин-код» самого ProSign. Это отличается от сценария X, где запрос ключа может появиться в отдельном окне компонента.
  5. Нажмите «Подключение». Если программа сообщает о лицензии, откройте «Лицензия», проверьте состояние и выполните активацию по принятому в организации порядку. Затем повторите вход.
Экран авторизации отдельного TesLab ProSign с учебным сертификатом, выбором носителя и полем Пин-код
Экран входа TesLab ProSign. Укажите свой сервер, выберите носитель и сертификат, введите PIN и нажмите «Подключение». Данные на примере условные.

При отсутствии сертификатов в ProSign доступен «Перезапуск». Сначала проверьте выбранное семейство и обнаружение носителя в его службе. Bluetooth включают для соответствующего способа подключения или по конкретному запросу приложения, а не для устранения любой ошибки USB.

Просмотреть и подписать протоколы

  1. После входа дождитесь списка «Протоколы». При необходимости обновите его, потянув вниз.
  2. Нажмите кнопку просмотра справа от каждого нужного протокола и прочитайте открывшийся документ. Проверьте номер, дату, объект и результаты.
  3. Отметьте нужные строки флажками. Кнопка в левой части верхней панели выбирает весь список; перед общим выбором убедитесь, что все документы готовы.
  4. Нажмите «Подписать». В появившемся подтверждении проверьте число выбранных протоколов и подтвердите, что прочитали их, затем запустите подписание.
  5. Не отключайте носитель. Следите за счётчиком «Подписано N из M» и перечнем ошибок. После завершения нажмите «ОК» и обновите состояние документов в TesLab.
Список учебных протоколов в TesLab ProSign, два флажка выбраны, справа кнопки просмотра, внизу Подписать
Список протоколов TesLab ProSign. Кнопка справа открывает документ для просмотра, флажок слева включает его в набор. На примере выбраны только первые два протокола.

ProSign имеет свой экран выполнения и своё подтверждение просмотра. Окно «Файл готов», флажок и автоматическая проверка просмотренной версии из раздела TesLab X не описывают интерфейс ProSign. Если после просмотра документ изменяли, полностью закройте TesLab ProSign, запустите его заново и повторите просмотр перед подписью.

Экран отдельного TesLab ProSign во время подписания, обработаны два протокола из трёх
TesLab ProSign: подписание ещё выполняется. Кнопка «Отмена» прекращает дальнейшую обработку, но не отзывает уже отправленные подписи.
Экран отдельного TesLab ProSign со счётчиком Подписано 3 из 3 и кнопкой ОК
TesLab ProSign: приложение завершило обработку выбранного набора. Серверный результат каждой подписи проверяется отдельно в карточке протокола.

Проверить результат

В TesLab X «На проверке» в строке и сообщение «Передано подписей: N» означают, что сервер подтвердил приём. Обновите карточку и дождитесь результата проверки своей подписи. Успешная личная подпись ещё не означает, что подписали все необходимые участники и сформированы итоговые файлы.

Счётчик «Подписано N из M» в отдельном ProSign также не заменяет серверную проверку подписи и готовность всего документа.

При частичном отказе прочитайте причину каждой ошибки. Повторяйте действие только для оставшихся документов, которым нужна ваша подпись. Если подтверждение отправки потеряно, сначала обновите журнал и проверьте состояние; отсутствие ответа не доказывает, что подпись не поступила. Общий порядок результата и повторов описан в статье «Подписание протоколов ЭЦП».

Разобраться с ошибкой

  • Токен не виден в службе производителя: проверьте соединение, переходник, разрешения, питание и настройки выбранного способа связи.
  • Токен виден, сертификата нет: проверьте наличие своего сертификата с ключом, семейство носителя, лицензию и привязку. При смене семейства токена завершите текущую операцию и повторно войдите в TesLab X, предварительно убедившись, что локальные изменения сохранены и очередь отправлена.
  • Ошибка доступа к сертификатам: прочитайте указанную причину службы. Отказ доступа отличается от успешного поиска без подходящих сертификатов.
  • Сервер отказал: проверьте назначение подписанта, СНИЛС, дату протокола и настройки электронного подписания. Будущая дата и ограничение подписания днём утверждения могут препятствовать операции.

При повторении ошибки сообщите поддержке модель телефона и токена, версию APK, этап и точный текст сообщения. Не передавайте PIN и закрытый ключ. Не очищайте данные приложения и не переустанавливайте его как первый способ диагностики: сначала разберитесь с сохранёнными документами и локальной очередью.

Учесть ограничения без интернета

Получение PDF, передача и серверная проверка подписи требуют сети. Перед подписью отправьте локальные изменения и проверьте актуальность документа. Подготовка к полевой работе описана в статье об офлайне, проверка очереди после восстановления сети в инструкции по синхронизации.

Контроль готовности

Выбран нужный маршрут: APK TesLab X или отдельный TesLab ProSign. Служба видит токен, свой сертификат доступен и привязан, все выбранные документы прочитаны. После отправки в карточке проверен результат вашей подписи и понятен статус остальных участников.

Вернуться к руководству специалиста ИЛ.