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

    В случае успеха не возвращает ничего. Иначе — возвращает ошибку