Skip to content

Latest commit

 

History

History
538 lines (380 loc) · 31.5 KB

API.md

File metadata and controls

538 lines (380 loc) · 31.5 KB

Classes

NCALayerError

Класс ошибок NCALayerError.

NCALayerClient

Класс клиента NCALayer.

NCALayerError

Класс ошибок NCALayerError.

Kind: global class

NCALayerClient

Класс клиента NCALayer.

Kind: global class

new NCALayerClient([url])

Конструктор.

Param Type Default Description
[url] String 'wss://127.0.0.1:13579' опциональный URL для подключения к NCALayer.

(async) ncaLayerClient.connect() ⇒ Promise.<String>

Подключиться к NCALayer.

Kind: instance method of NCALayerClient
Returns: Promise.<String> - версию NCALayer.
Throws:

  • NCALayerError

(async) ncaLayerClient.basicsSign(allowedStorages, format, data, signingParams, signerParams, locale) ⇒ Promise.<String>

Вычислить подпись под данными с указанными параметрами. Новая функция sign 2022 года из модуля kz.gov.pki.knca.basics (https://github.com/pkigovkz/sdkinfo/wiki/KNCA-Basics-Module). Сигнатура функции сложная, поэтому рекомендуем пользоваться функциями помощниками basicsSignXLM и basicsSignCMS.

Kind: instance method of NCALayerClient
Returns: Promise.<String> - подпись.
Throws:

  • NCALayerError
Param Type Description
allowedStorages Array массив строк с константами допустимых для использования типов хранилищ (см. константы basicsStorage*).
format String тип вычисляемой подписи: 'xml', либо 'cms'.
data String подписываемые данные.
signingParams Object параметры подписания (см. basicsCMSParams* и basicsXMLParams*).
signerParams Object параметры выбора сертификата для подписания (см. константы basicsSigner*).
locale String язык пользовательского интерфейса.

(async) ncaLayerClient.basicsSignCMS(allowedStorages, data, signingParams, signerParams, [locale]) ⇒ Promise.<String>

Вычислить CMS подпись под данными с указанными параметрами, это функция-помощник для упрощения работы с функцией basicsSign.

Kind: instance method of NCALayerClient
Returns: Promise.<String> - подпись.
Throws:

  • NCALayerError
Param Type Default Description
allowedStorages Array массив строк с константами допустимых для использования типов хранилищ (см. константы basicsStorage*).
data String | ArrayBuffer | Array данные, которые нужно подписать, в виде строки Base64 либо ArrayBuffer. Так же поддерживается массив строк Base64 или ArrayBuffer, но это будет работать только с приложениями KAZTOKEN mobile/desktop, NCALayer не умеет подписывать массив документов.
signingParams Object параметры подписания (см basicsCMSParams*).
signerParams Object параметры выбора сертификата для подписания (см. константы basicsSigner*).
[locale] String 'ru' язык пользовательского интерфейса.

(async) ncaLayerClient.basicsSignXML(allowedStorages, data, signingParams, signerParams, [locale]) ⇒ Promise.<String>

Вычислить XML подпись под данными с указанными параметрами, это функция-помощник для упрощения работы с функцией basicsSign.

Kind: instance method of NCALayerClient
Returns: Promise.<String> - подпись.
Throws:

  • NCALayerError
Param Type Default Description
allowedStorages Array массив строк с константами допустимых для использования типов хранилищ (см. константы basicsStorage*).
data String подписываемые данные.
signingParams Object параметры подписания (см basicsXMLParams*).
signerParams Object параметры выбора сертификата для подписания (см. константы basicsSigner*).
[locale] String 'ru' язык пользовательского интерфейса.

(async) ncaLayerClient.getActiveTokens() ⇒ Promise.<Array.<String>>

Получить список активных типов устройств.

Kind: instance method of NCALayerClient
Returns: Promise.<Array.<String>> - массив содержащий типы хранилищ экземпляры которых доступны в данный момент.
Throws:

  • NCALayerError

(async) ncaLayerClient.getKeyInfo(storageType) ⇒ Promise.<Object>

Получить информацию об одной записи (ключевой паре с сертификатом).

Kind: instance method of NCALayerClient
Returns: Promise.<Object> - объект с информацией о записи.
Throws:

  • NCALayerError
Param Type Description
storageType String тип хранилища на экземплярах которого следует искать записи.

(async) ncaLayerClient.createCAdESFromBase64(storageType, data, [keyType], [attach]) ⇒ Promise.<String>

Вычислить подпись под данными и сформировать CMS (CAdES).

Kind: instance method of NCALayerClient
Returns: Promise.<String> - CMS подпись в виде Base64 строки.
Throws:

  • NCALayerError
Param Type Default Description
storageType String тип хранилища который следует использовать для подписания.
data String | ArrayBuffer | Array данные, которые нужно подписать, в виде строки Base64 либо ArrayBuffer. Так же поддерживается массив строк Base64 или ArrayBuffer, но это будет работать только с приложениями KAZTOKEN mobile/desktop, NCALayer не умеет подписывать массив документов.
[keyType] String 'SIGNATURE' каким типом ключа следует подписывать, поддерживаемые варианты 'SIGNATURE' и 'AUTHENTICATION', иное значение позволит пользователю выбрать любой доступный в хранилище ключа.
[attach] Boolean false следует ли включить в подпись подписываемые данные.

(async) ncaLayerClient.createCAdESFromBase64Hash(storageType, hash, [keyType]) ⇒ Promise.<String>

Вычислить подпись под хешем данных и сформировать CMS (CAdES).

Kind: instance method of NCALayerClient
Returns: Promise.<String> - CMS подпись в виде Base64 строки.
Throws:

  • NCALayerError
Param Type Default Description
storageType String тип хранилища который следует использовать для подписания.
hash String | ArrayBuffer | Array хеш данных в виде строки Base64 либо ArrayBuffer. Так же поддерживается массив строк Base64 или ArrayBuffer, но это будет работать только с приложениями KAZTOKEN mobile/desktop, NCALayer не умеет подписывать массив хешей.
[keyType] String 'SIGNATURE' каким типом ключа следует подписывать, поддерживаемые варианты 'SIGNATURE' и 'AUTHENTICATION', иное значение позволит пользователю выбрать любой доступный в хранилище ключа.

(async) ncaLayerClient.createCAdESFromFile(storageType, filePath, [keyType], [attach]) ⇒ Promise.<String>

Вычислить подпись файла и сформировать CMS (CAdES).

Kind: instance method of NCALayerClient
Returns: Promise.<String> - CMS подпись в виде Base64 строки.
Throws:

  • NCALayerError
Param Type Default Description
storageType String тип хранилища который следует использовать для подписания.
filePath String путь к подписываемому файлу.
[keyType] String 'SIGNATURE' каким типом ключа следует подписывать, поддерживаемые варианты 'SIGNATURE' и 'AUTHENTICATION', иное значение позволит пользователю выбрать любой доступный в хранилище ключа.
[attach] Boolean false следует ли включить в подпись подписываемые данные.

(async) ncaLayerClient.createCMSSignatureFromBase64(storageType, data, [keyType], [attach]) ⇒ Promise.<String>

Подписать блок данных и сформировать CMS (CAdES) подпись с интегрированной меткой времени TSP. Не рекомендуется использовать, разработчики NCALayer пометили как DEPRECATED (https://forum.pki.gov.kz/t/podpis-s-metkoj-vremeni-na-js/704/7)!

Kind: instance method of NCALayerClient
Returns: Promise.<String> - CMS подпись в виде Base64 строки.
Throws:

  • NCALayerError
Param Type Default Description
storageType String тип хранилища который следует использовать для подписания.
data String | ArrayBuffer | Array данные, которые нужно подписать, в виде строки Base64 либо ArrayBuffer. Так же поддерживается массив строк Base64 или ArrayBuffer, но это будет работать только с приложениями KAZTOKEN mobile/desktop, NCALayer не умеет подписывать массив документов.
[keyType] String 'SIGNATURE' каким типом ключа следует подписывать, поддерживаемые варианты 'SIGNATURE' и 'AUTHENTICATION', иное значение позволит пользователю выбрать любой доступный в хранилище ключа.
[attach] Boolean false следует ли включить в подпись подписываемые данные.

(async) ncaLayerClient.createCMSSignatureFromFile(storageType, filePath, [keyType], [attach]) ⇒ Promise.<String>

Подписать выбранный файл и сформировать CMS (CAdES) подпись с интегрированной меткой времени TSP. Не рекомендуется использовать, разработчики NCALayer пометили как DEPRECATED (https://forum.pki.gov.kz/t/podpis-s-metkoj-vremeni-na-js/704/7)!

Kind: instance method of NCALayerClient
Returns: Promise.<String> - CMS подпись в виде Base64 строки.
Throws:

  • NCALayerError
Param Type Default Description
storageType String тип хранилища который следует использовать для подписания.
filePath String путь в файловой системе.
[keyType] String 'SIGNATURE' каким типом ключа следует подписывать, поддерживаемые варианты 'SIGNATURE' и 'AUTHENTICATION', иное значение позволит пользователю выбрать любой доступный в хранилище ключа.
[attach] Boolean false следует ли включить в подпись подписываемые данные.

(async) ncaLayerClient.signXml(storageType, xml, [keyType], [tbsElementXPath], [signatureParentElementXPath]) ⇒ Promise.<String>

Вычислить подпись под документом в формате XML.

Kind: instance method of NCALayerClient
Returns: Promise.<String> - XML документ содержащий XMLDSIG подпись.
Throws:

  • NCALayerError
Param Type Default Description
storageType String тип хранилища который следует использовать для подписания.
xml String XML данные которые нужно подписать.
[keyType] String 'SIGNATURE' каким типом ключа следует подписывать, поддерживаемые варианты 'SIGNATURE' и 'AUTHENTICATION', иное значение позволит пользователю выбрать любой доступный в хранилище ключа.
[tbsElementXPath] String '' путь к подписываемому узлу XML.
[signatureParentElementXPath] String '' путь к узлу в который необходимо добавить сформированную подпись.

(async) ncaLayerClient.signXmls(storageType, xmls, [keyType], [tbsElementXPath], [signatureParentElementXPath]) ⇒ Promise.<Array.<String>>

Вычислить подпись под каждым из массива документов в формате XML.

Kind: instance method of NCALayerClient
Returns: Promise.<Array.<String>> - массив XML документов содержащих XMLDSIG подписи.
Throws:

  • NCALayerError
Param Type Default Description
storageType String тип хранилища который следует использовать для подписания.
xmls Array.<String> массив XML данных которые нужно подписать.
[keyType] String 'SIGNATURE' каким типом ключа следует подписывать, поддерживаемые варианты 'SIGNATURE' и 'AUTHENTICATION', иное значение позволит пользователю выбрать любой доступный в хранилище ключа.
[tbsElementXPath] String '' путь к подписываемому узлу XML.
[signatureParentElementXPath] String '' путь к узлу в который необходимо добавить сформированную подпись.

(async) ncaLayerClient.showFileChooser([fileExtension], [currentDirectory]) ⇒ Promise.<String>

Открывает диалоговое окно для выбора файла.

Kind: instance method of NCALayerClient
Returns: Promise.<String> - полный путь к файлу.
Throws:

  • NCALayerError
Param Type Default Description
[fileExtension] String 'ALL' расширение для выбора файла.
[currentDirectory] String '' путь выбираемого файла.

(async) ncaLayerClient.changeLocale(localeId)

Изменить язык интерфейса NCALayer.

Kind: instance method of NCALayerClient
Throws:

  • NCALayerError
Param Type Description
localeId String новый идентификатор языка.

NCALayerClient.basicsStorageKAZTOKEN

KAZTOKEN

Kind: static property of NCALayerClient

NCALayerClient.basicsStorageIDCard

Удостоверение личности

Kind: static property of NCALayerClient

NCALayerClient.basicsStorageEToken72k

eToken 72k

Kind: static property of NCALayerClient

NCALayerClient.basicsStorageEToken5110

eToken 5110

Kind: static property of NCALayerClient

NCALayerClient.basicsStorageJaCarta

JaCarta

Kind: static property of NCALayerClient

NCALayerClient.basicsStorageAKey

aKey

Kind: static property of NCALayerClient

NCALayerClient.basicsStoragePKCS12

Файловле хранилище PKCS#12

Kind: static property of NCALayerClient

NCALayerClient.basicsStorageJKS

Файловле хранилище JKS

Kind: static property of NCALayerClient

NCALayerClient.basicsStorageAll

Любые хранилища.

Kind: static property of NCALayerClient

NCALayerClient.basicsStorageHardware

Только аппаратные хранилища.

Kind: static property of NCALayerClient

NCALayerClient.basicsCMSParams

Параметры подписания для формирования CMS по умолчанию.

Kind: static property of NCALayerClient

NCALayerClient.basicsCMSParamsDetached

Параметры подписания для формирования CMS без вложенных данных из данных в Base64.

Kind: static property of NCALayerClient

NCALayerClient.basicsCMSParamsDetachedHash

Параметры подписания для формирования CMS без вложенных данных из хеша данных в Base64.

Kind: static property of NCALayerClient

NCALayerClient.basicsCMSParamsAttached

Параметры подписания для формирования CMS с вложенными данными из данных в Base64.

Kind: static property of NCALayerClient

NCALayerClient.basicsXMLParams

Параметры подписания для формирования XML по умолчанию.

Kind: static property of NCALayerClient

NCALayerClient.basicsSignerAny

Любой сертификат выпущенный боевым УЦ НУЦ.

Kind: static property of NCALayerClient

NCALayerClient.basicsSignerSignAny

Любой сертификат для подписания выпущенный боевым УЦ НУЦ.

Kind: static property of NCALayerClient

NCALayerClient.basicsSignerSignPerson

Сертификат физического лица для подписания выпущенный боевым УЦ НУЦ.

Kind: static property of NCALayerClient

NCALayerClient.basicsSignerSignOrg

Сертификат любого сотрудника юридического лица для подписания выпущенный боевым УЦ НУЦ.

Kind: static property of NCALayerClient

NCALayerClient.basicsSignerSignHead

Сертификат руководителя юридического лица для подписания выпущенный боевым УЦ НУЦ.

Kind: static property of NCALayerClient

NCALayerClient.basicsSignerSignTrusted

Сертификат лица с правом подписи юридического лица для подписания выпущенный боевым УЦ НУЦ.

Kind: static property of NCALayerClient

NCALayerClient.basicsSignerSignEmployee

Сертификат сотрудника юридического лица для подписания выпущенный боевым УЦ НУЦ.

Kind: static property of NCALayerClient

NCALayerClient.basicsSignerAuthAny

Любой сертификат для аутентификации выпущенный боевым УЦ НУЦ.

Kind: static property of NCALayerClient

NCALayerClient.basicsSignerAuthPerson

Сертификат физического лица для аутентификации выпущенный боевым УЦ НУЦ.

Kind: static property of NCALayerClient

NCALayerClient.basicsSignerAuthOrg

Сертификат любого сотрудника юридического лица для аутентификации выпущенный боевым УЦ НУЦ.

Kind: static property of NCALayerClient

NCALayerClient.basicsSignerAuthHead

Сертификат руководителя юридического лица для аутентификации выпущенный боевым УЦ НУЦ.

Kind: static property of NCALayerClient

NCALayerClient.basicsSignerAuthRight

Сертификат лица с правом подписи юридического лица для аутентификации выпущенный боевым УЦ НУЦ.

Kind: static property of NCALayerClient

NCALayerClient.basicsSignerAuthEmployee

Сертификат сотрудника юридического лица для аутентификации выпущенный боевым УЦ НУЦ.

Kind: static property of NCALayerClient

NCALayerClient.basicsSignerTestAny

Любой сертификат выпущенный боевым или тестовым УЦ НУЦ.

Kind: static property of NCALayerClient

NCALayerClient.fileStorageType

Константа определяющая имя файлового хранилища.

Kind: static property of NCALayerClient