Настройка частичного подтверждения операций

Частичное подтверждение операции предоставляет пользователю возможность выборочно подтвердить подпись одного или нескольких документов из пакета.

Для поддержки частичного подтверждения операции требуется выполнить следующие действия:

настроить возможность частичного подтверждения на сервере КриптоПро Ключ;
обеспечить поддержку частичного подтверждения в мобильном приложении с Ключ SDK.

Настройки на сервере (Центр Идентификации)

Настройка возможности частичного подтверждения может быть выполнена на следующих уровнях:

глобальный (на уровне всего ЦИ, командлет Set-IdsMyDssProperties),
для одного мобильного приложения (на уровне MyDssSystem, командлет Set-IdsMobileAppConfiguration).

# Глобальный уровень
Set-IdsMyDssProperties -DisplayName <имя экземпляра ЦИ> -DocumentSelectionMode <режим подтверждения>

# Уровень приложения
Set-IdsMobileAppConfiguration -SystemId <GUID зарегистрированного мобильного приложения> -DocumentSelectionMode <режим подтверждения>

Допустимы следующие значения параметра-DocumentSelectionMode:

none - значение используется по умолчанию. Возможность частичного подтверждения будет зависеть от параметра enableMultiSelection,
ForcePartialPackageOperation - разрешить частичное подтверждение,
ForceEntirePackageOperation - запретить частичное подтверждение.

Примечание

Настройки, выполненные на уровне мобильного приложения (Set-IdsMobileAppConfiguration) переопределяют настройки, заданные на уровне ЦИ (Set-IdsMyDssProperties).

Примечание

Переданное в REST-запросе к Сервису Подписи значение DocumentSelectionMode (см. SignatureOperation) будет проигнорировано, если в настройках ЦИ/мобильного приложения были заданы значения параметра -DocumentSelectionMode -ForcePartialPackageOperation или -ForceEntirePackageOperation.

Настройки в Ключ SDK

Заданное на сервере (или полученное через REST API в случае значения на сервере none) значение -DocumentSelectionMode будет получено в параметрах documentSelectionMode (iOS), getDocumentSelectionMode (Android) запрошенной операции (iOS, Android).

В случае получения значений none или ForcePartialPackageOperation в вызове метода SignMT может быть активирована возможность частичного подтверждения при помощи параметра enableMultiSelection.

Примечание

В мобильном приложении КриптоПро Ключ частичное подтверждение операций, инициированных из мобильного приложения (т.е. документы загружены на подпись из хранилища мобильного устройства), не поддерживается.