Установка

npm install @it-enterprise/digital-signature-ui

Инициализация

import eds from "@it-enterprise/digital-signature-ui";

const options = {
  ApiUrl, // Путь к Api
  UserId, // id пользователя (для сохранения ключей и предпочитаемого типа ключа, может быть функция)
  Language, // Язык (Может быть функция),
  Vuetify // Vuetify,
  i18n // i18n (необязательно)
};

Vue.use(eds, options);

Ключ

Считать ключ

await this.$eds.readPrivateKey(
  // Параметры ключа
  keyParams);

Проверить считан ли ключ

const isReaded = await this.$eds.isPrivateKeyReaded();

Очистить считанный ключ

this.$eds.clearKey();

Получить информацию о считаном ключе, считать ключ если требуется

const keyInfo = await this.$eds.getPrivateKeyInfo();

Подписание

Подписание данных

const sign = await this.$eds.signData(
  // Данные в виде Uint8Array или строки base64. Можно передавать данные в массиве
  data,
  // Тип подписи
  signType,
  // true - вернуть результат в виде массива байт,false - в виде строки base64. по умолчанию false
  false);

Подписание файла

const sign = await this.$eds.signFile(
  // Ссылка на загрузку файла (например, с веб-сервисов). Можно передать массив ссылок
  data,
  // Тип подписи
  signType,
  // true - вернуть результат в виде массива байт,false - в виде строки base64. по умолчанию false
  false);

Подписание хеша

const sign = await this.$eds.signHash(
  // Хеш в виде Uint8Array или строки base64. Можно передавать данные в массиве
  hash,
  // true - вернуть результат в виде массива байт,false - в виде строки base64. по умолчанию false
  false);

Подписание хеша из файла

const sign = await this.$eds.signFileHash(
  // Ссылка на загрузку файла с хешем. Можно передать массив ссылок
  hashUrl,
  // true - вернуть результат в виде массива байт,false - в виде строки base64. по умолчанию false
  false);

Подписание данных с получением информации о подписи

const sign = await this.$eds.signDataEx(
  // Данные в виде Uint8Array или строки base64. Можно передавать данные в массиве
  data,
  // Тип подписи
  signType);

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

const sign = await this.$eds.signFileEx(
  // Ссылка на загрузку файла (например, с веб-сервисов). Можно передать массив ссылок
  data,
  // подписывать хеш
  false);

Верификация

Проверить подпись (Соответствие подписанных данных не проверяется)

await this.$eds.verifyData(
  // Подписанные данные
  data,
  // Подпись
  sign,
  // Номер подписи. -1 что бы проверить все подписи
  signIndex);

Проверить внешнюю подпись файла

await this.$eds.verifyFile(
  // Ссылка на загрузку файла
  fileUrl,
  // Ссылка на загрузку подписи
  signUrl,
  // Номер подписи. -1 что бы проверить все подписи
  signIndex);

Проверить внутреннюю подпись

await this.$eds.verifyDataInternal(
  // Подпись с данными
  sign,
  // Номер подписи. -1 что бы проверить все подписи
  signIndex);

Проверить внутреннюю подпись

await this.$eds.verifyFileInternal(
  // Подпись с данными
  fileUrl,
  // Номер подписи. -1 что бы проверить все подписи
  signIndex);

Проверить подпись хеша

await this.$eds.verifyHash(
  // Хеш подписанного файла
  hash,
  //Подпись
  sign,
  // Номер подписи. -1 что бы проверить все подписи
  signIndex);

Проверить подпись хеша из файла

await this.$eds.verifyHash(
  // Ссылка на загрузку файла
  hashUrl,
  // Ссылка на загрузку подписи
  signUrl,
  // Номер подписи. -1 что бы проверить все подписи
  signIndex);

Шифрование

Зашифровать данные

const envelopedData = await this.$eds.envelopData(
  // Данные, которые необходимо зашифровать
  data,
  // Сертификаты получателей
  recipientCertificates,
  // Возвращать результат в виде массива байтов. По умолчанию результат возвращается в виде строки BASE64
  true);

Зашифровать файл

const envelopedFile = await this.$eds.envelopFile(
  // Ссылка на загрузку файла
  fileUrl,
  // Сертификаты получателей
  recipientCertificates,
  // Возвращать результат в виде массива байтов. По умолчанию результат возвращается в виде строки BASE64
  true);

Расшифровать данные

const developedData = await this.$eds.developData(
  // Зашифрованные данные в виде строки BASE64 или массива байт
  envelopedData,
  // Сертификат отправителя
  senderCert);

Расшифровать файл

const developedFile = await this.$eds.developFile(
  // Ссылка на зашифрованный файл ссылок
  envelopedFileUri,
  // Сертификат отправителя
  senderCert);