3.7 KiB

Raw Blame History Unescape Escape

API Документация для CertCenter (POST-запросы, поддержка JSON)

Базовый адрес: http://127.0.0.1:4567

1. Получение токена

curl -X POST http://127.0.0.1:4567/api/v1/login \
  -H "Content-Type: application/json" \
  -d '{"login":"admin","password":"admin"}'

Ответ
{ "error": null, "content": { "token": "<JWT>" } }
Сохраняйте значение token для последующих запросов.

2. Список серверных сертификатов

curl -X POST http://127.0.0.1:4567/api/v1/servers \
  -H "Content-Type: application/json" \
  -d '{"token":"<JWT>"}'

3. Список клиентских сертификатов

curl -X POST http://127.0.0.1:4567/api/v1/clients \
  -H "Content-Type: application/json" \
  -d '{"token":"<JWT>"}'

4. Детальная информация о сертификате

curl -X POST http://127.0.0.1:4567/api/v1/certinfo/123 \
  -H "Content-Type: application/json" \
  -d '{"token":"<JWT>"}'

5. Детальная информация о корневом сертификате центра сертификации

curl -X POST http://127.0.0.1:4567/api/v1/root \
  -H "Content-Type: application/json" \
  -d '{"token":"<JWT>"}'

6. Отзыв сертификата

curl -X POST http://127.0.0.1:4567/api/v1/revoke/123 \
  -H "Content-Type: application/json" \
  -d '{"token":"<JWT>"}'

7. Добавление клиентского сертификата

curl -X POST http://127.0.0.1:4567/api/v1/addclient \
  -H "Content-Type: application/json" \
  -d '{"token":"<JWT>","server_domain":"example.com","client":"client1"}'

8. Добавление серверного сертификата

curl -X POST http://127.0.0.1:4567/api/v1/addserver \
  -H "Content-Type: application/json" \
  -d '{"token":"<JWT>","domains":"example.com,example.org","validity_days":365}'

9. Список пользователей (admin)

curl -X POST http://127.0.0.1:4567/api/v1/ulist \
  -H "Content-Type: application/json" \
  -d '{"token":"<JWT>"}'

10. Удаление пользователя

curl -X POST http://127.0.0.1:4567/api/v1/deleteuser/42 \
  -H "Content-Type: application/json" \
  -d '{"token":"<JWT>"}'

11. Создание пользователя

curl -X POST http://127.0.0.1:4567/api/v1/adduser \
  -H "Content-Type: application/json" \
  -d '{"token":"<JWT>","login":"jane","password":"secret","email":"jane@example.com","role":1}'

12. Редактирование пользователя

curl -X POST http://127.0.0.1:4567/api/v1/edituser/42 \
  -H "Content-Type: application/json" \
  -d '{"token":"<JWT>","login":"jane","password":"newpass","role":2}'

13. Установка и подготовка структуры центра сертификации

curl -X POST http://127.0.0.1:4567/api/v1/install \
  -H "Content-Type: application/json" \
  -d '{"cert-path":"/tmp","org-name":"neworg","common-name":"name","cert-password":"pass","country-name": "RU", "validity-days":"3650"}'

14. Обработка ошибок

Если сервер возвращает статус 400, то это ошибка синтаксиса JSON:

{ "error": "Invalid JSON", "content": null }

Если токен недействителен или истёк, будет:

{ "error": "Токен устарел", "content": null }

При других ошибках сервер выдаёт { "error": "...", "content": "..." } в формате JSON.

3.7 KiB Raw Blame History Unescape Escape