Документація · Початок

Швидкий старт

DSTUcrypt — готові iframe-віджети КЕП для вашого сайту: підпис, перевірка, шифрування, сертифікати та вхід за КЕП. Віджети завантажуються тільки з dstucrypt.io — ви нічого не встановлюєте й не хостите.

Підключення — один імпорт

import { embed } from 'https://dstucrypt.io/embed/dstucrypt-embed.mjs';

const signer = await embed('sign', { mount: 'modal' });
const { signature } = await signer.sign(file, { format: 'CAdES-T', digest: 'gost-34311' });
signature.download('document.p7s');

Віджети

Тип Сторінка віджета Що робить Ключ/пароль
sign /embed/sign.html Підпис документів всередині iframe
verify /embed/verify.html Перевірка підпису не потрібні
auth /embed/auth.html Вхід за КЕП всередині iframe
encrypt /embed/encrypt.html Шифрування не потрібні
decrypt /embed/decrypt.html Розшифрування всередині iframe
cert /embed/cert.html Сертифікати не потрібні

Параметри embed(type, opts)

URL файлів ви не передаєте — SDK будує адресу віджета сам, з dstucrypt.io. Достатньо дії (перший аргумент) і опцій:

Опція Значення Опис
mount 'modal' | CSS-селектор | Element модальне вікно (за замовчуванням) або вбудувати у ваш блок ('#box')
session true | { ttlMinutes, noPin } автоматичний режим — збережений ключ без пароля щоразу (sign/decrypt/auth)
branding false прибрати бейдж «Захищено DSTUcrypt» (платна опція)
theme / styles / css / brand об'єкти / рядок Персональний дизайн — тема, CSS і власний бренд (платна опція)
allowOrigin origin обмежити приймання postMessage конкретним origin (зазвичай не потрібно)

Кожен віджет — окремий iframe на одну задачу. У модалці iframe автоматично росте під вміст. Коли віджет більше не потрібен — widget.destroy().

Є ще службовий src (override URL віджета) — лише для локальної розробки; у звичайній інтеграції не використовується.

Результат — Bytes, без base64

Методи віджетів повертають байти в обгортці Bytes:

signature.bytes        //  Uint8Array
signature.size         //  число байтів
signature.text()       //  як рядок (якщо це текст)
signature.download('document.p7s')   //  завантажити файл
signature.base64       //  base64-рядок (для передачі на бекенд у JSON)

На вхід методи приймають File, Uint8Array, ArrayBuffer або рядок — конвертації не потрібні.

Ліцензія і випробувальний період

  • 7 днів безкоштовно на кожному новому домені — автоматично, без реєстрації: просто підключіть віджет. У віджеті буде плашка з залишком днів.
  • localhost — завжди безкоштовно (режим розробника, з плашкою).
  • Далі — базова підписка 4 500 грн/міс або 38 880 грн/рік на домен. Керування доменами й оплата — в особистому кабінеті (LiqPay).
  • Коли період завершено, віджет на домені зупиняється автоматично.

Питання й підключення: sale@dstucrypt.com.ua.