Метод поиска субъектов

GET API – Поиск субъектов

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

URL – subjects-service/api/v3/public/subjects

Swagger: https://HOST/external-integration-service/swagger/swagger-ui/index.html#/[v3] Контроллер%3A субъекты/findAll_2

Query


{


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

Полнотекстовый поиск (имя субъекта)

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

Флаг: субъект заблокирован в ресурсной системе

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

Флаг: субъект подключен к ресурсной системе

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

ID субъекта

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

Исключая ID субъекта

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

ID группы безопасности

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

ID ресурсной системы

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

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

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

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

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

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

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

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

}


Request


-


Response


ResponseEntity -> CollectionResponse -> {

Ответ JSON в HTTP-body

id (UUID),

ID субъекта

commonName (string)

Имя субъекта

distinguishedName (string),

Расположение субъекта в ресурсной системе

resource: {

Ресурсная система

id (uuid),

ID ресурсной системы

commonName (string),

Имя ресурсной системы

distinguishedName (string)

BaseDN точки подключения к ресурсной системе

},


subjectName: {

Имя субъекта

(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): {

Поля разделенного имени субъекта

values (string[]),

Значения компонента

editable (boolean),

Флаг: компонент доступен для редактирования

}


},


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): {

Поля альтернативного имени субъекта

values (string[]),

Значения компонента

editable (boolean),

Флаг: компонент доступен для редактирования

}


},


isConnected (boolean),

Флаг: субъект подключен к ресурсной системе

isBlocked (boolean),

Флаг: субъект заблокирован в ресурсной системе

certificatesCount (integer),

Количество сертификатов

modify (instant),

Время изменения (ISO 8601)

updated (instant),

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

created (instant)

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

sid (string)

SID субъекта или NULL

}


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

curl -k --request GET --location 'https://172.17.152.213/subjects-service/api/v3/public/subjects?pageLimit=2147483647&pageOffset=0&sortDirection=asc' \
 
--header 'Cookie: token=eyJhbGciOiJSUzUxMiJ9.eyJzZXNzaW9uSWQiOiI4ZTcxMzc2MS1hMGE4LTQ1MjQtYTE5Zi1lOTkxMjNiMDk0YTMiLCJpYXQiOjE3MDIwNDY4MjQsImV4cCI6MTcwMjA0NzAwNH0.lm7blLyaiztUrZ2LIhvRFpbW2160iw_ELeiEzDRcjcRXV9H_D_WLZiyk1Ft4Z3G8pDd4EAXODgd6eVRCSO8yPwEKLOZwSl1IFjxRRza-3g9ohrgXtLddkdWn-LSRcO_LVrLT-vUiQrvRXpbc0rBoWcoXMgCFnYErIngvFZmZxreP1PvQU9f9hLbszp1xm6Aso6239VG8VfF9b04Qtwhg_7kPmY1NvE8pRhflr7ICTjcM0MKHC-bdJ1yxKmK_-xtFzdirjEu0WAEXwKTxY6sdMBidcyqRTiKBldX0klzfZm-_veRI4XoWhHTZrQxmp86me2vy_JLn-AsMWj3D7DdAmg'

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

{
 
    "status": 200,
 
    "data": {
 
        "range": {
 
            "count": 2,
 
            "offset": 0,
 
            "limit": 2147483647,
 
            "totalPages": 1,
 
            "pageNumber": 0
 
        },
 
        "items": [
 
            {
 
                "id": "000d2c40-cb30-4e9b-9429-934302389328",
 
                "commonName": "Lewis Hance",
 
                "distinguishedName": "CN=Lewis Hance,OU=created-users,DC=winad,DC=local",
 
                "resource": {
 
                    "id": "4c651fcc-94ba-4dea-9dc5-d9d2b2334cc9",
 
                    "commonName": "winad",
 
                    "distinguishedName": "DC=winad,DC=local"
 
                },
 
                "subjectName": {
 
                    "EMAILADDRESS": {
 
                        "values": [
 
                            "Carating@test.local",
 
                            "LewisKHance@einrot.com"
 
                        ],
 
                        "editable": false
 
                    },
 
                    "CN": {
 
                        "values": [
 
                            "Lewis Hance"
 
                        ],
 
                        "editable": false
 
                    },
 
                    "SURNAME": {
 
                        "values": [
 
                            "Hance"
 
                        ],
 
                        "editable": false
 
                    },
 
                    "GIVENNAME": {
 
                        "values": [
 
                            "Lewis"
 
                        ],
 
                        "editable": false
 
                    },
 
                    "NAME": {
 
                        "values": [
 
                            "Lewis Hance"
 
                        ],
 
                        "editable": false
 
                    }
 
                },
 
                "subjectAltName": {
 
                    "RFC822NAME": {
 
                        "values": [
 
                            "Carating@test.local",
 
                            "LewisKHance@einrot.com"
 
                        ],
 
                        "editable": false
 
                    },
 
                    "MS_UPN": {
 
                        "values": [
 
                            "Carating@test.local"
 
                        ],
 
                        "editable": false
 
                    }
 
                },
 
                "isConnected": true,
 
                "isBlocked": false,
 
                "modify": "2023-06-16T00:59:24Z",
 
                "updated": "2024-02-05T21:00:07.617169Z",
 
                "created": "2024-02-01T05:08:09.379555Z"
 
            },
 
            {
 
                "id": "0011005f-bb95-4162-ad6e-015ae8cac7be",
 
                "commonName": "Megan Mejorado",
 
                "distinguishedName": "CN=Megan Mejorado,OU=created-users,DC=winad,DC=local",
 
                "resource": {
 
                    "id": "4c651fcc-94ba-4dea-9dc5-d9d2b2334cc9",
 
                    "commonName": "winad",
 
                    "distinguishedName": "DC=winad,DC=local"
 
                },
 
                "subjectName": {
 
                    "EMAILADDRESS": {
 
                        "values": [
 
                            "Yourbithes45@test.local",
 
                            "MeganMMejorado@dayrep.com"
 
                        ],
 
                        "editable": false
 
                    },
 
                    "CN": {
 
                        "values": [
 
                            "Megan Mejorado"
 
                        ],
 
                        "editable": false
 
                    },
 
                    "SURNAME": {
 
                        "values": [
 
                            "Mejorado"
 
                        ],
 
                        "editable": false
 
                    },
 
                    "GIVENNAME": {
 
                        "values": [
 
                            "Megan"
 
                        ],
 
                        "editable": false
 
                    },
 
                    "NAME": {
 
                        "values": [
 
                            "Megan Mejorado"
 
                        ],
 
                        "editable": false
 
                    }
 
                },
 
                "subjectAltName": {
 
                    "RFC822NAME": {
 
                        "values": [
 
                            "Yourbithes45@test.local",
 
                            "MeganMMejorado@dayrep.com"
 
                        ],
 
                        "editable": false
 
                    },
 
                    "MS_UPN": {
 
                        "values": [
 
                            "Yourbithes45@test.local"
 
                        ],
 
                        "editable": false
 
                    }
 
                },
 
                "isConnected": true,
 
                "isBlocked": false,
 
                "modify": "2023-06-16T03:45:57Z",
 
                "updated": "2024-02-05T21:00:22.612777Z",
 
                "created": "2024-02-01T05:08:38.131896Z"
 
                "sid": "NULL"
 
            }
 
        ]
 
    }
 
}

В примере выше (вызов осуществлялся с маркером доступа пользователя с ролью «Администратор») получены все имеющиеся субъекты программы.

Метод получения субъекта по идентификатору

GET API – Получение субъекта по идентификатору

Метод доступен администратору и оператору при наличии полномочий на управление субъектом, идентификатор которого передается во входных параметрах

URL – subjects-service/api/v3/public/subjects/{id}

Swagger: https://HOST/external-integration-service/swagger/swagger-ui/index.html#/[v3] Контроллер%3A субъекты/findById_2

Query


{


id (UUID)

ID субъекта

}


Request

 

-


Response

 

ResponseEntity -> ItemResponse -> {

Ответ JSON в HTTP-body

id (UUID),

ID субъекта

commonName (string)

Имя субъекта

distinguishedName (string),

Расположение субъекта в ресурсной системе

resource: {

Ресурсная система

id (uuid),

ID ресурсной системы

commonName (string),

Имя ресурсной системы

distinguishedName (string)

BaseDN точки подключения к ресурсной системе

},


subjectName: {

Имя субъекта

(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): {

Поля разделенного имени субъекта

values (string[]),

Значения компонента

editable (boolean),

Флаг: компонент доступен для редактирования

}


},


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): {

Поля альтернативного имени субъекта

values (string[]),

Значения компонента

editable (boolean),

Флаг: компонент доступен для редактирования

}


},


isConnected (boolean),

Флаг: субъект подключен к ресурсной системе

isBlocked (boolean),

Флаг: субъект заблокирован в ресурсной системе

certificatesCount (integer),

Количество сертификатов

modify (instant),

Время изменения (ISO 8601)

updated (instant),

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

created (instant)

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

sid (string)

SID субъекта или NULL

}


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

curl -k --request GET --location 'https://172.17.152.213/subjects-service/api/v3/public/subjects/0002db60-2364-43cc-a7d9-14390aaf2628' \
 
--header 'Cookie: token=eyJhbGciOiJSUzUxMiJ9.eyJzZXNzaW9uSWQiOiJkYzgzMDI2OC04MDA5LTQ2Y2EtOWNlYi03MzEyMWNiOGFhYzIiLCJpYXQiOjE3MDIyNzY4NzIsImV4cCI6MTcwMjI3NzA1Mn0.TBJk1CmffoE8u2chrh3-41Jhz1g5YA36NjSn0i30liJRlJkVYPxCQ6QmQ8iBoq08jIiPi3SM_C7d0pi7yaljbylcobWmLzSTDnGeZ-aYP44qI4VbZvPtKFpEJb9GebJoOE5rGgl9RApMGT74YVNJzlcz_GlNUp2HP3BPLGzm3-3BSH3yLmX1vaSoZRsZLYmIKreHv6oD_UhwmcAigFW2WYkcOxNgDvHWyOHar_xekQuK3jVsUERkvFl9rNdssJdW5n0eThMnG1BZhXp_OWKnfYi6V9NFialDocW_HtrJfw1bNbAnKuEImbylE6aDjPfS5XRjVuNZstIAgl4sLVC9yg'

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

{
 
    "status": 200,
 
    "data": {
 
        "id": "0002db60-2364-43cc-a7d9-14390aaf2628",
 
        "commonName": "Mary Washington",
 
        "distinguishedName": "CN=Mary Washington,OU=created-users,DC=winad,DC=local",
 
        "resource": {
 
            "id": "4c651fcc-94ba-4dea-9dc5-d9d2b2334cc9",
 
            "commonName": "winad",
 
            "distinguishedName": "DC=winad,DC=local"
 
        },
 
        "subjectName": {
 
            "EMAILADDRESS": {
 
                "values": [
 
                    "Saighterse84@test.local",
 
                    "MaryRWashington@einrot.com"
 
                ],
 
                "editable": false
 
            },
 
            "CN": {
 
                "values": [
 
                    "Mary Washington"
 
                ],
 
                "editable": false
 
            },
 
            "SURNAME": {
 
                "values": [
 
                    "Washington"
 
                ],
 
                "editable": false
 
            },
 
            "GIVENNAME": {
 
                "values": [
 
                    "Mary"
 
                ],
 
                "editable": false
 
            },
 
            "NAME": {
 
                "values": [
 
                    "Mary Washington"
 
                ],
 
                "editable": false
 
            }
 
        },
 
        "subjectAltName": {
 
            "RFC822NAME": {
 
                "values": [
 
                    "Saighterse84@test.local",
 
                    "MaryRWashington@einrot.com"
 
                ],
 
                "editable": false
 
            },
 
            "MS_UPN": {
 
                "values": [
 
                    "Saighterse84@test.local"
 
                ],
 
                "editable": false
 
            }
 
        },
 
        "isConnected": true,
 
        "isBlocked": false,
 
        "modify": "2024-02-05T10:09:47Z",
 
        "updated": "2024-02-05T21:00:27.282374Z",
 
        "created": "2024-02-01T05:08:36.038636Z"
 
        "sid": "NULL"
 
 
 
    }
 
}

Метод создания и изменения субъекта

PUT API – Создание и изменение субъекта

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

URL – subjects-service/api/v3/public/subjects

Swagger: https://HOST/external-integration-service/swagger/swagger-ui/index.html#/[v3] Контроллер%3A субъекты/update

Query

 

-


Request

 

{

 

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

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

subjectName: {

(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[]

} [опционально],

Поля разделенного имени субъекта

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[]

} [опционально]

Поля альтернативного имени субъекта

}

 

Response

 

ResponseEntity -> ItemResponse -> {

Ответ JSON в HTTP-body

id (UUID),

ID субъекта

commonName (string)

Имя субъекта

distinguishedName (string),

Расположение субъекта в ресурсной системе

resource: {

Ресурсная система

id (uuid),

ID ресурсной системы

commonName (string),

Имя ресурсной системы

distinguishedName (string)

BaseDN точки подключения к ресурсной системе

},

 

subjectName: {

Имя субъекта

(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): {

Поля разделенного имени субъекта

values (string[]),

Значения компонента

editable (boolean),

Флаг: компонент доступен для редактирования

}

 

},

 

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): {

Поля альтернативного имени субъекта

values (string[]),

Значения компонента

editable (boolean),

Флаг: компонент доступен для редактирования

}

 

},

 

isConnected (boolean),

Флаг: субъект подключен к ресурсной системе

isBlocked (boolean),

Флаг: субъект заблокирован в ресурсной системе

certificatesCount (integer),

Количество сертификатов

modify (instant),

Время изменения (ISO 8601)

updated (instant),

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

created (instant)

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

sid (string)

SID субъекта или NULL

}

 

Методы создания и изменения субъекта на основании запроса pkcs#10

Метод создания и изменения субъекта на основании запроса pkcs#10 (формат запроса на сертификат из входных параметров – multipart/form-data)

PUT API – Создание и изменение субъекта на основании запроса pkcs#10 (multipart/form-data)

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

URL – subjects-service/api/v3/public/subjects/pkcs10

Swagger: https://HOST/external-integration-service/swagger/swagger-ui/index.html#/[v3] Контроллер%3A субъекты/updateByPkcs10AsMultipartFile_1

Query

 

-


Request

 

{

 

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

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

request (binary),

Файл запроса на сертификат (см. пример использования метода ниже)

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[]

} [опционально]

Поля альтернативного имени субъекта

}

 

Response

 

ResponseEntity -> ItemResponse -> {

Ответ JSON в HTTP-body

id (UUID),

ID субъекта

commonName (string)

Имя субъекта

distinguishedName (string),

Расположение субъекта в ресурсной системе

resource: {

Ресурсная система

id (uuid),

ID ресурсной системы

commonName (string),

Имя ресурсной системы

distinguishedName (string)

BaseDN точки подключения к ресурсной системе

},

 

subjectName: {

Имя субъекта

(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): {

Поля разделенного имени субъекта

values (string[]),

Значения компонента

editable (boolean),

Флаг: компонент доступен для редактирования

}

 

},

 

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): {

Поля альтернативного имени субъекта

values (string[]),

Значения компонента

editable (boolean),

Флаг: компонент доступен для редактирования

}

 

},

 

isConnected (boolean),

Флаг: субъект подключен к ресурсной системе

isBlocked (boolean),

Флаг: субъект заблокирован в ресурсной системе

certificatesCount (integer),

Количество сертификатов

modify (instant),

Время изменения (ISO 8601)

updated (instant),

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

created (instant)

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

sid (string)

SID субъекта или NULL

}

 

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

curl -k --request PUT --location 'https://192.168.111.18/subjects-service/api/v3/public/subjects/pkcs10' \
 
--header 'Cookie: token=eyJhbGciOiJSUzUxMiJ9.eyJzZXNzaW9uSWQiOiI0ZmFhYj
 
gxNi0wZGNhLTQ0ZjctOGQzZS0xNDkwNTdmYzYwZmEiLCJpYXQiOjE3MDIwMjc5ODYsImV4cCI6MTcwMjAyODE2Nn0.EBQw9zAD-I8BsCkYT5A8mUdyjBc7f14Ogm17ui0IdjpdK6Eq4k5UQ13Vgj2kMhU2XQKnbXt
 
4NZNJ45Y8d-_FXXwk_lKcG94X8YvrmF6tWHnAOt3DLjsIMm3ZbMJjAopQx-0PQURg8_aQ6d4E2rLWB-mWE1h8JqcwZ5g29yD1qHS7V0ArSy_AbkFmnqUrrq6CVcQLETGef05qCIIx5_WEB9bF-bnevA9aq
 
LTPWdYzbcXTAUgRumVkEKgi_iF9S-mSYFC8EtYvztC30k1EtssR6wG2VucIozLhYRuwVavXD7OXyQ8pRt
 
KxYIQimt7cuD5Ez7v-ML9LfDZ5B6EIh1OM7g' \
 
--form 'request=@"/C:/Users/user/Downloads/request.csr"'

Метод создания и изменения субъекта на основании запроса pkcs#10 (формат запроса на сертификат из входных параметров – application/json)

Примечание: отличается от метода выше форматом передаваемого во входных параметрах запроса на сертификат. В данном методе на вход поступает содержимое файла запроса на сертификат в формате PEM (содержимое в Base64).

PUT API – Создание и изменение субъекта на основании запроса pkcs#10 (application/json)

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

URL – subjects-service/api/v3/public/subjects/pkcs10

Swagger: https://HOST/external-integration-service/swagger/swagger-ui/index.html#/[v3] Контроллер%3A субъекты/updateByPkcs10AsMultipartFile_1

Query

 

-


Request

 

{

 

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

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

request: {

Файл запроса на сертификат

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

Тип загружаемого файла (HTTP MediaType) - application/octet-stream)

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

Имя загружаемого файла

data (string:binary)

Содержимое PEM файла запроса на сертификат (массив байт в Base64) - см. пример использования метода ниже

},

 

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): string[]

} [опционально]

Поля альтернативного имени субъекта

}

 

Response

 

ResponseEntity -> ItemResponse -> {

Ответ JSON в HTTP-body

id (UUID),

ID субъекта

commonName (string),

Имя субъекта

distinguishedName (string),

Расположение субъекта в ресурсной системе

resource: {

Ресурсы

id (uuid),

ID ресурсной системы

commonName (string),

Имя ресурсной системы

distinguishedName (string)

BaseDN точки подключения к ресурсной системе

},

 

subjectName: {

Имя субъекта

(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): {

Поля разделенного имени субъекта

values (string[]),

Значения компонента

editable (boolean),

Флаг: компонент доступен для редактирования

}

 

},

 

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): {

Поля альтернативного имени субъекта

values (string[]),

Значения компонента

editable (boolean),

Флаг: компонент доступен для редактирования

}

 

},

 

isConnected (boolean),

Флаг: субъект подключен к ресурсной системе

isBlocked (boolean),

Флаг: субъект заблокирован в ресурсной системе

certificatesCount (integer),

Количество сертификатов

modify (instant),

Время изменения (ISO 8601)

updated (instant),

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

created (instant)

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

sid (string)

SID субъекта или NULL

}

 

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

curl -k --request PUT --location 'https://172.17.152.213/subjects-service/api/v3/public/subjects/pkcs10' --header 'Content-Type: application/json' --data '{
 
    "request": {
 
        "contentType": "application/octet-stream",
 
        "fileName": "test",
 
        "data": "LS0tLS1CRUdJTiBORVcgQ0VSVElGSUNBVEUgUkVRVUVTVC0tLS0tCk1JSUNnekNDQVdzQ0FRQXdQakVQTUEwR0ExVUVCaE1HVW5WemMybGhNUTR3REFZRFZRUUtFd1YwYUhKbFpURU0NCk1Bb0dBMVVFQ3hNRGRIZHZNUTB3Q3dZRFZRUURFd1JTVDA5VU1JSUJJakFOQmdrcWhraUc5dzBCQVFFRkFBT0MNCkFROEFNSUlCQ2dLQ0FRRUFpOVRJeXRSck1FYi9kUlRhSWtxcEdZSGNkTlpRb0VNK2E2L090SVk3d3JCY2M2cEYNCnR1SUdGc0VkRmpNcWpKbFBlWmFhQ2lEMDhVMU1td0h2VXBqK3AzSEd3YWdIRkk2elNrcnNEUTJnKzhDL1B0ZnENCnVqcU1vRUhNTWZJK3FETEdVemp6eGJUV0F1T05DVjBtUmNpdTlIU2o0Ynh4dTVUeW05QnNhYVBvczR6MzAycC8NCkl3b3dlemxCZ0EzV2NYSlYzVTRSbW1VcERmcmlNNDRiWEw5R3BTejNJVkd1MlkxQWtlc3RpQXNCejhwMUNTbU8NClgrT3hwUUVIMVlFVHVsRFp0dGtTM2kvVmthV0JtTTZXK1VJWDZRYUwxTTdRSDFMTWVvYlludlUwSEVmQjRwYysNCnlJN1dKK2tCc3JLK1RNbHEyZFV5RTdnWFR4YUZkS1lpSmZKTnVRSURBUUFCb0FBd0RRWUpLb1pJaHZjTkFRRUYNCkJRQURnZ0VCQUIwWHNGYzhYUGJmME9hVGdCVkk2K0R1REs5NzVBVHREZHRCRTEwbDYzdlcwZkhzZmM0WHJ5bloNCkpaTXRmaXRGUExxcGtaT1lFbEtYSGpiZlJzYzd2NzJSRmszbGpUQ1l0Ym9INmFkT1IvWEVYMHlVSlpPMllTNSsNCnlNbE5neERNZ0NzeEhZQlFoNzhOYk1NUWIrSDhxMzh5ZzF1L01sL3JmOVhQbENCL05Wdm5raS8wOHQvQ0dySVcNCjZqb0RObnhQcFdyYWdQUjV5c3I0Q1J6L01DMkU0cEFESjZQdVlkZW9EYlFUTE1yMGFTRG5NTGdNZGN4eFVLNUkNCjNFb01zTEc1dUpoZWVQODBESFFuYnVLbStjTU4rK3lPcUxHa0FaaHdrRGREano0cTAyelV1RnhpeEJBVzcrRzYNCmkvejZhemRtTm5MR1VPSGZpYm5qN3Q2aFVKZUsxa289Ci0tLS0tRU5EIE5FVyBDRVJUSUZJQ0FURSBSRVFVRVNULS0tLS0K"
 
    }
 
}' --cookie 'token=eyJhbGciOiJSUzUxMiJ9.eyJzZXNzaW9uSWQiOiJlZjI0ODYyMi1jZjRlLTRmZmUtYTJkZi1mODdmMmViOGRkZTYiLCJpYXQiOjE3MDIwMjkxMzQsImV4cCI6MTcwMjAyOTMxNH0.ZRrUsOTFw6jJZi4YS8c2xq3Qz2EObNpv2IV8I991m2hJrz6VmTQtzdyKihG7BDUZp_zOf_j63UbRmhtue59o6WQlii7sBRaFakckzxCP98mTc5muB9E77blfu0OHcoZqZfSX36bSoH6R0hLZ1FyTzjRnSfdrlKisQAaF0XrjK5nSfmgnEQOCinAu2f82tbFtXfyS1AeGjr1SL6A7EzQ_UvJNFfg4FWWyzgruSyJlVKAyn_kwdolJe1j_pOc4yr_rXH39lIqX6GL7tlC5cUSaDCXwg-hE49qkw9f9-2oBlip92Pug6dbeAPvPF5nnhH3JHw-3JogsrUsimTruqfl9GA'

Метод удаления субъекта

DELETE API – Удаление субъекта

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

URL – subjects-service/api/v3/public/subjects/{id}

Swagger: https://HOST/external-integration-service/swagger/swagger-ui/index.html#/[v3] Контроллер%3A субъекты/deleteById

Query

{(id – обязательный параметр)

id (UUID)

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

}

Request

-

Response

-

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

curl -k --location --request DELETE 'https://172.17.152.213/subjects-service/api/v3/public/subjects/1a254868-5318-11ee-aa77-360c16967470' \
 
--header 'Cookie: token=eyJhbGciOiJSUzUxMiJ9.eyJzZXNzaW9uSWQiOiJiNmRlZWUyYS00N2MxLTQzZjQtYmEyNS05MTk1YWVlMjQzMTkiLCJpYXQiOjE3MDIyNzcwNjQsImV4cCI6MTcwMjI3NzI0NH0.e8b0fI9N91DQzveJx9Wg3mepQl8trwLS-6ldl8J9-IUkBxRXAIYmidz7EQf-HAmjjHP5tCrsb71HvLYN6x5_
 
abpIb6oAVLIbw2XLytwlTjQ9dQS_HcrhDjOeelc77fJlWIt-FlsyM1msuMYMZFa4d9
 
x71yNsDTNlRTl3bebCoj1p4LCJqGFf80qv70-r9jERsSGSSoSGHGMTafm0eG-cL3zjyR-Dne8PbyMKAPg8NA043uxLzUTrG4nOrsH7rxmM4yrfR6fueTnpPrkLbVnZb5zM0DU0mXc4YrgDUhsiOhGu_tj8tazCfAmm0FCe6Tijqh-Tmi52ejpMm3w1TwpJIw'

Метод поиска ID субъектов

GET API – Поиск ID субъектов

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

URL – subjects-service/api/v3/public/subjects/ids

Swagger: https://HOST/external-integration-service/swagger/swagger-ui/index.html#/[v3] Контроллер%3A субъекты/findAllAsIds

Query


{


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

Полнотекстовый поиск (имя субъекта)

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

Флаг: субъект заблокирован в ресурсной системе

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

Флаг: субъект подключен к ресурсной системе

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

ID субъекта

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

Исключая ID субъекта

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

ID группы безопасности

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

ID ресурсной системы

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

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

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

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

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

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

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

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

}


Request


-


Response


ResponseEntity -> CollectionResponse -> {

Ответ JSON в HTTP-body

items (UUID)

ID субъекта

}