Общие сведения

Данный раздел содержит сведения о комплекте разработчика JC-Mobile SDK, основных принципах работы с входящей в его состав Единой библиотекой PKCS #11 ( для ОС Android или для iOS) и сопутствующие справочные материалы.

Информация, изложенная в этом разделе, предназначена для разработчиков, встраивающих смарт-карты, MicroUSB- или Secure MicroSD-токены с аппаратно реализованной криптографией в мобильные приложения на платформах iOS и Android.

Для получения комплекта разработчика JC-Mobile SDK

Примечание

Для скачивания комплекта разработчика на партнёрском портале необходима регистрация на портале.

Состав JC-Mobile SDK

Комплект разработчика JC-Mobile SDK включает в себя следующие файлы и каталоги:

  • android – каталог, содержащий примеры и библиотеки для ОС Android;
  • iOS – каталог, содержащий примеры и библиотеки для iOS;
  • docs – каталог, содержащий документацию в формате PDF и ссылки на онлайн-документацию для разработчиков;
  • cliparts – графические элементы, “клипарты”, для использования в маркетинговых материалах сторонних разработчиков;
  • changelog.txt – история изменений для каждой выпущенной версии JC-Mobile SDK;
  • ЛИЦЕНЗИОННОЕ СОГЛАШЕНИЕ ПО JC-Mobile SDK – документ в формате PDF с текстом лицензионного соглашения.

Состав Android SDK

Каталог android включает в себя следующие каталоги:

  • libs – cодержит все необходимые библиотеки, входящие в состав SDK (см. ниже);
  • sources – cодержит примеры использования SDK. При сборке примеров необходимо, чтобы относительное расположение каталога libs и sources сохранялось, так как примеры включают в процесс сборки библиотеки именно из папки libs.

Библиотеки, входящие в состав SDK:

  • libjcPKCS11-2.so – библиотека для работы с токенами JaCarta ГОСТ, JaCarta PKI, JaCarta PKI/ГОСТ по стандарту PKCS#11;
  • jcPKCS11-2.jar – “обертка” библиотеки libjcPKCS11-2.so для работы с ней на языке Java;
  • jna-min.jar – Java-библиотека, обеспечивающая поддержку механизма JNA;
  • libgti_jni.so – библиотека для работы со смарт-картами JaCarta в формате MicroSD;
  • libaseccid.so – библиотека для работы с токенами JaCarta в формате MicroUSB;
  • libjnidispatch.so – вспомогательная библиотека, обеспечивающая поддержку механизма JNA.

Состав iOS SDK

Каталог iOS включает в себя следущие каталоги:

  • lib – содержит все необходимые библиотеки SDK;
  • sources – cодержит примеры использования SDK. При сборке примеров необходимо, чтобы относительное расположение каталога lib и sources сохранялось, так как примеры включают в процесс сборки библиотеки именно из папки lib;
  • Include – содержит заголовочные файлы.

Библиотеки, входящие в состав SDK:

  • libjcPKCS11.a – библиотека для работы со смарт-картами JaCarta по стандарту PKCS#11;
  • libLicenseManagment.a – библиотека для работы с апплетом Лицензионный;
  • libcrypto.a, libssl.a – сборка библиотеки Openssl версии 1.0.2с.

Системные требования

JC-Mobile SDK поддерживает работу со следующими операционными системами:

  • Apple iOS 7.0 и выше;
  • Android 4.1 и выше.

JC-Mobile SDK работает с токенами различных форм-факторов:

  • смарт-карты (через смарт-карт ридер);
  • MicroUSB-токены;
  • MicroSD-токены.
../../../_images/jcmobail.png

Для iOS-устройств доступна только работа со смарт-картами с помощью:

  • смарт-карт ридера iR301-UL (разъем Lightning) или iR301-U (разъем 30-pin);
  • беспроводного смарт-карт ридера bR301;
  • кожаного чехла для iPad, iPad Air, iPad Air 2 со встроенным смарт-карт ридером;
  • пластикового чехла для iPad mini, iPad Air со встроенным смарт-карт ридером.

Для Android-устройств доступна работа с:

Примечание

Отсутствует поддержка токенов в формате MicroSD для ОС Google Android 4.4 и выше из-за ограничений, введённых Google в Android 4.4+.

Поддерживаемые модели токенов

SDK работает со следующими моделями токенов и смарт-карт (на обеих платформах):

  • JaCarta PKI;
  • JaCarta ГОСТ;
  • JaCarta PKI/ГОСТ;
  • JaCarta PKI/BIO, JaCarta PKI/BIO/ГОСТ;
  • eToken ГОСТ.

Для выполнение некоторых административных функций с токенами JaCarta ГОСТ, JaCarta PKI, JaCarta PKI/ГОСТ на мобильном устройстве под управлением iOS можно использовать мобильное приложение *JaCarta*, опубликованное в Apple App Store; на мобильном устройстве под управлением Android можно использовать мобильное приложение *JaCarta*, опубликованное в Google Play.

Для расширенного администрирования токенов JaCarta ГОСТ, JaCarta PKI, JaCarta PKI/ГОСТ следует использовать ПО Единый клиент JaCarta, установленное на ПК.

Более подробная информация о линейке токенов JaCarta в различных исполнениях (форм-факторах) приведена на корпоративном сайте.