public abstract class BaseCertificatesManagerNonQual
extends _CallbackInvoker
Constructor and Description |
---|
BaseCertificatesManagerNonQual() |
Modifier and Type | Method and Description |
---|---|
static void |
createCertificate(User user,
int caId,
java.lang.String templateId,
java.util.Map<java.lang.String,java.lang.String> dn,
boolean isClient,
CertificateNetworkCallback callback)
Создание запроса на сертификат.
Перед вызовом метода должно выполняться условие User.isReadyToSign() == true. |
static void |
deletePfx(User user,
Certificate certificate,
DeletePfxCallback callback)
Удаление архивной копии ключей, ранее созданной на сервере
. |
static void |
exportPfx(User user,
Certificate certificate,
java.lang.String containerPin,
java.lang.String pfxPin,
ExportPfxCallback callback)
Выполняет архивацию (резервное копирование) на сервере ключей подписи, хранящихся на данном мобильном
устройстве.
|
static void |
importPfx(User user,
Certificate certificate,
java.lang.String containerPin,
java.lang.String pfxPin,
ImportPfxCallback callback)
Восстановление ключей подписи на мобильном устройстве из резервной копии, хранимой на сервере .
Перед вызовом метода должно выполняться условие User.isReadyToSign() == true. |
static void |
installCertificate(User user,
Certificate certificate,
KeyInfo keyInfo,
KeysSource keysSource,
UserCallback callback)
Производит установку сертификата в контейнер
|
static void |
installCertificate(User user,
Certificate certificate,
UserCallback callback)
Производит установку сертификата в контейнер, содержащий ключ, которым ранее был подписан соответствующий
запрос на сертификат
|
static Error |
isCertificateAccessibleOnThisDevice(User user,
Certificate certificate)
Определяет, возможно ли использовать сертификат для подтверждения операций на этом устройстве
|
static Error |
isCertificateInstalled(User user,
Certificate certificate)
Определяет, установлен ли сертификат в хранилище
|
static void |
signCertificateRequest(Activity parentActivity,
User user,
Certificate request,
KeysSourceIdentifier keysSourceIdentifier,
SignCertificateRequestCallback callback)
Выполняет подписание запроса на сертификат, после чего отправляет подписанный запрос на сервер.
|
static void |
signCertificateRequest(User user,
Certificate req,
KeyInfo keyInfo,
KeysSource keysSource,
SignCertificateRequestCallback callback)
Выполняет подписание запроса на сертификат, после чего отправляет подписанный запрос на сервер
Перед вызовом метода должно выполняться условие User.isReadyToSign() == true. |
static void |
signCertificateRequest(User user,
Certificate request,
KeysSourceIdentifier keysSourceIdentifier,
SignCertificateRequestCallback callback)
Выполняет подписание запроса на сертификат, после чего отправляет подписанный запрос на сервер.
|
public static void createCertificate(User user, int caId, java.lang.String templateId, java.util.Map<java.lang.String,java.lang.String> dn, boolean isClient, CertificateNetworkCallback callback)
User.isReadyToSign()
== true.user
- Объект пользователя данного устройстваcaId
- Идентификатор УЦtemplateId
- Идентификатор шаблона сертификатаdn
- Различительное имя субъекта, где в формате OID компонента имени -> Значение компонента имениisClient
- Тип хранения закрытого ключа сертификата: на сервере или на клиенте (true - закрытый ключ
сгенерирован и хранится на данном мобильном устройстве)callback
- Реализация CertificateNetworkCallback
для обработки результатов. При успехе
возвращается объект Certificate
, содержащий данные запроса или сертификатаpublic static void signCertificateRequest(User user, Certificate req, KeyInfo keyInfo, KeysSource keysSource, SignCertificateRequestCallback callback)
User.isReadyToSign()
== true.user
- Объект User
, для которого необходимо подписать запрос на сертификатreq
- Объект Certificate
, содержащий запрос на сертификатkeyInfo
- Ключ, которым будет подписан запросkeysSource
- Информация о хранилище ключевой парыcallback
- Реализация интерфейса SignCertificateRequestCallback
для обработки результатов.
В случае успеха возвращается обновленный объект User
и объект Certificate
,
содержащий информацию о подписанном запросе.public static void installCertificate(User user, Certificate certificate, KeyInfo keyInfo, KeysSource keysSource, UserCallback callback)
user
- Объект User
, для которого необходимо произвести установку сертификатаcertificate
- Объект Certificate
, который необходимо установитьkeyInfo
- Объект KeyInfo
, содержащий ссылку на контейнер, куда будет установлен
сертификатkeysSource
- Информация о хранилище ключейcallback
- Реализация интерфейса UserCallback
для обработки результатов. В случае успеха
возвращается обновленный объект User
public static Error isCertificateInstalled(User user, Certificate certificate)
user
- Целевой User
certificate
- Целевой Certificate
Error
, у которого getType() равен
Error.ERROR_OK
если сертификат был установлен, либо ошибкуpublic static Error isCertificateAccessibleOnThisDevice(User user, Certificate certificate)
user
- Целевой User
certificate
- Целевой Certificate
public static void exportPfx(User user, Certificate certificate, java.lang.String containerPin, java.lang.String pfxPin, ExportPfxCallback callback)
User.isReadyToSign()
== true.user
- Объект User
, для которого необходимо выполнить резервное копирование ключей
подписи на серверcertificate
- Объект Certificate
, для которого выполняется архивация. Ключи подписи должны
храниться на данном устройстве, а сертификат должен быть установлен и не архивирован
ранее. Таким образом, необходимо выполнение каждого из условий:Certificate.isClient()
== trueisCertificateInstalled(User, Certificate)
== trueCertificate.isArchived()
== falsecontainerPin
- Пин-код на ключевой контейнер, который был указан при создании ключевой пары или null, если
при создании ключевой пары использовался пин-код по умолчаниюpfxPin
- Пин-код для защиты архивированного на сервере PFX. Данный пин-код потребуется при
восстановлении ключей из архивированного PFX. Можно указать null, и тогда будет использован
пин-код по умолчаниюcallback
- Реализация ExportPfxCallback
для обработки результатовpublic static void importPfx(User user, Certificate certificate, java.lang.String containerPin, java.lang.String pfxPin, ImportPfxCallback callback)
User.isReadyToSign()
== true.user
- Объект User
, для которого необходимо выполнить импорт ключей подписи на данное
устройствоcertificate
- Объект Certificate
, для которого выполняется импорт ключей. При этом
импортируемые ключи не должны быть уже сохранены на данном устройстве, а для сертификата
должен быть выставлен флаг, что ранее была произведена архивация на сервер. Таким
образом, перед импортом ключей необходима поверка следующих условий:
Certificate.isClient()
== trueisCertificateAccessibleOnThisDevice(User, Certificate)
== falseCertificate.isArchived()
== truecontainerPin
- Пин-код для защиты создаваемого ключевого контейнера. При указании null будет
использован пин-код по умолчаниюpfxPin
- Пин-код для расшифрования ранее экспортированного Pfx. Должен совпадать с пин-кодом,
указанным в методе exportPfx(User, Certificate, String, String, ExportPfxCallback)
callback
- Реализация ImportPfxCallback
для обработки результатовpublic static void deletePfx(User user, Certificate certificate, DeletePfxCallback callback)
User.isReadyToSign()
== true.user
- Объект User
, для которого необходимо удалить архивную копию ключей с сервераcertificate
- Объект Certificate
, для которого необходимо удалить ключиcallback
- Реализация интерфейса DeletePfxCallback
для обработки результатовpublic static void signCertificateRequest(User user, Certificate request, KeysSourceIdentifier keysSourceIdentifier, SignCertificateRequestCallback callback)
User.isReadyToSign()
== true. Если ключевая пара создаётся на внешнем носителе, запрашивается ПИН-код доступа к нему.user
- Объект User
, для которого необходимо подписать запрос на сертификатrequest
- Объект Certificate
, содержащий запрос на сертификатkeysSourceIdentifier
- Информация о хранилище ключей KeysSourceIdentifier
.
На текущий момент SDK поддерживает значения KeysSourceIdentifier.localGeneric
и KeysSourceIdentifier.rutokenNFC
callback
- Реализация интерфейса SignCertificateRequestCallback
для обработки результатов.
В случае успеха возвращается обновленный объект User
и объект Certificate
,
содержащий информацию о подписанном запросеpublic static void signCertificateRequest(Activity parentActivity, User user, Certificate request, KeysSourceIdentifier keysSourceIdentifier, SignCertificateRequestCallback callback)
User.isReadyToSign()
== true. Если ключевая пара создаётся на внешнем носителе, запрашивается ПИН-код доступа к нему.parentActivity
- Экземпляр Activity приложения, с которого будет запущено Activity из SDK.
При этом Activity из SDK добавляется в стек той же задачи, в которой запущена parentActivity.
Если указать null, то Activity из SDK будет запущена отдельной задачей из контекста приложения,
переданного при инициализацииuser
- Объект User
, для которого необходимо подписать запрос на сертификатrequest
- Объект Certificate
, содержащий запрос на сертификатkeysSourceIdentifier
- Информация о хранилище ключей KeysSourceIdentifier
.
На текущий момент SDK поддерживает значения KeysSourceIdentifier.localGeneric
и KeysSourceIdentifier.rutokenNFC
callback
- Реализация интерфейса SignCertificateRequestCallback
для обработки результатов.
В случае успеха возвращается обновленный объект User
и объект Certificate
,
содержащий информацию о подписанном запросеpublic static void installCertificate(User user, Certificate certificate, UserCallback callback)
user
- Объект User
, для которого необходимо произвести установку сертификатаcertificate
- Объект Certificate
, который необходимо установитьcallback
- Реализация интерфейса UserCallback
для обработки результатов. В случае успеха
возвращается обновленный объект User