DSSCertificatesManager
public final class DSSCertificatesManager
Класс для управления сертификатами в DSS со стороны SDK
-
Создание сертификата/запроса на сертификат
Перед выполнением
user.isReadyToSign
должен бытьtrue
Declaration
Swift
public static func createCertificate( user: DSSUser, dn: [String: String], templateId: String, caId: Int, callback: @escaping (_ result: Result<DSSCertificate, Error>) -> Void)
Parameters
user
Пользователь, для которого нужно создать сертификат/запрос
dn
Различительное имя субъекта в формате [“OID компонента имени”: “Значение компонента имени”]
templateId
Идентификатор шаблона сертификата
caId
Идентификатор обработчика УЦ
callback
Замыкание возвращает результат
result
Возвращает созданый запрос на сертификат или ошибку
-
Получение списка сертификатов и запросов на сертификат
Declaration
Swift
public static func listCertificates( user: DSSUser, callback: @escaping (_ result: Result<[DSSCertificate], Error>) -> Void)
Parameters
user
Пользователь, для которого нужно вернуть список
callback
Замыкание возвращает результат
result
Возвращает список или ошибку
-
Удаление сертификата / запроса на сертификат
Перед выполнением
user.isReadyToSign
должен бытьtrue
Нужно передать либо dssCertificateId, либо dssRequestId:
- Если передать dssCertificateId, то удалится сертификат, и связанный с ним запрос
Если передать dssRequestId, то удалится только запрос
Declaration
Swift
public static func deleteCertificate( user: DSSUser, dssCertificateId: String?, dssRequestId: String?, callback: @escaping (_ result: Result<Void, Error>) -> Void)
Parameters
user
Пользователь-владелец сертификата/запроса на сертификат
dssCertificateId
Идентификатор удаляемого сертификата. Указывается, если нужно удалить сертификат
dssRequestId
Идентификатор удаляемого запроса на сертификат. Указывается, если нужно удалить запрос на сертификат
callback
Замыкание возвращает результат
result
В случае успеха не возвращает ничего. Иначе — возвращает ошибку
-
Установка сертификата в DSS.
Перед выполнением
user.isReadyToSign
должен бытьtrue
Declaration
Swift
public static func setCertificate( user: DSSUser, certContent: String, callback: @escaping (_ result: Result<Void, Error>) -> Void)
Parameters
user
Пользователь-владелец сертификата/запроса на сертификат
certContent
Сертификат в формате Base64
callback
Замыкание возвращает результат
result
В случае успеха не возвращает ничего. Иначе — возвращает ошибку
-
Установка имени сертификата для отображения
Declaration
Swift
public static func setCertificateFriendlyName( user: DSSUser, dssCertificateId: String, friendlyName: String, callback: @escaping (_ result: Result<Void, Error>) -> Void)
Parameters
user
Пользователь-владелец сертификата
dssCertificateId
Идентификатор сертификата
friendlyName
Дружественное имя сертификата
callback
Замыкание возвращает результат
result
В случае успеха не возвращает ничего. Иначе — возвращает ошибку
-
Установка сертификата по умолчанию
Declaration
Swift
public static func setDefaultCertificate( user: DSSUser, dssCertificateId: String, callback: @escaping (_ result: Result<Void, Error>) -> Void)
Parameters
user
Пользователь-владелец сертификата
dssCertificateId
Идентификатор сертификата
callback
Замыкание возвращает результат
result
В случае успеха не возвращает ничего. Иначе — возвращает ошибку
-
Отзыв сертификата
Перед выполнением
user.isReadyToSign
должен бытьtrue
Declaration
Swift
public static func revokeCertificate( user: DSSUser, dssCertificateId: String, revokeAt timestamp: TimeInterval? = nil, reason: CertificateRevokingReason = .unspecified, callback: @escaping (_ result: Result<Void, Error>) -> Void)
Parameters
user
Пользователь-владелец сертификата
dssCertificateId
Идентификатор сертификата
revokeTimeStamp
Время отзыва сертификата. Рекомендуем дополнительно закладывать 15 минут на сетевые запросы, обработку сервером и прочие операции. Если параметр не указан, то сертификат будет отозван немедленно.
reason
Причина отзыва сертификата
callback
Замыкание возвращает результат
result
В случае успеха не возвращает ничего. Иначе — возвращает ошибку
-
Приостановка действия сертификата
Перед выполнением
user.isReadyToSign
должен бытьtrue
Declaration
Swift
public static func suspendCertificate( user: DSSUser, dssCertificateId: String, from fromTimestamp: TimeInterval? = nil, to toTimestamp: TimeInterval, callback: @escaping (_ result: Result<Void, Error>) -> Void)
Parameters
user
Пользователь-владелец сертификата
dssCertificateId
Идентификатор сертификата
fromTimestamp
Время начала приостановки действия сертификата. Рекомендуем дополнительно закладывать 15 минут на сетевые запросы, обработку сервером и прочие операции. Если параметр не задан, то действие сертификата будет приостановлено немедленно.
toTimestamp
Время возобновления действия сертификата
callback
Замыкание возвращает результат
result
В случае успеха не возвращает ничего. Иначе — возвращает ошибку
-
Возобновление действия сертификата
Перед выполнением
user.isReadyToSign
должен бытьtrue
Declaration
Swift
public static func unSuspendCertificate( user: DSSUser, dssCertificateId: String, callback: @escaping (_ result: Result<Void, Error>) -> Void)
Parameters
user
Пользователь-владелец сертификата
dssCertificateId
Идентификатор сертификата
callback
Замыкание возвращает результат
result
В случае успеха не возвращает ничего. Иначе — возвращает ошибку