I Установка и запуск

II Подключение устройства

III Известные устройства (опционально)

IV Использование

• TLS сертификат не устанавливается автоматически, вместо этого приложение предлагает сохранить файл.

  Это вызвано тем, что в новых версиях Android (11+) заблокирована возможность автоматически добавлять сертификаты в списки доверенных сертификатов операционной системы. Поэтому добавлять TLS сертификат приходится вручную, для того нужно:

  • сохранить файл сертификата когда приложение предлагает это сделать;
  • открыть настройки Android;
  • перейти в Пароли и Безопасность -> Конфиденциальность -> Шифрование и учетные данные (в разных версиях и разных сборках названия могут отличаться);
  • кликнуть на Установить (Установить сертификаты);
  • выбрать сохраненный на первом шаге файл сертификата;
  • подтвердить установку.

• Приложение установлено и запущено, но подписывать не получается. Что мне делать?

  В первую очередь удостовериться в том, что в списке уведомлений Android присутствует уведомление о том что приложение запущено. В том случае, если оно отсутствует, попробовать перезапустить приложение. Если перезапуск не помог, то лучше всего связаться с нашей технической поддержкой (о том как это сделать читайте в разделе Контакты).

  Далее следует попробовать открыть страницу https://127.0.0.1:13579.

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

  Если же браузер отображает уведомление о том, что соединение не защищено (либо какое-то другое уведомление связанное с проблемами с установкой HTTP соединения), то стоит повторно добавить сертификат УЦ так, как это описано в резделе Как пользоваться.

  Связаться с нашей технической поддержкой (о том как это сделать читайте в разделе Контакты).

• Что такое сертификат УЦ и зачем добавлять его в список доверенных?

  Для взаимодействия с приложением KAZTOKEN mobile, так же, как и с NCALayer, браузеру необходимо установить с ним сетевое соединение. Так как большенство современных браузеров придерживаются определенных правил безопасности, то они не позволяют устанавливать не защищенные соединения со страниц, соединение с которыми защищещено.

  То есть в том случае, если пользователь хочет открыть страницу https://egov.kz (HTTPS - защищенное соединение), то все дополнительные соединения с этой страницы так же должны быть защищены (т.е. использовать HTTPS). Именно для того, чтобы браузер мог устанавливать защищенное соединение с нашим приложением и нужен сертификат УЦ.

  Обычно для организации защищенных соединений используются сертификаты выпущенные доверенными удостоверяющими центрами для серверов с фиксированным в сети интернет именем. Для использования нашего приложения необходимо установить защищенное соединение с самим устройством (телефоном, планшетом). Для этого браузер пытается установить защищенное соединение с https://localhost либо https://127.0.0.1. К сожалению, доверенные удостоверяющие центры не выдают сертификаты для указанных имен (адресов), так как они идентифицируют именно локальное устройство, а не сервер в сети интернет. Ни один УЦ таких сертификатов не выдает, так как эти URL не идентифицирую какой-то один определенный хост в сети интернет.

  Общепринятым решением данной проблемы является генерация своего собственного сертификата и добавление его в список доверенных сертификатов. Именно это мы и делаем.

• Ослабляет ли защиту мобильного устройства добавление сертификата внутреннего УЦ в список доверенных?

  Мы постарались сделать все, что в наших силах для того, чтобы минимизировать возможные риски:

  • сертификаты генерируются на каждом устройстве во время первого запуска приложения, мы не используем предварительно сгенерированные сертификаты;
  • мы генерируем два сертификата: УЦ и сервиса;
  • мы не храним закрытого ключа сертификата УЦ, он используется только один раз для выпуска сертификата сервиса;
  • мы рекомендуем добавлять в список доверенных именно сертификат УЦ.

  В том случае, если у вас остались какие-либо вопросы, обязательно свяжитесь с нами.

• Я использую Firefox(Fennec) на своем мобильном устройстве, как мне настроить его для работы с KAZTOKEN mobile?

  По умолчанию браузер Firefox(Fennec) не использует системного списка доверенных сертификатов, у него свои списки. Для того, чтобы включить поддержку системных сертификатов нужно выполнить следюущие шаги:

  • запустить Firefox(Fennec);
  • перейти в меню "Настройки";
  • выбрать пункт "О Firefox";
  • нажать на логотип 5 раз, всплывет уведомление "Меню отладки включено";
  • вернуться в меню "Настройки", в нем появится несколько новых пунктов;
  • перейти в "Secret settings";
  • включить "Use third party CA certificates".

Приложение KAZTOKEN mobile не собирает и не передает данные пользователей.

По вопросам технической поддержки как пользователей, так и разработчиков, обращайтесь в ТОО «Цифровой поток – Инновации»

Информацию об устройствах KAZTOKEN можно найти на сайте http://kaztoken.kz

Интерактивная документация по поддерживаемым API доступна по адресу http://kaztoken.kz/mobile-docs