Инструменты пользователя

Инструменты сайта


iis-signature-api

Описание API веб-сервиса для формирования ЭЦП

Адрес веб-сервиса:

https://signature.tunduk.kg

Формирование ЭЦП

Авторизация:

Authorization: Bearer [access_token]

access_token должен быть выдан ЕСИ и должен содержать обязательный scope: signature_api

Пример access_token:

Относительный путь метода сервиса формирования ЭЦП:

POST /Api/V1/Signature/Create

Формат входных данных:

content-type: application/json

Входные данные:

{
 "hash":"строка в формате hexadecimal string должна содержать символы удовлетворяющему регулярному выражению ^[a-fA-F0-9]+$, количество символов от 64 до 256",
 "password":"пароль пользователя от облачного эцп, количество символов от 6 до 256"
}

Ответ от сервера при успешном формировании ЭЦП:

{
   "succeeded":"true",
   "body": {
      "pkcs7": "сообщение в формате PKCS#7/SignedCMS"
   }
}

Ответа от сервера в случае ошибки:

{
   "succeeded":"false", 
   "errors": [
     {
        "code":"код ошибки",
        "description" : "описание ошибки"
     }
   ]
}

коды ошибок: InternalServerError, NoCertificateFound, InvalidPasswordError

Валидация ЭЦП

Относительный путь:

POST /Api/V1/Signature/Verify

Авторизация:

не требуется

Формат входных данных:

content-type: application/json

Входные данные:

{
  "Pkcs7": "сообщение в формате PKCS#7 (закодированный в base64)",
  "Hash": "Хэш для верификации, удовлетворяющий регулярному выражению ^[a-fA-F0-9]+$, длиною от 64 до 256 символов"
}

Ответ от сервера при верификации:

{
  "succeeded":true,
  "body": {
    "verificationResult": "флаг отвечающий за результат верификации, true - ЭЦП валиден, false - не валиден"
  }
}

Ответа от сервера при технической ошибке:

{
  "succeeded":false,
  "errors": [{
    "code":"код ошибки (не число, не стоит путать его HTTP кодом)",
    "description": "описание ошибки"
  }]
}
iis-signature-api.txt · Последние изменения: 2020/10/23 08:17 — admin1