Общие сведения
Данный раздел содержит сведения о комплекте разработчика 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-токены.
Для 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 в различных исполнениях (форм-факторах) приведена на корпоративном сайте.