Робота з API порталу EDIN ID

• Перелік методів API по роботі з порталом EDIN ID
• Шифрування пароля за допомогою відкритого ключа RSA
• Методи API
• Отримати і зберегти публічний ключ GET /api/external/key
• Підписати хеш ключем співробітника компанії POST /api/external/company/sign
• Підписати файл ключем співробітника компанії POST /api/external/company/sign/file
• Помилки при роботі з API

Перелік методів API по роботі з порталом EDIN ID

Всі запити нижче перерахованих API методів порталу EDIN ID направляються на адресу: https://id.edin.ua

Для підписання хеш(ів) та/або файлу пароль передається в зашифрованому вигляді.

Отримати і зберегти публічний ключ	GET /api/external/key
Підписати хеш ключем співробітника компанії	POST /api/external/company/sign
Підписати файл ключем співробітника компанії	POST /api/external/company/sign/file

Колекція Postman

Шифрування пароля за допомогою відкритого ключа RSA

Функції для шифрування

/**
 * Encrypt data with RSA public key
 * @param publicKey - get from server
 * @param password - user key password
 */
utils = {
    rsaEncrypt: async function(publicKey, password) {
        const cryptoKey = await crypto.subtle.importKey("spki", publicKey, {
            name: "RSA-OAEP",
            hash: "SHA-256"
        }, true, ["encrypt"]);
        const encodedText = new TextEncoder().encode(password);
        const encrypted = await crypto.subtle.encrypt({name: "RSA-OAEP"}, cryptoKey, encodedText);
        //
        return toBase64(encrypted);
    }
}

function toBase64(buffer) {
    const bytes = new Uint8Array(buffer);
    let binary = '';
    for (let i = 0; i < bytes.byteLength; i++) {
        binary += String.fromCharCode(bytes[i]);
    }
    return btoa(binary);
}

Шифрування пароля

const encrypted = await utils.rsaEncrypt(Uint8Array.from(publicKey), password));

де, 

• publicKey - публічний ключ, отриманий методом GET /api/external/key
• password - пароль від ключа

Методи API

Отримати і зберегти публічний ключ GET /api/external/key

REQUEST

RESPONSE

В тілі відповіді повертається ключ у вказаному форматі:

• якщо type = JSON – повертається масив байт
• якщо type = PEM – повертається PEM-файл у вигляді

  -----BEGIN PUBLIC KEY-----
  MIGfMA0GCSqGSIb3DQEBAQ9QIDAQAB
  -----END PUBLIC KEY-----

• якщо type = XML – повертається XML-файл у вигляді

  <?xml version="1.0"?>
  <RSAKeyValue>
    <Modulus>wxWy8iReusbmiadsULVLSD36+l5k6cZ0=</Modulus>
    <Exponent>AQAB</Exponent>
  </RSAKeyValue>
  

Для type in (PEM, XML) в reponse-header передається параметр x-key-ttl, в якому передається термін життя відкритого ключа.

Підписати хеш ключем співробітника компанії POST /api/external/company/sign

REQUEST

RESPONSE

В тілі відповіді повертається масив підписів.

Підписати файл ключем співробітника компанії POST /api/external/company/sign/file

REQUEST

RESPONSE

В тілі відповіді повертається код 200 та результат підписання відповідно до параметрів result та outputFormat.

Помилки при роботі з API

Загальні помилки

Помилки підписання хешів

Помилки підписання файлів