Метод получения активного ЦС

GET API – Получение активного ЦС

Метод доступен администратору и оператору

URL – certificate-authority-service/api/v3/public/certificate-authorities/active

Swagger: https://HOST/external-integration-service/swagger/swagger-ui/index.html#/[v3] Контроллер%3A Центры сертификации/active

Query

 

-


Request

 

-


Response

 

ResponseEntity -> ItemResponse -> {

Ответ JSON в HTTP-body

  id (UUID),

ID ЦС

  isActive (boolean),

Флаг: активный ЦС

active (boolean),

Флаг: активный ЦС

isManagement (boolean),

Флаг: технологический ЦС

management (boolean),

Флаг: технологический ЦС

certificate: {

Сертификат ЦС

id (UUID),

Идентификатор сертификата ЦС

issuerId (UUID),

Идентификатор издателя сертификата ЦС

issuerFingerprint (string),

Фингерпринт издателя сертификата ЦС

serialnumber (string),

Серийный номер сертификата ЦС

fingerprint (string),

Фингерпринт сертификата ЦС

issuerDN: {

Имя субъекта издателя сертификата ЦС

(enum: CN, UID, E, EMAILADDRESS, MAIL, SN, GIVENNAME, INITIALS, SURNAME, OU, O, L, ST, DC, C, UNSTRUCTUREDADDRESS, UNSTRUCTUREDNAME, POSTALCODE, BUSINESSCATEGORY, TELEPHONENUMBER, PSEUDONYM, POSTALADDRESS, STREET, NAME, T, DN, DESCRIPTION, INN, OGRN, OGRNIP, SNILS, INNLE, UNKNOWN): string[]

Поля разделенного имени субъекта издателя из сертификата. В формате key-value. Где key – один из перечисленных в enum параметров, а value – значение параметра


},

 

subjectDN: {

Имя субъекта сертификата ЦС

(enum: CN, UID, E, EMAILADDRESS, MAIL, SN, GIVENNAME, INITIALS, SURNAME, OU, O, L, ST, DC, C, UNSTRUCTUREDADDRESS, UNSTRUCTUREDNAME, POSTALCODE, BUSINESSCATEGORY, TELEPHONENUMBER, PSEUDONYM, POSTALADDRESS, STREET, NAME, T, DN, DESCRIPTION, INN, OGRN, OGRNIP, SNILS, INNLE, UNKNOWN): string[]

Поля разделенного имени субъекта из сертификата. В формате key-value. Где key – один из перечисленных в enum параметров, а value – значение параметра


},

 

subjectAltName: {

Альтернативное имя субъекта сертификата ЦС

(enum: RFC822NAME, DNS_NAME, IPADDRESS, DIRECTORY_NAME, UNIFORM_RESOURCE_ID, REGISTERED_ID, MS_UPN, MS_GUID, KRB5PRINCIPAL, PERMANENT_IDENTIFIER, XMPP_ADDR, SRV_NAME, SUBJECT_IDENTIFICATION_METHOD, UNKNOWN): string[]

Поля альтернативного имени субъекта из сертификата. В формате key-value. Где key – один из перечисленных в enum параметров, а value – значение параметра


},

 

name (string),

Имя сертификата ЦС (на основе CN)

templateId (UUID),

Идентификатор шаблона

templateName (string),

Имя шаблона

validFrom (instant),

Дата начала действия сертификата ЦС (ISO 8601)

validTo (instant),

Дата окончания действия сертификата ЦС (ISO 8601)

status (enum: ACTIVE, HOLD, REVOKE, REQUEST, UNKNOWN),

Статус сертификата ЦС

isValid (boolean),

Флаг: сертификат ЦС действует

isExpired (boolean),

Флаг: сертификат ЦС истек

actions: {

Доступные действия по выгрузке

p12 (boolean),

Флаг: выгрузка pkcs12

csr (boolean),

Флаг: выгрузка pkcs10

pem (boolean)

Флаг: выгрузка сертификата

},

 

revocation: {

Сведения об отзыве сертификата ЦС

date (instant),

Дата отзыва

number (int32),

Код причины отзыва

value (string)

Значение причины отзыва

},

 

hashAlgorithm (enum: SHA1, SHA256, SHA384, SHA512, SHA3_256, SHA3_384, SHA3_512, RSASSA_PSS, MD5, GOST_R_34_11_2012, UNKNOWN),

Алгоритм подписи сертификата ЦС

keyAlgorithm (enum: RSA, ECDSA, GOST_R_34_10_2012, UNKNOWN),

Алгоритм ключа сертификата ЦС

keyBits (int32),

Длина ключа сертификата ЦС

subjectKeyIdentifier (string),

Идентификатор ключа сертификата ЦС

authorityKeyIdentifier (string),

Идентификатор ключа издателя сертификата ЦС

updated (instant),

Время обновления (ISO 8601)

created (instant)

Время создания (ISO 8601)

},

 

chain: {

Цепочка сертификатов ЦС (рекурсивный объект)

id (UUID),

Идентификатор сертификата

name (string),

Имя сертификата (на основе CN)

subjectDN: {

Имя субъекта сертификата ЦС

(enum: CN, UID, E, EMAILADDRESS, MAIL, SN, GIVENNAME, INITIALS, SURNAME, OU, O, L, ST, DC, C, UNSTRUCTUREDADDRESS, UNSTRUCTUREDNAME, POSTALCODE, BUSINESSCATEGORY, TELEPHONENUMBER, PSEUDONYM, POSTALADDRESS, STREET, NAME, T, DN, DESCRIPTION, INN, OGRN, OGRNIP, SNILS, INNLE, UNKNOWN): string[]

Поля разделенного имени субъекта из сертификата. В формате key-value. Где key – один из перечисленных в enum параметров, а value – значение параметра


},

 

issuer: {…}

Издатель сертификата (вложенный объект)

},

 

certificateCount (int64),

Число выпущенных сертификатов

title (string),

Отображаемое имя ЦС

cryptographyProviders: {

Конфигурация криптопровайдеров алгоритмов ЦС

(enum: RSA, ECDSA, GOST_R_34_10_2012, UNKNOWN): {

Название алгоритма

cryptographyProvider (enum: DEFAULT, CRYPTO_PRO, UNKNOWN),

Название криптопровайдера

      isAvailable (boolean),

Флаг: Доступность криптопровайдера

},

 

primaryCryptographyProvider: {

Криптопровайдер закрытого ключа

cryptographyProvider (enum: DEFAULT, CRYPTO_PRO, UNKNOWN),

Название криптопровайдера

isAvailable (boolean),

Флаг: Доступность криптопровайдера

},

 

isAvailable (boolean),

Флаг: Доступность ЦС

updated (instant),

Время обновления (ISO 8601)

created (instant)

Время создания (ISO 8601)

}

 

Пример использования метода

curl -k --location 'https://172.17.152.213/certificate-authority-service/api/v3/public/certificate-authorities/active ' \
 
--header 'Cookie: token=eyJhbGciOiJSUzUxMiJ9.eyJzZXNzaW9uSWQiOiIyOTlmZDhmNy1jZDE0LTQxODQtOGY5Ny04MGZmNmE2MTFhMDEiLCJpYXQiOjE3MDIyNzc3MTQsImV4cCI6MTcwMjI3Nzg5NH0.UbfGfUnP8MqiO9YMur3G6-GeL6xvKNprcOUrvz3G4HkMaZkm_Xo07GsNRWgICJiWRYUGE4DN05vl8CENxtI17GsF4_yiDSm4rYKYPxGr6TITie072NzMNBVvRZSXmXUSxCBHwRzygwdH73QlvleoQhhB1Menio9qiOW6NoKTLFQw6XMTBfUKhGOOK4TwJidlUeQq-SZH_aqV2z-N9A1OegtInd0kkPuiDXwu4zOi8_WGxYCwhFTZ4rWT9c0Jj2A6QQYNTAdyJsLjoixfjTpMaN6I9UoYcaqaU-8g8t53griwfB7qm0F6i5VhzICkVB8_ng-Hr8dYsDYJsJ_HNAO6Mg'

Пример ответа на обращение к методу

{
 
    "status": 200,
 
    "data": {
 
       "id": "45f34462-62a4-4671-9927-f1c6763a4470",
 
       "isActive": true,
 
"active": true,
 
"isManagement": false,
 
       "management": false,
 
       "certificate": {
 
            "id": "da7ca68f-edaf-47a8-bdd9-cb08157f0b4b",
 
            "issuerId": "da7ca68f-edaf-47a8-bdd9-cb08157f0b4b",
 
            "issuerFingerprint": "10faca35d9763c66aa07be57d844092a11ac1040",
 
            "serialnumber": "540ad4f920bd7ae95464ede5c03a3ca4147ce4f0",
 
            "fingerprint": "10faca35d9763c66aa07be57d844092a11ac1040",
 
            "issuerDN": {
 
                "CN": [
 
                    "aladdin"
 
                ],
 
                "OU": [
 
                    "Depnt"
 
                ],
 
                "O": [
 
                    "orgn"
 
                ],
 
                "L": [
 
                    "City"
 
                ],
 
                "DC": [
 
                    "Comnt"
 
                ],
 
                "C": [
 
                    "RU"
 
                ]
 
            },
 
            "subjectDN": {
 
                "CN": [
 
                    "aladdin"
 
                ],
 
                "OU": [
 
                    "Depnt"
 
                ],
 
                "O": [
 
                    "orgn"
 
                ],
 
                "L": [
 
                    "City"
 
                ],
 
                "DC": [
 
                    "Comnt"
 
                ],
 
                "C": [
 
                    "RU"
 
                ]
 
            },
 
            "subjectAltName": {},
 
            "name": "aladdin",
 
            "templateId": "9129245a-eaad-4ebc-a2a4-8845ac0336fb",
 
            "templateName": "Root CA",
 
            "validFrom": "2024-07-30T14:10:27Z",
 
            "validTo": "2034-07-30T14:09:24Z",
 
            "status": "ACTIVE",
 
            "isValid": true,
 
            "isExpired": false,
 
            "actions": {
 
                "p12": false,
 
                "pem": true,
 
                "csr": false
 
            },
 
            "revocation": null,
 
            "hashAlgorithm": "SHA256",
 
            "keyAlgorithm": "RSA",
 
            "keyBits": 1024,
 
            "subjectKeyIdentifier": "51d47e459115bfa6aa567927ca48b6babe1319ae",
 
            "authorityKeyIdentifier": "51d47e459115bfa6aa567927ca48b6babe1319ae",
 
            "created": "2024-07-30T14:10:26.993807Z",
 
            "updated": "2024-07-30T14:10:26.993817Z"
 
        },
 
        "chain": {
 
            "id": "da7ca68f-edaf-47a8-bdd9-cb08157f0b4b",
 
            "name": "aladdin",
 
            "subjectDN": {
 
                "CN": [
 
                    "aladdin"
 
                ],
 
                "OU": [
 
                    "Depnt"
 
                ],
 
                "O": [
 
                    "orgn"
 
                ],
 
                "L": [
 
                    "City"
 
                ],
 
                "DC": [
 
                    "Comnt"
 
                ],
 
                "C": [
 
                    "RU"
 
                ]
 
            },
 
            "issuer": null
 
        },
 
        "certificateCount": 13,
 
        "title": "Root999",
 
        "cryptographyProviders": {
 
            "ECDSA": {
 
                "cryptographyProvider": "DEFAULT",
 
                "isAvailable": true
 
            },
 
            "RSA": {
 
                "cryptographyProvider": "DEFAULT",
 
                "isAvailable": true
 
            }
 
        },
 
        "primaryCryptographyProvider": {
 
            "cryptographyProvider": "DEFAULT",
 
            "isAvailable": true
 
        },
 
        "isAvailable": true,
 
        "created": null,
 
        "updated": null
 
    }
 
}

Метод получения ЦС по идентификатору

GET API – Получение ЦС по идентификатору

Метод доступен администратору

URL – certificate-authority-service/api/v3/public/certificate-authorities/{id}

Swagger: https://HOST/external-integration-service/swagger/swagger-ui/index.html#/[v3] Контроллер%3A Центры сертификации/findById_14

Query

 

{

 

id (UUID)

ID ЦС

}

Request

 

-


Response

 

ResponseEntity -> ItemResponse -> {

Ответ JSON в HTTP-body

id (UUID),

ID ЦС

isActive (boolean),

Флаг: активный ЦС

active (boolean),

Флаг: активный ЦС

isManagement (boolean),

Флаг: технологический ЦС

management (boolean),

Флаг: технологический ЦС

certificate: {

Сертификат ЦС

id (UUID),

Идентификатор сертификата ЦС

issuerId (UUID),

Идентификатор издателя сертификата ЦС

issuerFingerprint (string),

Фингерпринт издателя сертификата ЦС

serialnumber (string),

Серийный номер сертификата ЦС

fingerprint (string),

Фингерпринт сертификата ЦС

issuerDN: {

Имя субъекта издателя сертификата ЦС

(enum: CN, UID, E, EMAILADDRESS, MAIL, SN, GIVENNAME, INITIALS, SURNAME, OU, O, L, ST, DC, C, UNSTRUCTUREDADDRESS, UNSTRUCTUREDNAME, POSTALCODE, BUSINESSCATEGORY, TELEPHONENUMBER, PSEUDONYM, POSTALADDRESS, STREET, NAME, T, DN, DESCRIPTION, INN, OGRN, OGRNIP, SNILS, INNLE, UNKNOWN): string[]

Поля разделенного имени субъекта издателя из сертификата. В формате key-value. Где key – один из перечисленных в enum параметров, а value – значение параметра


},

 

subjectDN: {

Имя субъекта сертификата ЦС

(enum: CN, UID, E, EMAILADDRESS, MAIL, SN, GIVENNAME, INITIALS, SURNAME, OU, O, L, ST, DC, C, UNSTRUCTUREDADDRESS, UNSTRUCTUREDNAME, POSTALCODE, BUSINESSCATEGORY, TELEPHONENUMBER, PSEUDONYM, POSTALADDRESS, STREET, NAME, T, DN, DESCRIPTION, INN, OGRN, OGRNIP, SNILS, INNLE, UNKNOWN): string[]

Поля разделенного имени субъекта из сертификата. В формате key-value. Где key – один из перечисленных в enum параметров, а value – значение параметра


},

 

subjectAltName: {

Альтернативное имя субъекта сертификата ЦС

(enum: RFC822NAME, DNS_NAME, IPADDRESS, DIRECTORY_NAME, UNIFORM_RESOURCE_ID, REGISTERED_ID, MS_UPN, MS_GUID, KRB5PRINCIPAL, PERMANENT_IDENTIFIER, XMPP_ADDR, SRV_NAME, SUBJECT_IDENTIFICATION_METHOD, UNKNOWN): string[]

Поля альтернативного имени субъекта из сертификата. В формате key-value. Где key – один из перечисленных в enum параметров, а value – значение параметра


},

 

name (string),

Имя сертификата ЦС (на основе CN)

templateId (UUID),

Идентификатор шаблона

templateName (string),

Имя шаблона

validFrom (instant),

Дата начала действия сертификата ЦС (ISO 8601)

validTo (instant),

Дата окончания действия сертификата ЦС (ISO 8601)

status (enum: ACTIVE, HOLD, REVOKE, REQUEST, UNKNOWN),

Статус сертификата ЦС

isValid (boolean),

Флаг: сертификат ЦС действует

isExpired (boolean),

Флаг: сертификат ЦС истек

actions: {

Доступные действия по выгрузке

p12 (boolean),

Флаг: выгрузка pkcs12

csr (boolean),

Флаг: выгрузка pkcs10

pem (boolean)

Флаг: выгрузка сертификата

},

 

revocation: {

Сведения об отзыве сертификата ЦС

date (instant),

Дата отзыва

number (int32),

Код причины отзыва

value (string)

Значение причины отзыва

},

 

hashAlgorithm (enum: SHA1, SHA256, SHA384, SHA512, SHA3_256, SHA3_384, SHA3_512, RSASSA_PSS, MD5, GOST_R_34_11_2012, UNKNOWN),

Алгоритм подписи сертификата ЦС

keyAlgorithm (enum: RSA, ECDSA, GOST_R_34_10_2012, UNKNOWN),

Алгоритм ключа сертификата ЦС

keyBits (int32),

Длина ключа сертификата ЦС

subjectKeyIdentifier (string),

Идентификатор ключа сертификата ЦС

authorityKeyIdentifier (string),

Идентификатор ключа издателя сертификата ЦС

updated (instant),

Время обновления (ISO 8601)

created (instant)

Время создания (ISO 8601)

},

 

chain: {

Цепочка сертификатов ЦС (рекурсивный объект)

id (UUID),

Идентификатор сертификата

name (string),

Имя сертификата (на основе CN)

subjectDN: {

Имя субъекта сертификата ЦС

(enum: CN, UID, E, EMAILADDRESS, MAIL, SN, GIVENNAME, INITIALS, SURNAME, OU, O, L, ST, DC, C, UNSTRUCTUREDADDRESS, UNSTRUCTUREDNAME, POSTALCODE, BUSINESSCATEGORY, TELEPHONENUMBER, PSEUDONYM, POSTALADDRESS, STREET, NAME, T, DN, DESCRIPTION, INN, OGRN, OGRNIP, SNILS, INNLE, UNKNOWN): string[]

Поля разделенного имени субъекта из сертификата. В формате key-value. Где key – один из перечисленных в enum параметров, а value – значение параметра


},

 

issuer: {…}

Издатель сертификата (вложенный объект)

},

 

certificateCount (int64),

Число выпущенных сертификатов

title (string),

Отображаемое имя ЦС

cryptographyProviders: {

Конфигурация криптопровайдеров алгоритмов ЦС

(enum: RSA, ECDSA, GOST_R_34_10_2012, UNKNOWN): {

Название алгоритма

cryptographyProvider (enum: DEFAULT, CRYPTO_PRO, UNKNOWN),

Название криптопровайдера

isAvailable (boolean),

Флаг: Доступность криптопровайдера

},

 

primaryCryptographyProvider: {

Криптопровайдер закрытого ключа

cryptographyProvider (enum: DEFAULT, CRYPTO_PRO, UNKNOWN),

Название криптопровайдера

isAvailable (boolean),

Флаг: Доступность криптопровайдера

},

 

isAvailable (boolean),

Флаг: Доступность ЦС

updated (instant),

Время обновления (ISO 8601)

created (instant)

Время создания (ISO 8601)

}

 

Пример использования метода

curl -k --location 'https://172.17.152.213/certificate-authority-service/api/v3/public/certificate-authorities/45f34462-62a4-4671-9927-f1c6763a4470' \
 
--header 'Cookie: token=eyJhbGciOiJSUzUxMiJ9.eyJzZXNzaW9uSWQiOiI2YjNiNTRkZS01YjU2LTQzMzktOTZmMy01ZWE1ZWFkNjAxMTMiLCJpYXQiOjE3MDIyNzc5MzgsImV4cCI6MTcwMjI3ODExOH0.QpzllAH4pDr2953zYv06fq9djAwoAePDwg84FPyj9oVIyNIvpgeg2-frW9X8s7w316cczPBWXUdwaNxpDnpirpy6u-O3j43CLcuGFhoBN7B2Dpsx_L7UTmoo-Eq1Uk7Ld1HBEYCc7EX8GBU2598CwW42Ao5gK49w1fw13zc1iH7u_Wlq1PupIl_XckGnnmqkF9F8lX2-WJ2Ld2H3Jp5fbe81MlOllsxB-WtJUxmQvAL0N4Ogr6ucOIRgUH9HJ1WekNRD1yuvHfCjqLsssbVikrO_nmu4sAKaExAaZWix8-e59h88xfN4uONQWWq55iHktihqFP2YM3W3RYth9vQNRA'

Пример ответа на обращение к методу

{
 
    "status": 200,
 
    "data": {
 
        "id": "45f34462-62a4-4671-9927-f1c6763a4470",
 
       "isActive": true,
 
"active": true,
 
"isManagement": false,
 
       "management": false,
 
       "certificate": {
 
            "id": "da7ca68f-edaf-47a8-bdd9-cb08157f0b4b",
 
            "issuerId": "da7ca68f-edaf-47a8-bdd9-cb08157f0b4b",
 
            "issuerFingerprint": "10faca35d9763c66aa07be57d844092a11ac1040",
 
            "serialnumber": "540ad4f920bd7ae95464ede5c03a3ca4147ce4f0",
 
            "fingerprint": "10faca35d9763c66aa07be57d844092a11ac1040",
 
            "issuerDN": {
 
                "CN": [
 
                    "aladdin"
 
                ],
 
                "OU": [
 
                    "Depnt"
 
                ],
 
                "O": [
 
                    "orgn"
 
                ],
 
                "L": [
 
                    "City"
 
                ],
 
                "DC": [
 
                    "Comnt"
 
                ],
 
                "C": [
 
                    "RU"
 
                ]
 
            },
 
            "subjectDN": {
 
                "CN": [
 
                    "aladdin"
 
                ],
 
                "OU": [
 
                    "Depnt"
 
                ],
 
                "O": [
 
                    "orgn"
 
                ],
 
                "L": [
 
                    "City"
 
                ],
 
                "DC": [
 
                    "Comnt"
 
                ],
 
                "C": [
 
                    "RU"
 
                ]
 
            },
 
            "subjectAltName": {},
 
            "name": "aladdin",
 
            "templateId": "9129245a-eaad-4ebc-a2a4-8845ac0336fb",
 
            "templateName": "Root CA",
 
            "validFrom": "2024-07-30T14:10:27Z",
 
            "validTo": "2034-07-30T14:09:24Z",
 
            "status": "ACTIVE",
 
            "isValid": true,
 
            "isExpired": false,
 
            "actions": {
 
                "p12": false,
 
                "pem": true,
 
                "csr": false
 
            },
 
            "revocation": null,
 
            "hashAlgorithm": "SHA256",
 
            "keyAlgorithm": "RSA",
 
            "keyBits": 1024,
 
            "subjectKeyIdentifier": "51d47e459115bfa6aa567927ca48b6babe1319ae",
 
            "authorityKeyIdentifier": "51d47e459115bfa6aa567927ca48b6babe1319ae",
 
            "created": "2024-07-30T14:10:26.993807Z",
 
            "updated": "2024-07-30T14:10:26.993817Z"
 
        },
 
        "chain": {
 
            "id": "da7ca68f-edaf-47a8-bdd9-cb08157f0b4b",
 
            "name": "aladdin",
 
            "subjectDN": {
 
                "CN": [
 
                    "aladdin"
 
                ],
 
                "OU": [
 
                    "Depnt"
 
                ],
 
                "O": [
 
                    "orgn"
 
                ],
 
                "L": [
 
                    "City"
 
                ],
 
                "DC": [
 
                    "Comnt"
 
                ],
 
                "C": [
 
                    "RU"
 
                ]
 
            },
 
            "issuer": null
 
        },
 
        "certificateCount": 13,
 
        "title": "Root999",
 
        "cryptographyProviders": {
 
            "ECDSA": {
 
                "cryptographyProvider": "DEFAULT",
 
                "isAvailable": true
 
            },
 
            "RSA": {
 
                "cryptographyProvider": "DEFAULT",
 
                "isAvailable": true
 
            }
 
        },
 
        "primaryCryptographyProvider": {
 
            "cryptographyProvider": "DEFAULT",
 
            "isAvailable": true
 
        },
 
        "isAvailable": true,
 
        "created": null,
 
        "updated": null
 
    }
 
}

Метод получения Центров сертификации

GET API – Получение ЦС

Метод доступен администратору

URL – certificate-authority-service/api/v3/public/certificate-authorities

Swagger: https://HOST/external-integration-service/swagger/swagger-ui/index.html#/[v3] Контроллер%3A Центры сертификации/findAll_15

Query

 

{

 

status (enum[]:ACTIVE, HOLD, REVOKE, REQUEST, UNKNOWN) [опционально],

Статус сертификата ЦС

type (enum[]: CERTIFICATE[1], ROOT_CA, SUB_CA, UNKHOWN) [опционально],

Тип сертификата ЦС

search (string) [опционально],

Полнотекстовый поиск по имени ЦС

isManagement (boolean) [опционально],

Флаг: технологический ЦС

isActive (boolean) [опционально],

Флаг: активный ЦС

isValid (boolean) [опционально],

Флаг: сертификат ЦС действителен

isExpired (boolean) [опционально],

Флаг: сертификат ЦС истек

id (UUID[])[опционально],

Id ЦС

notIds (UUID[])[опционально],

Исключая ID ЦС

sortDirection (string) [опционально],

Направления сортировки (ASC;DESC)

endEntityType (enum[]: ROOT_CA, SUB_CA, USER, DEVICE, UNKNOWN) [опционально],

Тип субъекта

sortBy (string[])[опционально],

Список полей, к которым применяется сортировка

pageOffset (integer) [опционально],

Смещение от начала списка (пагинация)

pageLimit (integer) [опционально]

Ограничение на размер выборки (пагинация)

}

Request

 

-


Response

 

ResponseEntity -> CollectionResponse -> {

Ответ JSON в HTTP-body

id (UUID),

ID ЦС

isActive (boolean),

Флаг: активный ЦС

active (boolean),

Флаг: активный ЦС

isManagement (boolean),

Флаг: технологический ЦС

management (boolean),

Флаг: технологический ЦС

certificate: {

Сертификат ЦС

id (UUID),

Идентификатор сертификата ЦС

issuerId (UUID),

Идентификатор издателя сертификата ЦС

issuerFingerprint (string),

Фингерпринт издателя сертификата ЦС

serialnumber (string),

Серийный номер сертификата ЦС

fingerprint (string),

Фингерпринт сертификата ЦС

issuerDN: {

Имя субъекта издателя сертификата ЦС

(enum: CN, UID, E, EMAILADDRESS, MAIL, SN, GIVENNAME, INITIALS, SURNAME, OU, O, L, ST, DC, C, UNSTRUCTUREDADDRESS, UNSTRUCTUREDNAME, POSTALCODE, BUSINESSCATEGORY, TELEPHONENUMBER, PSEUDONYM, POSTALADDRESS, STREET, NAME, T, DN, DESCRIPTION, INN, OGRN, OGRNIP, SNILS, INNLE, UNKNOWN): string[]

Поля разделенного имени субъекта издателя из сертификата. В формате key-value. Где key – один из перечисленных в enum параметров, а value – значение параметра


},

 

subjectDN: {

Имя субъекта сертификата ЦС

(enum: CN, UID, E, EMAILADDRESS, MAIL, SN, GIVENNAME, INITIALS, SURNAME, OU, O, L, ST, DC, C, UNSTRUCTUREDADDRESS, UNSTRUCTUREDNAME, POSTALCODE, BUSINESSCATEGORY, TELEPHONENUMBER, PSEUDONYM, POSTALADDRESS, STREET, NAME, T, DN, DESCRIPTION, INN, OGRN, OGRNIP, SNILS, INNLE, UNKNOWN): string[]

Поля разделенного имени субъекта из сертификата. В формате key-value. Где key – один из перечисленных в enum параметров, а value – значение параметра


},

 

subjectAltName: {

Альтернативное имя субъекта сертификата ЦС

(enum: RFC822NAME, DNS_NAME, IPADDRESS, DIRECTORY_NAME, UNIFORM_RESOURCE_ID, REGISTERED_ID, MS_UPN, MS_GUID, KRB5PRINCIPAL, PERMANENT_IDENTIFIER, XMPP_ADDR, SRV_NAME, SUBJECT_IDENTIFICATION_METHOD, UNKNOWN): string[]

Поля альтернативного имени субъекта из сертификата. В формате key-value. Где key – один из перечисленных в enum параметров, а value – значение параметра


},

 

name (string),

Имя сертификата ЦС (на основе CN)

templateId (UUID),

Идентификатор шаблона

templateName (string),

Имя шаблона

validFrom (instant),

Дата начала действия сертификата ЦС (ISO 8601)

validTo (instant),

Дата окончания действия сертификата ЦС (ISO 8601)

status (enum: ACTIVE, HOLD, REVOKE, REQUEST, UNKNOWN),

Статус сертификата ЦС

isValid (boolean),

Флаг: сертификат ЦС действует

isExpired (boolean),

Флаг: сертификат ЦС истек

actions: {

Доступные действия по выгрузке

p12 (boolean),

Флаг: выгрузка pkcs12

csr (boolean),

Флаг: выгрузка pkcs10

pem (boolean)

Флаг: выгрузка сертификата

},

 

revocation: {

Сведения об отзыве сертификата ЦС

date (instant),

Дата отзыва

number (int32),

Код причины отзыва

value (string)

Значение причины отзыва

},

 

hashAlgorithm (enum: SHA1, SHA256, SHA384, SHA512, SHA3_256, SHA3_384, SHA3_512, RSASSA_PSS, MD5, GOST_R_34_11_2012, UNKNOWN),

Алгоритм подписи сертификата ЦС

keyAlgorithm (enum: RSA, ECDSA, GOST_R_34_10_2012, UNKNOWN),

Алгоритм ключа сертификата ЦС

keyBits (int32),

Длина ключа сертификата ЦС

subjectKeyIdentifier (string),

Идентификатор ключа сертификата ЦС

authorityKeyIdentifier (string),

Идентификатор ключа издателя сертификата ЦС

updated (instant),

Время обновления (ISO 8601)

created (instant)

Время создания (ISO 8601)

},

 

chain: {

Цепочка сертификатов ЦС (рекурсивный объект)

id (UUID),

Идентификатор сертификата

name (string),

Имя сертификата (на основе CN)

subjectDN: {

Имя субъекта сертификата ЦС

(enum: CN, UID, E, EMAILADDRESS, MAIL, SN, GIVENNAME, INITIALS, SURNAME, OU, O, L, ST, DC, C, UNSTRUCTUREDADDRESS, UNSTRUCTUREDNAME, POSTALCODE, BUSINESSCATEGORY, TELEPHONENUMBER, PSEUDONYM, POSTALADDRESS, STREET, NAME, T, DN, DESCRIPTION, INN, OGRN, OGRNIP, SNILS, INNLE, UNKNOWN): string[]

Поля разделенного имени субъекта из сертификата. В формате key-value. Где key – один из перечисленных в enum параметров, а value – значение параметра


},

 

issuer: {…}

Издатель сертификата (вложенный объект)

},

 

certificateCount (int64),

Число выпущенных сертификатов

title (string),

Отображаемое имя ЦС

cryptographyProviders: {

Конфигурация криптопровайдеров алгоритмов ЦС

(enum: RSA, ECDSA, GOST_R_34_10_2012, UNKNOWN): {

Название алгоритма

cryptographyProvider (enum: DEFAULT, CRYPTO_PRO, UNKNOWN),

Название криптопровайдера

isAvailable (boolean),

Флаг: Доступность криптопровайдера

},

},

 

primaryCryptographyProvider: {

Криптопровайдер закрытого ключа

cryptographyProvider (enum: DEFAULT, CRYPTO_PRO, UNKNOWN),

Название криптопровайдера

isAvailable (boolean),

Флаг: Доступность криптопровайдера

},

 

isAvailable (boolean),

Флаг: Доступность ЦС

updated (instant),

Время обновления (ISO 8601)

created (instant)

Время создания (ISO 8601)

}

 

[1] Тип CERTIFICATE является общим для всех словарей типов сертификатов в программе. При использовании данного метода указание данного типа также доступно, однако сертификаты ЦС с данным типом отсутствуют, соответственно не будут найдены и возвращены в ответе.

Пример использования метода

curl -k --location 'https://172.17.152.213/certificate-authority-service/api/v3/public/certificate-authorities' \
 
--header 'Cookie: token=eyJhbGciOiJSUzUxMiJ9.eyJzZXNzaW9uSWQiOiI2YjNiNTRkZS01YjU2LTQzMzktOTZmMy01ZWE1ZWFkNjAxMTMiLCJpYXQiOjE3MDIyNzc5MzgsImV4cCI6MTcwMjI3ODExOH0.QpzllAH4pDr2953zYv06fq9djAwoAePDwg84FPyj9oVIyNIvpgeg2-frW9X8s7w316cczPBWXUdwaNxpDnpirpy6u-O3j43CLcuGFhoBN7B2Dpsx_L7UTmoo-Eq1Uk7Ld1HBEYCc7EX8GBU2598CwW42Ao5gK49w1fw13zc1iH7u_Wlq1PupIl_XckGnnmqkF9F8lX2-WJ2Ld2H3Jp5fbe81MlOllsxB-WtJUxmQvAL0N4Ogr6ucOIRgUH9HJ1WekNRD1yuvHfCjqLsssbVikrO_nmu4sAKaExAaZWix8-e59h88xfN4uONQWWq55iHktihqFP2YM3W3RYth9vQNRA'

Пример ответа на обращение к методу

{
 
    "status": 200,
 
    "data": {
 
        "range": {
 
            "count": 2,
 
            "offset": 0,
 
            "limit": 10,
 
            "totalPages": 1,
 
            "pageNumber": 0
 
        },
 
        "items": [
 
            {
 
                "id": "80c6da0a-9a97-4269-99fe-ed52615034f1",
 
                "active": false,
 
 "isActive": false,
 
                "management": true,
 
 "isManagement": true,
 
                "certificate": {
 
                    "id": "4f5f6412-7cc9-48a7-ba48-2e9e9e76da37",
 
                    "issuerId": "4f5f6412-7cc9-48a7-ba48-2e9e9e76da37",
 
                    "issuerFingerprint": "165ce20a52590dd8a496c1f1c0b5cf0812728de7",
 
                    "serialnumber": "25988edc904cbf3244059d327d103538a910ad38",
 
                    "fingerprint": "165ce20a52590dd8a496c1f1c0b5cf0812728de7",
 
                    "issuerDN": {
 
                        "CN": [
 
                            "INITIAL_CA"
 
                        ]
 
                    },
 
                    "subjectDN": {
 
                        "CN": [
 
                            "INITIAL_CA"
 
                        ]
 
                    },
 
                    "subjectAltName": {},
 
                    "name": "INITIAL_CA",
 
                    "templateId": "9129245a-eaad-4ebc-a2a4-8845ac0336fb",
 
                    "templateName": "Root CA",
 
                    "validFrom": "2024-07-24T13:23:56Z",
 
                    "validTo": "2048-07-25T13:23:56Z",
 
                    "status": "ACTIVE",
 
                    "isValid": true,
 
                    "isExpired": false,
 
                    "actions": {
 
                        "p12": false,
 
                        "pem": true,
 
                        "csr": false
 
                    },
 
                    "revocation": null,
 
                    "hashAlgorithm": "SHA256",
 
                    "keyAlgorithm": "RSA",
 
                    "keyBits": 2048,
 
                    "subjectKeyIdentifier": "fe4afd831276234c8fc511a86093f3fcf647acac",
 
                    "authorityKeyIdentifier": "fe4afd831276234c8fc511a86093f3fcf647acac",
 
                    "created": "2024-07-24T13:23:57.229542Z",
 
                    "updated": "2024-07-24T13:23:57.229581Z"
 
                },
 
                "chain": {
 
                    "id": "4f5f6412-7cc9-48a7-ba48-2e9e9e76da37",
 
                    "name": "INITIAL_CA",
 
                    "subjectDN": {
 
                        "CN": [
 
                            "INITIAL_CA"
 
                        ]
 
                    },
 
                    "issuer": null
 
                },
 
                "certificateCount": 2,
 
                "title": "INITIAL_CA",
 
                "cryptographyProviders": {
 
                    "RSA": {
 
                        "cryptographyProvider": "DEFAULT",
 
                        "isAvailable": true
 
                    },
 
                    "ECDSA": {
 
                        "cryptographyProvider": "DEFAULT",
 
                        "isAvailable": true
 
                    }
 
                },
 
                "primaryCryptographyProvider": {
 
                    "cryptographyProvider": "DEFAULT",
 
                    "isAvailable": true
 
                },
 
                "isAvailable": true,
 
                "created": null,
 
                "updated": null
 
            },
 
            {
 
                "id": "aa7028d8-80dd-4665-bca3-d8b36f53fa1b",
 
                "active": true,
 
                "isActive": true,
 
                "management": false,
 
                "isManagement": false,
 
                "certificate": {
 
                    "id": "33f7d408-82e1-405c-a5d0-f06cbeb10612",
 
                    "issuerId": "33f7d408-82e1-405c-a5d0-f06cbeb10612",
 
                    "issuerFingerprint": "1a438a200ca4192b299c954789cce55395ab3daf",
 
                    "serialnumber": "5ab6dd5722ab2ce42c4f53910c771765a04c2376",
 
                    "fingerprint": "1a438a200ca4192b299c954789cce55395ab3daf",
 
                    "issuerDN": {
 
                        "CN": [
 
                            "aladdin"
 
                        ],
 
                        "OU": [
 
                            "Deparnt"
 
                        ],
 
                        "O": [
 
                            "orgon"
 
                        ],
 
                        "L": [
 
                            "City"
 
                        ],
 
                        "DC": [
 
                            "Cnent"
 
                        ],
 
                        "C": [
 
                            "RU"
 
                        ]
 
                    },
 
                    "subjectDN": {
 
                        "CN": [
 
                            "aladdin"
 
                        ],
 
                        "OU": [
 
                            "Deparnt"
 
                        ],
 
                        "O": [
 
                            "orgon"
 
                        ],
 
                        "L": [
 
                            "City"
 
                        ],
 
                        "DC": [
 
                            "Cnent"
 
                        ],
 
                        "C": [
 
                            "RU"
 
                        ]
 
                    },
 
                    "subjectAltName": {},
 
                    "name": "aladdin",
 
                    "templateId": "9129245a-eaad-4ebc-a2a4-8845ac0336fb",
 
                    "templateName": "Root CA",
 
                    "validFrom": "2024-07-24T13:27:53Z",
 
                    "validTo": "2034-07-24T13:26:58Z",
 
                    "status": "ACTIVE",
 
                    "isValid": true,
 
                    "isExpired": false,
 
                    "actions": {
 
                        "p12": false,
 
                        "pem": true,
 
                        "csr": false
 
                    },
 
                    "revocation": null,
 
                    "hashAlgorithm": "SHA256",
 
                    "keyAlgorithm": "RSA",
 
                    "keyBits": 4096,
 
                    "subjectKeyIdentifier": "f047a6659c36e72bc22a1c2eb2ec1971ff79b857",
 
                    "authorityKeyIdentifier": "f047a6659c36e72bc22a1c2eb2ec1971ff79b857",
 
                    "created": "2024-07-24T13:27:52.869628Z",
 
                    "updated": "2024-07-24T13:27:52.869640Z"
 
                },
 
                "chain": {
 
                    "id": "33f7d408-82e1-405c-a5d0-f06cbeb10612",
 
                    "name": "aladdin",
 
                    "subjectDN": {
 
                        "CN": [
 
                            "aladdin"
 
                        ],
 
                        "OU": [
 
                            "Deparnt"
 
                        ],
 
                        "O": [
 
                            "orgon"
 
                        ],
 
                        "L": [
 
                            "City"
 
                        ],
 
                        "DC": [
 
                            "Cnent"
 
                        ],
 
                        "C": [
 
                            "RU"
 
                        ]
 
                    },
 
                    "issuer": null
 
                },
 
                "certificateCount": 3,
 
                "title": "Root15",
 
                "cryptographyProviders": {
 
                    "RSA": {
 
                        "cryptographyProvider": "DEFAULT",
 
                        "isAvailable": true
 
                    },
 
                    "ECDSA": {
 
                        "cryptographyProvider": "DEFAULT",
 
                        "isAvailable": true
 
                    }
 
                },
 
                "primaryCryptographyProvider": {
 
                    "cryptographyProvider": "DEFAULT",
 
                    "isAvailable": true
 
                },
 
                "isAvailable": true,
 
                "created": null,
 
                "updated": null
 
            }
 
        ]
 
    }
 
}