https://repo.paycontrol.org/git/ios/mydss.git

pod 'myDSSSDK',           :git => 'https://repo.paycontrol.org/git/ios/mydss.git'

AppName.app/root-certs/
    cert_1.crt
    cert_2.cer
    ...
    cert_N.certificate

# SPM
sh ${BUILD_DIR%Build/*}/SourcePackages/artifacts/mydss/myDSSSDK.xcframework/Tools/ConfigureApplication

# CocoaPods
sh ${PROJECT_DIR}/Pods/myDSSSDK/myDSSSDK.xcframework/Tools/ConfigureApplication

# Ручная установка
sh myDSSSDK.xcframework/Tools/ConfigureApplication

import UIKit
import myDSSSDK

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

        // Установка уровня логирования и инициализация библиотеки
        #if DEBUG
        myDSS.setLogLevel([.debug, .keys])
        myDSS.initialize(debugMode: true)
        #else
        myDSS.initialize()
        #endif

        ...

    }

}

DSSUsersManager.createDSSUser(
    serviceURL: serverURL,          // Адрес сервера DSS
    name: name,                     // Имя для сохранения учетной записи
    pushNotificationsData: data,    // Данные для отправки пуш-уведомлений
    deviceName: deviceName,         // Отображаемое дружественное имя устройства
    externalId: externalId,         // Внешний идентификатор
    alias: alias,                   // Человекочитаемый идентификатор устройства
    requirePassword: requirePwd     // Требуется ли установка пароля
) { result in

    // Обрабатываем результат
    switch result {
        case let .success(user): ...    // Пользователь создан и сохранён в хранилище
        case let .failure(error): ...
    }

}

DSSUsersManager.updateStatus(
    user: user
) { result in
    switch result {
        case let .success(user):                // Сведения о пользователе обновлены
            if user.state == .notVerified {     // Проверяем статус

                ...
            }
        case let .failure(error): ...
    }

}

DSSUsersManager.acceptAccountChanges(
    user: user
) { result in

    switch result {
        case let .success(user): ...    // Пользователь подтверждён
        case let .failure(error): ...
    }

}

DSSUsersManager.createDSSUserWithInitQR(
    name: name,                     // Имя для сохранения учетной записи
    pushNotificationsData: data,    // Данные для отправки пуш-уведомлений
    deviceName: deviceName,         // Отображаемое дружественное имя устройства
    externalId: externalId,         // Внешний идентификатор
    alias: alias,                   // Человекочитаемый идентификатор устройства
    requirePassword: true           // Требуется ли установка пароля
) { result in

    switch result {
        case let .success(user): ...    // Пользователь создан и сохранён в хранилище
        case let .failure(error): ...
    }

}

// Идентификатор подтверждённого пользователя, к которому привязываем новое устройство
let uid = user.dssUserID

DSSUsersManager.createDSSUserWithApproval(
    serviceURL: serverURL,          // Адрес сервера DSS
    uid: uid,                       // Идентификатор пользователя, к которому привязываем устройство
    name: name,                     // Имя для сохранения учетной записи
    pushNotificationsData: data,    // Данные для отправки пуш-уведомлений
    deviceName: deviceName,         // Отображаемое дружественное имя устройства
    externalID: externalID,         // Внешний идентификатор
    alias: alias,                   // Человекочитаемый идентификатор устройства
    requirePassword: true           // Требуется ли установка пароля
) { result in

    switch result {
        case let .success(newUser): ...    // Пользователь создан и сохранён в хранилище
        case let .failure(error): ...
    }

}

DSSDevicesManager.processAwaitingDevice(
    user: user  // Пользователь к которому привязываем устройство
) { result in
    switch result {
        case .success: ...    // Новое устройство подтверждено/отклонено
        case let .failure(error): ...
    }
}

DSSUsersManager.checkApprovalStatus(
    user: newUser
) { result in
    switch result {
        case let .success(approvedUser): ...    // Пользователь добавлен
        case let .failure(error): ...           // Пользователь отклонён/не обработан
    }
}

DSSUsersManagerNonQual.createDSSUser(
    serviceURL: serverURL,          // Адрес сервера DSS
    pushNotificationsData: data,    // Данные для отправки пуш-уведомлений
    deviceName: deviceName,         // Отображаемое дружественное имя устройства
    externalId: externalId,         // Внешний идентификатор
    alias: alias,                   // Человекочитаемый идентификатор устройства
) { result in

    // Обрабатываем результат
    switch result {
        case let .success(user): ...    // Пользователь создан
        case let .failure(error): ...
    }

}

DSSUsersManagerNonQual.store(
   user: user,        // Новый пользователь 
   name: name,        // Имя для хранения
   password: password // Пароль для хранения
) { result in

    // Обрабатываем результат
    switch result {
    case let .success(user): ...    // Пользователь сохранён
    case let .failure(error): ...
    }

}

DSSUsersManager.updateStatus(
    user: user
) { result in

    switch result {
        case let .success(user):                // Сведения о пользователе обновлены
            if user.state == .notVerified {     // Проверяем статус
                ...
            }
        case let .failure(error): ...
    }

}

if !user.isReadyToSign {
    // Предъявляем пароль
    try DSSUsersManagerNonQual.submitPassword(user: user, password: password)
}

if user.verification == .qrRequired {
    // Парсим QR-код
    let qrValue = ...
    // Проверяем
    let verificationQRCode: DSSQRCodeVerification = try myDSS.analyzeQR(qrValue)
}

// Присоединяем к УЗ
DSSUsersManagerNonQual.acceptAccountChanges(
  user: user,                             // Пользователь
  verificationQRCode: verificationQRCode  // QR-код
) { result in

    // Обрабатываем результат
    switch result {
    case let .success(user): ...    // Пользователь присоединён у УЗ
    case let .failure(error): ...
    }

}

// Парсим QR-код
let registrationQRCode: DSSQRCodeKinit = try myDSS.analyzeQR(qrValue)

// Проверяем активацию
if !qrCode.isActivated {
    let activatedQRCode = try myDSS.activate(qrCodeKinit: qrCode, code: activationCode)
}

// Регистрируем
DSSUsersManagerNonQual.createDSSUserWithInitQR(
    qrCode: qrCode,                               // QR-код
    pushNotificationsData: pushNotificationsData, // Данные для отправки пуш-уведомлений
    deviceName: deviceName,                       // Отображаемое дружественное имя устройства
    externalId: externalId,                       // Внешний идентификатор
    alias: alias,                                 // Человекочитаемый идентификатор устройства
) { result in

    switch result {
        case let .success(user): ...    // Пользователь зарегистрирован
        case let .failure(error): ...
    }

}

DSSUsersManagerNonQual.store(
   user: user,        // Новый пользователь 
   name: name,        // Имя для хранения
   password: password // Пароль для хранения
) { result in

    // Обрабатываем результат
    switch result {
    case let .success(user): ...    // Пользователь сохранён
    case let .failure(error): ...
    }

}

 DSSUsersManagerNonQual.createDSSUserWithApproval(
    serviceURL: serviceURL,                        // Адрес для взаимодействия существующего пользователя
    uid: userId,                                   // UserID существующего пользователя 
    pushNotificationsData: pushNotificationsData,  // Данные для отправки пуш-уведомлений
    deviceName: deviceName,                        // Отображаемое дружественное имя устройства
    externalId: externalId,                        // Внешний идентификатор
    alias: alias,                                  // Человекочитаемый идентификатор устройства
 ) { result in

    switch result {
    case let .success(user): ... // Пользователь зарегистрирован
    case let .failure(error): ...
    }

}

DSSUsersManagerNonQual.store(
   user: user,        // Новый пользователь 
   name: name,        // Имя для хранения
   password: password // Пароль для хранения
) { result in

    // Обрабатываем результат
    switch result {
    case let .success(user): ...    // Пользователь сохранён
    case let .failure(error): ...
    }

}

// Получаем список устройств
DSSDevicesManager.listDevices(
    user: user // Основной активный пользователь
) { result in

    switch result {
    case let .success(devices): ...    // Список устройств
    case let .failure(error): ...
    }
}

// Находим неподтверждённое устройство
let notApprovedDevice = devices.first(where { $0.state == .approveRequired })

if !user.isReadyToSign {
    // Предъявляем пароль
    try DSSUsersManagerNonQual.submitPassword(user: user, password: password)
}

// Подтверждаем присоединение
DSSDevicesManagerNonQual.approve(
   device: notApprovedDevice,   // Устройство, ожидающее подтверждения
   user: user                   // Основной активный пользователь
) { result in
    switch result {
    case .success: ... // Присоединение устройства одобрено
    case let .failure(error): ...
    }
}

// ... или отклоняем
DSSDevicesManagerNonQual.reject(
   device: notApprovedDevice,   // Устройство, ожидающее подтверждения
   user: user                   // Основной активный пользователь
) { [weak self] result in
    switch result {
    case .success: ... // Присоединение устройства отклонено
    case let .failure(error): ...
    }
}

DSSUsersManagerNonQual.checkApprovalStatus(
    user: userToCheck // Новый пользователь
) { result in
    switch result {
    case let .success(user): ... // Пользователь присоединён
    case let .failure(error):
        switch error {
        case DSSError.approveRequired: ...  // По-прежнему ожидаем подтверждение на основном устройстве
        default: ...
        }
    }
}

DSSDevicesManager.listDevices(
    user: user
) { result in
    switch result {
        case let .success(devices): ... // Все устройства
        case let .failure(error): ...
    }
}

DSSCertificatesManager.listCertificates(
    user: user // Пользователь, запрашивающий информацию
) { result in
    switch result {
        case let .success(certificates): ... // Вернётся массив сертификатов и запросов
        case let .failure(error): ...
    }
}

// Отфильтруем выпущеные сертификаты
let issuedCertificates = certificates.filter { $0.type == .certificate }

// Получаем параметры сервера подписания
DSSPolicyManager.getDSSSignServerParams(
    user: user  // Пользователь, запрашивающий параметры сервера подписания
) { result in
    switch result {
        case let .success(signServerParams): ... // Вернутся параметры сервера подписания
        case let .failure(error): ...
    }
}

...

// Подготавливаем параметры. Значения даны для примера
let policyId = signServerParams.caPolicies.first(where: { $0.caType == .DSSOutOfBandEnroll }).id
let templateId = policy.ekuTemplates.first?.value.first
let testDN = ["2.5.4.3": "Test"]

// Создаём запрос на сертификат
DSSCertificatesManager.createCertificate(
    user: user,             // Пользователь, создающий запрос на сертификат
    dn: testDN,             // Различительное имя субъекта
    templateId: templateId, // Идентификатор шаблона сертификата
    caId: policyId          // Идентификатор обработчика УЦ
) { result in
    switch result {
        case let .success(certRequest): ... // Вернётся запрос на сертификат
        case let .failure(error): ...
    }
}

// Находим неподписаный запрос
let requestToSign = certificates.first {
    $0.type == .request && $0.isClient = true && $0.dssCertificateId == nil
}

// Подписываем
DSSCertificatesManagerNonQual.sign(
    certificateRequest: requestToSign,
    user: user
) { result in

    switch result {
    case .success: ... // Запрос подписан
    case let .failure(error): ...
    }
}

// Отсеиваем сертификаты, недоступные на этом устройстве
// (например, у которых запрос был подписан на другом устройстве)
let availableCertificates = certificates
    .filter { $0.type == .certificate && DSSCertificatesManagerNonQual.checkIfAccessibleOnThisDevice(certificate: $0, for: user) }

// Получаем неустановленные сертификаты
let certificateToInstall = availableCertificates
    .filter { $0.isClient && !DSSCertificatesManagerNonQual.checkIfInstalled(certificate: $0, for: user) }
    .first

// Устанавливаем
DSSCertificatesManagerNonQual.install(
    certificate: certificateToInstall,
    user: user
) {
    switch result {
    case .success: ... // Сертификат установлен
    case let .failure(error): ...
    }
}

DSSOperationsManager.getOperationsList(
    user: user,         // Пользователь, для которого проверяются операции
    operationType: nil, // Фильтр операций по типу
    operationID: nil    // Фильтр по идентификатору
) { result in
    switch result {
        case let .success(operations): ...   // Получен список операций
        case let .failure(error): ...
    }
}

DSSOperationsManager.confirmOperation(
    operation: operation,   // Операция для подтверждения
    user: user,             // Пользователь, подтверждающий операцию
    signMode: .online       // Способ подтверждения. В данном случае — online
) { result in
    switch result {
        case let .success(approveRequest): ...   // Операция подтверждена, вернули
        case let .failure(error): ...
    }
}

DSSOperationsManager.uploadDocument(
    documentContent: documentData,      // Бинарные данные документа
    title: documentTitle,               // Заголовок документа
    snippetTemplate: documentSnippet,   // HTML-сниппет документа
    previewTemplate: documentPreview,   // HTML-превью документа
    user: user                          // Пользователь-владелец документа
) { result in
    switch result {
        case let .success(documentID):  // Вернётся идентификатор документа
        case let .failure(error): ...
    }
}

// Формируем параметры подписания
let templateId = signServerParams.processingTemplates.first.id
let certificateId = certificate.dssCertificateId
let signParams = SignParams(
    signTemplateId: templateId, // Идентификатор шаблона подписи
    certId: certificateId,      // Идентификатор сертификата, которым будем подписывать
    pinCode: ""                 // Пин-код от сертификата. Если пин-код не установлен, то укажите пустую строку
)

DSSOperationsManager.signDocuments(
    documentsIDs: confirmedDocuments,           // Документы для подписания
    user: user,                                 // Пользователь, подписывающий документы
    signParams: signParams                      // Параметры подписания
) { result in
    switch result {
        case let .success(signingResults):      // Вернутся результаты подписания
        case let .failure(error): ...
    }
}

// Получаем параметры сервера подписания
DSSPolicyManager.getDSSSignServerParams(
    user: user  // Пользователь, запрашивающий параметры сервера подписания
) { result in
    switch result {
        case let .success(signServerParams): ... // Вернутся параметры сервера подписания
        case let .failure(error): ...
    }
}

...

// Получаем сертификат
DSSCertificatesManager.listCertificates(
    user: user  // Пользователь, запрашивающий сертификаты
) { result in
    switch result {
        case let .success(certificates): ... // Вернутся сертификаты и запросы на сертификаты
        case let .failure(error): ...
    }
}

...

// Выбираем сертификат, например, первый в списке. Запросы на сертификат игнорируем
let certificate: DSSCertificate = certificates.first(where: {
    $0.type == .certificate
})

...

// Создание резервной копии
let userBackupData: Data = try DSSUsersManagerNonQual.createBackup(
    user: user,
    recoveryPassword: recoveryPassword
)

// Восстановление
let restoredUser: DSSUser = try DSSUsersManagerNonQual.restoreFromBackup(
    backupData: userBackupData,
    recoveryPassword: recoveryPassword
)

DSSUsersManagerNonQual.store(
    user: restoredUser,
    name: username,
    password: password
) { storingResult in
    switch result {
        case let .success(storedUser):  // Сохранённый пользователь
        case let .failure(error): ...
    }
}

// Создание резервной копии
let keyBackupData: Data = try DSSKeysManagerNonQual.createBackup(
    keyInfo: keyInfo,
    recoveryPassword: recoveryPassword
)

// Восстановление
let restoredKeyInfo: DSSKeyInfo = try DSSKeysManagerNonQual.restoreFromBackup(
    backupData: keyBackupData,
    recoveryPassword: recoveryPassword
)

// При подписи сертификата
DSSCertificatesManagerNonQual.sign(
    certificateRequest: request,
    user: user,
    isExportable: true,
    completion: { ... } 
)

// При создании ключей
let keyInfo = try DSSKeysManagerNonQual.createKeyPair(
    for: user,
    pin: pin,
    isExportable: true
)

// Экспорт

// Получаем список сертификатов
DSSCertificatesManager.listCertificates(
    user: user, 
    сompletion: { ... }
) 

// // Выбираем сертификат для экспорта
let certificateToExport = certificatesList.first {
    $0.type == .certificate &&
    !$0.isArchived &&
    DSSCertificatesManagerNonQual.checkIfAccessibleOnThisDevice(certificate: $0, for: user)
}

// Выгружаем архив
DSSCertificatesManagerNonQual.exportPfx(
    user: user,
    certificate: certificateToExport, // Сертификат, ключи которого архивируем
    pin: pin,    // Пин-код от контейнера ключей
    pfxPin: nil, // Дополнительный пин-код, на котором будет зашифрован архив (опционально)
    completion: { ... }
)

...

// Импорт

// Получаем список сертификатов
DSSCertificatesManager.listCertificates(
    user: user,
    completion: { ... }
)

// Находим доступный для импорта сертификат
let archivedCertificate = certificatesList.first {
    $0.type == .certificate && 
    $0.isArchived
}

// Импортируем. После импорта на устройство будут загружены ключи
DSSCertificatesManagerNonQual.importPfx(
    user: user,
    certificate: archivedCertificate,
    pin: newPin, // Новый пин-код для контейнера ключей
    pfxPin: nil, // Пин-код для расшифрования архива
    completion: { ... }
)

let userToRenew: DSSUser = ... // Пользователь, которого хотим обновить

DSSUsersManagerNonQual.renew(
    user: userToRenew
) { renewingResult in
    switch result {
        case let .success(renewedUser):  // Обновлённый пользователь
        case let .failure(error): ...
    }
}

https://repo.paycontrol.org/git/ios/mydssnfc.git

pod 'myDSSSDK_NFC',           :git => 'https://repo.paycontrol.org/git/ios/mydssnfc.git'

// Перечисление доступных сертификатов
DSSCertificatesManager.listExternalCertificates { listingResult in
    switch listingResult {
        case let .success(certificatesResults): ... // Результаты считывания сертификатов
        case let .failure(error): ...               // Ошибка при работе с картой
    }
}

let certificateToImport = ... // Выбираем сертификат для импорта

// Загружаем сертификат на сервер
DSSCertificatesManager.setCertificate(
    user: user,
    certificate: certificateToImport
) { settingResult in
    switch settingResult {
        case .success: ...            // Выгрузили и установили на сервере
        case let .failure(error): ... // Ошибка загрузки
    }
}

// Подписываем запрос на сертификат
public static func sign(
    certificateRequest: certificateRequest,
    user: user,
    keysSource: .rutokenNFC // Используем NFC-токен Рутокен
) { signingResult in
    switch signingResult {
        case .success: ...            // Запрос подписан, ключи созданы
        case let .failure(error): ... // Ошибка при работе с карто
    }
}

// Получаем список сертификатов
let certificates = DSSCertificatesManager.listCertificates(...)

// Проверяем, выпущен ли сертификат
let certificateToInstall: DSSCertificate = certificates.first {
    // Сертификат активный
    $0.state == .active && 
    // Ключи хранятся на клиенте
    $0.isClient &&
    // Ключи хранятся на текущем устройстве
    DSSCertificatesManagerNonQual.checkIfAccessibleOnThisDevice(certificate: $0, for: user) &&
    // Сертификт не установлен
    !DSSCertificatesManagerNonQual.checkIfInstalled(certificate: $0, for: user)
} 

// Устанавливаем выпущеный сертификат
public static func install(
    certificate: certificateToInstall,
    user: user
) { installingResult in
    switch signingResult {
        case .success: ...            // Сертификат установлен
        case let .failure(error): ... // Ошибка при установке сертификата
    }
}

public protocol DSSLoggerProtocol {

    func debug(_ message: String, category: DSSLoggingCategory)
    func error(_ message: String, category: DSSLoggingCategory)
    func sensitive(_ message: String, category: DSSLoggingCategory)

}


/// Пример логгера

struct MyLogger: DSSLoggerProtocol {

    func debug(_ message: String, category: DSSLoggingCategory) {
        ...
    }

    func error(_ message: String, category: DSSLoggingCategory) {
        ...
    }

    func sensitive(_ message: String, category: DSSLoggingCategory) {
        ...
    }

}

let myLogger = MyLogger()
// myDSS.setLogLevels([.debug, .keys]) <- Теперь можно убрать из кода приложения
myDSS.setLogger(myLogger, options: [.debug, .sensitive])

import CocoaLumberjack
import CocoaLumberjackSwift

...

// Настраиваем CocoaLumberjack
let fileLogger = DDFileLogger()
fileLogger.logFileManager.maximumNumberOfLogFiles = 2  // Храним только 2 файла
fileLogger.maximumFileSize = 256 * 1024                // не более 256kb каждый
fileLogger.rollingFrequency = 60 * 60 * 24             // с сообщениями за последние 24 часа
DDLog.add(fileLogger)

...

// Описываем методы логгера
final class MyLogger: DSSLoggerProtocol {

    func debug(_ message: String, category: DSSLoggingCategory) {
        DDLogInfo("[SDK][\(category)] \(message)")
    }

    func error(_ message: String, category: DSSLoggingCategory) {
        DDLogError("[SDK][\(category)] \(message)")
    }

    func sensitive(_ message: String, category: DSSLoggingCategory) {
        #if DEBUG
        DDLogInfo("[SDK][Sensitive][\(category)] \(message)")
        #endif
    }

}

...

// Назначаем логгер
myDSS.setLogger(MyLogger(), options: [.debug, .sensitive])

fileLogger
    .logFileManager
    .sortedLogFileInfos
    .compactMap { (info: DDInfo) -> Data in
        FileManager.default.contents(atPath: info.filePath) // Читаем логи из файла
    }
    .forEach { (logData: Data) in
        ... // Обрабатываем логи каждого файла
    }