Быстрый старт

1. Прорабатывается событийная метамодель, которая описывает все возможные события безопасности, а также список их дополнительных параметров.
2. При запуске приложения публикуется подготовленная модель в сервисе аудита.
3. В процессе работы сервиса при возникновении ситуации, требующей запись в журнал событий безопасности, выполняется отправка данных события в сервис аудита.

Настройка метамодели

• название события - "Role changed";
• описание события - "Смена роли пользователя";
• название приложения (чтобы знать, что это именно его события) - указываем свой идентификатор в качестве названия приложения;
• логин пользователя, который вызвал действие;
• узел (IP/FQDN), с которого пользователь выполняет действия.

• логин пользователя, роль которого мы меняем;
• итоговый список ролей.

Метамодель type=json
{
"metamodelVersion": 1,
"module": "укажите-ваш-идентификатор",
"events": [
{
"name": "Role Changed",
"description": "Смена роли пользователя",
"success": true,
"mode": "speed",
"params": [
{
"name": "Target User",
"description": "Логин пользователя, роли которого изменяются в рамках события"
},
{
"name": "Roles",
"description": "Итоговый список ролей"
}
]
}
]
}```

Вместо `укажите-ваш-идентификатор` укажите свой идентификатор сервиса.

Далее загрузим JSON-описание метамодели в Аудит, выполнив следующий запрос:

`http://{auditUrl}/audit/proxy/v1/metamodel`

`auditUrl` - днс:порт, либо через `platform-gateway`, либо через интеграционный шлюз МТП (предпочтительно для ПК или ВМ).

Запрос для загрузки метамодели:

```conf name=Запрос type=json
curl -X 'POST' \
'http://{auditUrl{/audit/proxy/v1/metamodel' \
-H 'accept: application/json' \
-H 'SOURCERN: PLATCORE1' \
-H 'Content-Type: application/json' \
-d '{
"metamodelVersion": 1,
"module": "укажите-ваш-идентификатор",
"events": [
{
"name": "Role Changed",
"description": "Смена роли пользователя",
"success": true,
"mode": "speed",
"params": [
{
"name": "Target User",
"description": "Логин пользователя, роли которого изменяются в рамках события"
},
{
"name": "Roles",
"description": "Итоговый список ролей"
}
]
}
]
}'

Ответ type=json
{
"id": "b1df2678-7c44-4288-b0ff-e08532639aad"
}

Отправка события в Аудит

Событие type=json
{
"metamodelVersion": "1",
"name": "Role Changed",
"session": "сессия",
"module": "укажите-ваш-идентификатор",
"createdAt": 1699442898000,
"userLogin": "admin",
"userName": "Ivanov Ivan",
"userNode": "127.0.0.1",
"params": [
{
"name": "Target User",
"value": "user"
},
{
"name": "Roles",
"value": "view,edit,create"
}
]
}

Запрос type=json
curl -X 'POST' \
'http://{auditUrl}/audit/proxy/v1/event' \
-H 'accept: application/json' \
-H 'X-Node-ID: node-id' \
-H 'SOURCERN: PLATCORE1' \
-H 'Content-Type: application/json' \
-d '{
"metamodelVersion": "1",
"name": "Role Changed",
"session": "сессия",
"module": "укажите-ваш-идентификатор",
"createdAt": 1699442898000,
"userLogin": "admin",
"userName": "Ivanov Ivan",
"userNode": "127.0.0.1",
"params": [
{
"name": "Target User",
"value": "user"
},
{
"name": "Roles",
"value": "view,edit,create"
}
]
}'

Идентификатор type=json
{
"id": "49b70292-cafd-461e-b758-c841a669396a"
}

Поиск отправленного события

1. Переходим на интерфейс Аудита по ссылке ИАМ (через звездное небо).
2. Авторизовывамся при помощи учетной записи.
3. Нажимаем на карточку Поиск событий аудита. Откроется окно поиска событий аудита.
   

   Увеличить

   

   Увеличить

4. Выбираем тенант, который мы использовали ранее. Указываем период, сходный текст и свой идентификатор.
   

   Увеличить

5. В результатах поиска отобразятся нужные нам события. Нажмите на строку с событием, чтобы узнать о нем подробнее.
   

   Увеличить