Справка

Журнал событий

Безоблачный Pyrus

Журнал событий — это информация о действиях пользователей в Pyrus, с помощью которой администраторы могут выявить события, угрожающие безопасности процессов и данных.

Подробнее о журнале событий

Метод GET /eventhistory

Получение CSV-файла с деталями события

Метод позволяет получить набор событий с определенными характеристиками и возвращает CSV-файл со следующими полями:

  • ID события;
  • ID типа события;
  • Время возникновения события в формате "yyyyMMddTHHmmssZ";
  • ID пользователя-инициатора события;
  • email пользователя-инициатора события;
  • IP-адрес компьютера, с которого было инициировано событие;
  • дополнительные данные о событии в формате JSON;
  • userAgent — заголовок UserAgent запроса, в рамках которого произошло событие. Формат записи: <Удобное для чтения представление>|<Исходное значение UserAgent>

Возможные идентификаторы типов событий:

  • 7 — изменен маршрут согласования задачи по форме;
  • 12 — вход пользователя в Pyrus;
  • 13 — неуспешная попытка входа пользователя в Pyrus;
  • 30 — пользователь добавлен в роль;
  • 31 — пользователь исключен из роли;
  • 35 — выход пользователя из Pyrus;
  • 36 — автоматический выход пользователя из Pyrus из-за превышения максимальной разрешенной продолжительности сессии;
  • 40 — пользователь из другой организации добавлен в роль;
  • 41 — пользователь из другой организации исключен из роли;
  • 42 — пользователь из другой организации добавлен в форму или список задач;
  • 43 — пользователь из другой организации исключен из формы или списка задач;
  • 44 — пользователь из другой организации добавлен в задачу;
  • 49 — изменен набор прав доступа пользователя;
  • 45 — пользователь из другой организации исключен из задачи;
  • 46 — изменены настройки в профиле пользователя;
  • 58 — пользователю направлен одноразовый код доступа;
  • 63 — изменены настройки двухфакторной авторизации для всех сотрудников организации;
  • 64 — изменены настройки разрыва сессий на мобильных устройствах для всех сотрудников организации;
  • 65 — изменены настройки разрыва web-сессий для всех сотрудников организации;
  • 66 — изменены настройки двухфакторной авторизации для одного пользователя;
  • 67 — изменены настройки разрыва сессий на мобильных устройствах для одного пользователя;
  • 68 — изменены настройки разрыва web-сессий для одного пользователя;
  • 69 — автоматический выход пользователя из Pyrus из-за длительной неактивности;
  • 70 — изменены настройки разрыва неактивных web-сессий для всех сотрудников организации;
  • 71 — изменены настройки разрыва неактивных сессий на мобильных устройствах для всех сотрудников
    организации;
  • 72 — изменены настройки разрыва неактивных web-сессий для одного пользователя;
  • 73 — изменены настройки разрыва неактивных сессий на мобильных устройствах для одного пользователя.
GET https://api.pyrus.com/v4/eventhistory?<params>

Заголовки ответа

Content-Type: application/octet-stream
Content-Disposition: attachment;filename=EventHistory_After1000_Count1.csv

Тело ответа

evntid,evnttype,utcdate,personid,personemail,ip,eventdata,useragent
1001,49,20221014T114016Z,123456,test@example.com,127.0.0.1,"{""ProjectId"":19961,""LevelBefore"":0,""LevelAfter"":4,""PersonId"":123456}",Windows, Chrome|js version:1.87.33407.0 Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.0.0 Safari/537.36

curl

curl -X GET \
'https://api.pyrus.com/v4/eventhistory?after=1000&count=1' \
-H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \

Параметры

after — целое число. В ответ попадают события, ID которых больше значения данного параметра.

count – количество событий в ответе. Максимальное значение — 100 000.

GET /fileaccesshistory

Получение CSV-файла с историей действий с файлами

Метод позволяет получить историю действий с файлами и возвращает следующие поля:

  • ID события;
  • тип события (U - загрузка в пайрус; D - скачивание из пайруса);
  • ID приложенного файла (см. здесь поле attachments)
  • время возникновения события в формате "yyyyMMddTHHmmssZ";
  • название файла;
  • размер файла;
  • IP-адрес пользователя, который совершил действие с файлом;
  • ID пользователя;
  • почтовый адрес пользователя;
  • ID задачи;
  • имя пользователя;
  • название организации пользователя.
GET https://api.pyrus.com/v4/fileaccesshistory?<params>

Заголовки ответа

Content-Type: application/octet-stream
Content-Disposition: attachment;filename=FileAccessHistory_After1000_Count1.csv

Тело ответа

evntid,action,attachmentId,utcdate,filename,filesize,fileversion,ip,personid,personemail,taskid,publicfileId,useragent,formid,personname,organization
4178974366,U,258228576,20230712T145932Z,имя_файла,1296,1,127.0.0.1,626316,email@gmail.com,172407340,,"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36",,Имя Фамилия,Название организации

curl

curl -X GET \
'https://api.pyrus.com/v4/fileaccesshistory?after=1000&count=1' \
-H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \

Параметры

after — целое число. В ответ попадают события, ID которых больше значения данного параметра.

count – количество событий в ответе. Максимальное значение — 100 000.

GET /taskaccesshistory

Получение CSV-файла с историей посещения задач

Метод позволяет получить историю посещения задач и возвращает следующие поля:

  • ID события;
  • Время возникновения события в формате "yyyyMMddTHHmmssZ";
  • IP-адрес пользователя, который прочел задачу;
  • ID пользователя;
  • почтовый адрес пользователя;
  • ID прочитанной задачи;
  • имя пользователя;
  • название организации пользователя.
GET https://api.pyrus.com/v4/taskaccesshistory?<params>

Заголовки ответа

Content-Type: application/octet-stream
Content-Disposition: attachment;filename=TaskAccessHistory_After1000_Count1.csv

Тело ответа

evntid,utcdate,personid,personname,personemail,taskid,isclosed,formtemplateid,ip,useragent,organization
32,20230810T220822Z,7804,имя фамилия,test@gmail.com,29995,False,43529,127.0.0.1,"Other, Other|testing environment, ver 104",Название организации (10550)

curl

curl -X GET \
'https://api.pyrus.com/v4/taskaccesshistory?after=1000&count=1' \
-H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \

Параметры

after — целое число. В ответ попадают события, ID которых больше значения данного параметра.

count – количество событий в ответе. Максимальное значение — 100 000.

Была ли эта статья полезной?