Начало работы с подписями

В системе реализовано взаимодействие с криптопровайдерами, выполняющими функции подписания пользовательских данных: КриптоПро, НУЦ и другими. Кроме того, пользовательские сценарии позволяют выполнять подписание данных с помощью других облачных криптопровайдеров. Для работы с данным функционалом необходимо настроить электронную подпись.

Внутренняя подпись

Для получения данных и контроля изменений в системе можно получить внутреннюю подпись данных. Данная подпись не является юридически значимой. Ее предназначение — контроль изменений в приложении и фиксация версии данных элемента приложения. С подписью предоставляются также и данные, вычисленные по настройкам подписи приложения. В системе предусмотрено получение внутренней подписи для атрибутов элемента любого приложения и для файла в приложении типа Документ. Для получения внутренней подписи необходимо хранить приложение в контексте или найти его с помощью объектов Global или Namespace:

async function workWithDataSigns(): Promise<void> {
    // Получение приложения из контекста
    // document — приложение типа Документ
    const app = Context.data.document!;

    // Получение данных приложения
    const appData = await app.fetch();

    // Получение подписей
    const innerSigns = await appData.getDataSigns();

    // Найдем внутреннюю подпись атрибутов, чтобы подписать данные с помощью криптопровайдера
    const attributesInnerSign = innerSigns.find(innerSign => innerSign.type === SignType.Attributes);
    if (!attributesInnerSign) {
        throw new Error('Внутренняя подпись не найдена');
    }
}

Загрузка полученной подписи в систему

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

async function saveSign(): Promise<void> {
    // SignProvider — пример криптопровайдера
    // Включает в себя один метод вычисления подписи из данных
    const signProvider = new SignProvider();
    
    // Получение подписи для атрибутов
    const signData = signProvider.sign(attributesInnerSign.body);
    
    const newSign: NewSign = {
        // Подпись в формате base64
        sign: signData;
        // Тип подписи в зависимости от того, что необходимо подписать — attributes или file
        signType: attributesInnerSign.type;
        // Код провайдера
        codeProvider: 'signProvider';
        // ID файла в формате base64
        body: attributesInnerSign.body,
        // Хеш подписанных данных (необходим для идентификации версии подписываемых данных)
        hash: attributesInnerSign.hash,
    }
     
    await appData.uploadSign(newSign);
}

Получение файла подписанных атрибутов и файла подписи

Для получения содержимого подписанных атрибутов и самой подписи используются методы createAttributesFile и EntitySign.createSignFile. Для того чтобы получить EntitySign, необходимо получить историю подписей элемента приложения. Для нахождения необходимой версии подписи в истории можно воспользоваться внутренней подписью приложения:

async function getSignsFiles(): Promise<void> {
    // Получение приложения типа Документ из контекста пользовательского сценария
    const app = Context.data.document!;
    // Получение данных приложения
    const appData = await app.fetch();
    // Получение истории подписей элемента приложения
    const signsHistory = await appData.getSignHistory();
    // Получение внутренних подписей
    const innerSigns = await appData.getDataSigns();

    // Найдем внутреннюю подпись атрибутов, чтобы подписать данные с помощью криптопровайдера
    const attributesInnerSign = innerSigns.find(innerSign => innerSign.type === SignType.Attributes);
    if (!attributesInnerSign) {
        throw new Error('Внутренняя подпись не найдена');
    }

    // Найдем в архиве подпиcей подписи последней версии элемента приложения
    const signs = signsHistory.find(signs => signs.hash === attributesInnerSigns.hash);
    if (!signs) {
        throw new Error('Данная версия не подписана');
    }

    const dataSign = signs.signs[0];

    const attributesFile = await dataSign.createAttributesFile();
    const signFile = await dataSign.createSignFile();
}

Получение детальной информации о подписи

В системе можно получить детальные данные о подписи, включающие в себя:

• информацию о самой подписи;
• содержимое подписи;
• информацию о публичном ключе, с помощью которого выполнено подписание данных;
• подписанные данные.

Для получения данных необходимо вызвать метод EntitySign.getDetails. Данный метод позволяет получить детальные данные о подписи. Рассмотрим ситуацию, когда в пользовательском сценарии необходимо определить, юридическим или физическим лицом выполнена подпись. Для этого необходимо получить подпись из истории и вызвать метод EntitySign.getDetails. После получения данных необходимо проанализировать содержимое сертификата:

async function whoMadeSign(): Promise<void> {
    // Получение приложения типа Документ из контекста пользовательского сценария
    const app = Context.data.document!;
    // Получение данных приложения
    const appData = await app.fetch();
    // Получение истории подписей приложения
    const signsHistory = await appData.getSignHistory();
    // Получение последней подписи
    const sign = signsHistory[0].signs[0];
    // Получение информации о подписи
    const signDetails = await sign.getDetails();
    
    // Если заполнено одно из этих полей, то подпись выполнена юридическим лицом
    // Также для таких проверок можно использовать и другие поля сертификата, в зависимости
    // от провайдера, выдавшего цифровую подпись
    const orgField = signDetails.subject['O'] || signDetails.subject['OU'];
    
    if (orgField !== '') {
        // Подпись для юридического лица
    } else {
        // Подпись для физического лица
    }
    
}