Аудит-логи

Аудит-логи позволяют отслеживать основные события и активность сотрудников вашей организации. Это может быть полезно при инцидентах и нарушении безопасности.

С помощью аудит-логов администраторы организации и менеджеры аудит-логов могут посмотреть, какие действия сотрудники организации выполняют в Трекере. Например, создание и изменение задач и проектов, изменение настроек очереди, создание досок задач и дашбордов.

Как подключить

Возможность использовать аудит-логи зависит от тарифа вашей организации Яндекс 360. Тарифы и их возможности описаны Справке Яндекс 360 для бизнеса.

Чтобы использовать аудит-логи, администратору нужно подключить эту функцию в кабинете организации. Как подключить аудит-логи

После подключения аудит-логов администратор обязан уведомить об этом всех пользователей и при необходимости получить их письменное согласие (если они не давали его ранее).

Как посмотреть логи

Для просмотра аудит-логов используйте API Яндекс 360. В кабинете организации просмотреть аудит-логи Трекера невозможно.

Для работы с API вам потребуются:

  • OAuth-токен с правами доступа к аудит-логам: ya360_security:read_auditlog. Чтобы получить токен, воспользуйтесь инструкцией на странице Доступ к API.

  • Идентификатор организации: откройте кабинет организации и выберите Общие настройки → Профиль организации. Идентификатор будет написан под названием организации.

Чтобы получить логи, сформируйте запрос:

curl -X GET -H "Authorization: OAuth {oauth_token}" https://cloud-api.yandex.net/v1/auditlog/organizations/{org_id}/events?ended_at={ended_at}&count={count}

В код подставьте обязательные значения:

  • {org_id} — идентификатор организации;
  • {oauth_token} — OAuth-токен;
  • {ended_at} — дата и время окончания аудит-лога в формате ISO 8601, например 2024-01-31T23:59:59;
  • {count} — количество событий на одной странице результатов от 1 до 100.

Полное описание всех методов для получения аудит-логов вы найдете в документации API Яндекс 360.

Список событий

Список событий Трекера, которые фиксируются в логах:

Имя события

Описание

Параметры

EntityAccessUpdated

Изменение прав доступа пользователя, группы или роли к сущности Трекера.

Список параметров события
  • entity_type — тип сущности. Допустимые значения:
    • queue — очередь,
    • board — доска,
    • dashboard — дашборд,
    • project — проект,
    • portfolio — портфель,
    • goal — цель,
    • report — отчёт,
    • component — компонент,
  • entity_id — внутренний идентификатор сущности,
  • entity_short_id — короткий числовой идентификатор сущности,
  • entity_key — ключ сущности (например, MYQUEUE),
  • entity_name — название сущности,
  • source — источник события,
  • users — список пользователей, для которых изменились права. Каждый элемент содержит:
    • passport_id — идентификатор пользователя в Паспорте,
    • cloud_id — идентификатор пользователя в облаке,
    • login — логин пользователя,
    • display — отображаемое имя пользователя,
    • is_robot — признак технического пользователя,
    • email — электронная почта пользователя,
    • access.old_value — список прав до изменения,
    • access.new_value — список прав после изменения,
  • groups — список групп, для которых изменились права. Каждый элемент содержит:
    • directory_id — идентификатор группы в Directory,
    • cloud_id — идентификатор группы в облаке,
    • display — отображаемое название группы,
    • type — тип группы,
    • access.old_value — список прав до изменения,
    • access.new_value — список прав после изменения,
  • roles — список ролей, для которых изменились права. Каждый элемент содержит:
    • id — идентификатор роли,
    • ru_display — отображаемое название роли,
    • access.old_value — список прав до изменения,
    • access.new_value — список прав после изменения.

IssueAccessUpdated

Изменение прав доступа пользователя к задаче — например, при добавлении компонента с ограниченным доступом.

Список параметров события
  • issue_id — внутренний идентификатор задачи,
  • issue_key — ключ задачи (например, MYQUEUE-42),
  • source — источник события,
  • components — компоненты, изменение которых повлекло смену прав доступа:
    • added[] — добавленные компоненты. Каждый элемент содержит:
      • id — идентификатор компонента,
      • name — название компонента,
    • removed[] — удалённые компоненты. Каждый элемент содержит:
      • id — идентификатор компонента,
      • name — название компонента,
  • fields[] — поля задачи, изменение которых повлекло смену прав доступа. Каждый элемент содержит:
    • id — идентификатор поля,
    • ru_display — отображаемое название поля,
    • users — пользователи, для которых изменились права:
      • added[] — пользователи, получившие доступ. Каждый элемент содержит:
        • passport_id — идентификатор в Паспорте,
        • cloud_id — идентификатор в облаке,
        • login — логин,
        • display — отображаемое имя,
        • robot — признак технического пользователя,
        • email — электронная почта,
      • removed[] — пользователи, потерявшие доступ (аналогичные поля).

IssueCreated

Создание задачи.

Список параметров события
  • issue_id — внутренний идентификатор задачи,
  • issue_key — ключ задачи (например, MYQUEUE-42),
  • source — источник события,
  • executed_triggers[] — триггеры, сработавшие при создании задачи. Каждый элемент содержит:
    • short_id — короткий идентификатор триггера,
    • name — название триггера,
  • applied_autoactions — автодействие, сработавшее при создании задачи:
    • short_id — короткий идентификатор автодействия,
    • name — название автодействия.

IssueUpdated

Изменение задачи — обновление полей, смена статуса.

Список параметров события
  • issue_id — внутренний идентификатор задачи,
  • issue_key — ключ задачи (например, MYQUEUE-42),
  • source — источник события,
  • executed_macros — макрос, применённый при изменении задачи:
    • short_id — короткий идентификатор макроса,
    • name — название макроса,
  • executed_triggers[] — триггеры, сработавшие при изменении задачи. Каждый элемент содержит:
    • short_id — короткий идентификатор триггера,
    • name — название триггера,
  • applied_autoactions — автодействие, сработавшее при изменении задачи:
    • short_id — короткий идентификатор автодействия,
    • name — название автодействия,
  • changes[] — список изменённых полей задачи. Каждый элемент содержит:
    • field_id — идентификатор поля,
    • field_type — тип поля: system — системное, custom — пользовательское, local — локальное,
    • ru_display — отображаемое название поля.

IssueCloned

Клонирование задачи.

Список параметров события
  • source_issue_id — внутренний идентификатор исходной задачи,
  • source_issue_key — ключ исходной задачи (например, MYQUEUE-42),
  • new_issue_id — внутренний идентификатор новой задачи,
  • new_issue_key — ключ новой задачи,
  • source — источник события,
  • executed_triggers[] — триггеры, сработавшие при клонировании. Каждый элемент содержит:
    • short_id — короткий идентификатор триггера,
    • name — название триггера,
  • applied_autoactions — автодействие, сработавшее при клонировании:
    • short_id — короткий идентификатор автодействия,
    • name — название автодействия.

IssueMoved

Перемещение задачи в другую очередь.

Список параметров события
  • issue_id — внутренний идентификатор задачи,
  • source — источник события,
  • old_issue_key — старый ключ задачи до перемещения,
  • new_issue_key — новый ключ задачи после перемещения,
  • old_queue_key — ключ исходной очереди,
  • new_queue_key — ключ целевой очереди.

IssueCommentAdded

Добавление комментария к задаче.

Список параметров события
  • issue_id — внутренний идентификатор задачи,
  • issue_key — ключ задачи (например, MYQUEUE-42),
  • source — источник события,
  • author — автор комментария:
    • passport_id — идентификатор в Паспорте,
    • cloud_id — идентификатор в облаке,
    • login — логин,
    • display — отображаемое имя,
    • is_robot — признак технического пользователя,
    • email — электронная почта,
  • comment — данные комментария:
    • id — идентификатор комментария,
    • reply_to — идентификатор комментария, на который дан ответ,
    • summon_users[] — упомянутые пользователи. Каждый элемент содержит:
      • passport_id — идентификатор в Паспорте,
      • cloud_id — идентификатор в облаке,
      • login — логин,
      • display — отображаемое имя,
      • is_robot — признак технического пользователя,
      • email — электронная почта.

IssueLinksChanged

Изменение связей задачи — добавление, удаление или изменение типа связи.

Список параметров события
  • issue_id — внутренний идентификатор задачи,
  • issue_key — ключ задачи (например, MYQUEUE-42),
  • source — источник события,
  • links — изменения связей:
    • added[] — добавленные связи. Каждый элемент содержит:
      • issue_id — идентификатор связанной задачи,
      • issue_key — ключ связанной задачи,
      • relationship — тип связи,
    • removed[] — удалённые связи. Каждый элемент содержит:
      • issue_id — идентификатор связанной задачи,
      • issue_key — ключ связанной задачи,
      • relationship — тип связи,
    • updated[] — изменённые связи. Каждый элемент содержит:
      • issue_id — идентификатор связанной задачи,
      • issue_key — ключ связанной задачи,
      • old_relationship — прежний тип связи,
      • new_relationship — новый тип связи.

MetaEntityCreated

Создание мета-сущности — проекта, портфеля, цели или отчёта.

Список параметров события
  • entity_type — тип сущности. Допустимые значения:
    • project — проект,
    • portfolio — портфель,
    • goal — цель,
    • report — отчёт,
  • entity_id — внутренний идентификатор сущности,
  • entity_short_id — короткий числовой идентификатор сущности,
  • source — источник события.

MetaEntityUpdated

Изменение мета-сущности — проекта, портфеля, цели или отчёта.

Список параметров события
  • entity_type — тип сущности. Допустимые значения:
    • project — проект,
    • portfolio — портфель,
    • goal — цель,
    • report — отчёт,
  • entity_id — внутренний идентификатор сущности,
  • entity_short_id — короткий числовой идентификатор сущности,
  • source — источник события.

QueueCreatedEvent

Создание очереди.

Список параметров события
  • queue_id — внутренний идентификатор очереди,
  • queue_short_id — короткий числовой идентификатор очереди,
  • queue_key — ключ очереди (например, MYQUEUE),
  • queue_name — название очереди,
  • source — источник события.

QueueUpdatedEvent

Изменение настроек очереди — владельца, команды, наблюдателей.

Список параметров события
  • queue_id — внутренний идентификатор очереди,
  • queue_short_id — короткий числовой идентификатор очереди,
  • queue_key — ключ очереди (например, MYQUEUE),
  • queue_name — название очереди,
  • source — источник события,
  • lead_change — изменение владельца очереди:
    • old_lead — прежний владелец:
      • passport_id — идентификатор в Паспорте,
      • cloud_id — идентификатор в облаке,
      • login — логин,
      • display — отображаемое имя,
      • is_robot — признак технического пользователя,
      • email — электронная почта,
    • new_lead — новый владелец (аналогичные поля),
  • team_change — изменения в составе команды очереди:
    • added[] — добавленные участники (поля аналогичны old_lead),
    • removed[] — удалённые участники (поля аналогичны old_lead),
  • followers_change — изменения в списке наблюдателей очереди:
    • added[] — добавленные наблюдатели (поля аналогичны old_lead),
    • removed[] — удалённые наблюдатели (поля аналогичны old_lead).

ComponentCreatedEvent

Создание компонента очереди.

Список параметров события
  • queue_id — внутренний идентификатор очереди,
  • queue_short_id — короткий числовой идентификатор очереди,
  • queue_key — ключ очереди,
  • queue_name — название очереди,
  • source — источник события,
  • component_id — внутренний идентификатор компонента,
  • component_short_id — короткий числовой идентификатор компонента,
  • component_name — название компонента.

ComponentUpdatedEvent

Изменение компонента очереди.

Список параметров события
  • queue_id — внутренний идентификатор очереди,
  • queue_short_id — короткий числовой идентификатор очереди,
  • queue_key — ключ очереди,
  • queue_name — название очереди,
  • source — источник события,
  • component_id — внутренний идентификатор компонента,
  • component_short_id — короткий числовой идентификатор компонента,
  • component_name — название компонента.

ComponentDeletedEvent

Удаление компонента очереди.

Список параметров события
  • queue_id — внутренний идентификатор очереди,
  • queue_short_id — короткий числовой идентификатор очереди,
  • queue_key — ключ очереди,
  • queue_name — название очереди,
  • source — источник события,
  • component_id — внутренний идентификатор компонента,
  • component_short_id — короткий числовой идентификатор компонента,
  • component_name — название компонента.

AutomatizationCreatedEvent

Создание автоматизации в очереди — триггера, автодействия или макроса.

Список параметров события
  • queue_id — внутренний идентификатор очереди,
  • queue_short_id — короткий числовой идентификатор очереди,
  • queue_key — ключ очереди,
  • queue_name — название очереди,
  • source — источник события,
  • automatization_type — тип автоматизации: trigger — триггер, autoaction — автодействие, macro — макрос,
  • automatization_short_id — короткий числовой идентификатор автоматизации,
  • automatization_name — название автоматизации.

AutomatizationUpdatedEvent

Изменение автоматизации в очереди — триггера, автодействия или макроса.

Список параметров события
  • queue_id — внутренний идентификатор очереди,
  • queue_short_id — короткий числовой идентификатор очереди,
  • queue_key — ключ очереди,
  • queue_name — название очереди,
  • source — источник события,
  • automatization_type — тип автоматизации: trigger — триггер, autoaction — автодействие, macro — макрос,
  • automatization_short_id — короткий числовой идентификатор автоматизации,
  • automatization_name — название автоматизации.

AutomatizationDeletedEvent

Удаление автоматизации из очереди — триггера, автодействия или макроса.

Список параметров события
  • queue_id — внутренний идентификатор очереди,
  • queue_short_id — короткий числовой идентификатор очереди,
  • queue_key — ключ очереди,
  • queue_name — название очереди,
  • source — источник события,
  • automatization_type — тип автоматизации: trigger — триггер, autoaction — автодействие, macro — макрос,
  • automatization_short_id — короткий числовой идентификатор автоматизации,
  • automatization_name — название автоматизации.

BoardCreatedEvent

Создание доски.

Список параметров события
  • board_short_id — внутренний идентификатор доски,
  • board_key — ключ доски,
  • board_name — название доски,
  • source — источник события.

BoardUpdatedEvent

Изменение доски — например, смена владельца.

Список параметров события
  • board_short_id — внутренний идентификатор доски,
  • board_key — ключ доски,
  • board_name — название доски,
  • source — источник события,
  • owner_change — изменение владельца доски:
    • old_owner — прежний владелец:
      • passport_id — идентификатор в Паспорте,
      • cloud_id — идентификатор в облаке,
      • login — логин,
      • display — отображаемое имя,
      • is_robot — признак технического пользователя,
      • email — электронная почта,
    • new_owner — новый владелец (аналогичные поля).

BoardDeletedEvent

Удаление доски.

Список параметров события
  • board_short_id — внутренний идентификатор доски,
  • board_key — ключ доски,
  • board_name — название доски,
  • source — источник события.

DashboardCreatedEvent

Создание дашборда.

Список параметров события
  • dashboard_short_id — внутренний идентификатор дашборда,
  • dashboard_name — название дашборда,
  • source — источник события,
  • owner — владелец дашборда:
    • passport_id — идентификатор в Паспорте,
    • cloud_id — идентификатор в облаке,
    • login — логин,
    • display — отображаемое имя,
    • is_robot — признак технического пользователя,
    • email — электронная почта.

DashboardUpdatedEvent

Изменение дашборда.

Список параметров события
  • dashboard_short_id — внутренний идентификатор дашборда,
  • dashboard_name — название дашборда,
  • source — источник события,
  • owner_change — изменение владельца дашборда:
    • old_owner — прежний владелец:
      • passport_id — идентификатор в Паспорте,
      • cloud_id — идентификатор в облаке,
      • login — логин,
      • display — отображаемое имя,
      • is_robot — признак технического пользователя,
      • email — электронная почта,
    • new_owner — новый владелец (аналогичные поля).

DashboardDeletedEvent

Удаление дашборда.

Список параметров события
  • dashboard_short_id — внутренний идентификатор дашборда,
  • dashboard_name — название дашборда,
  • source — источник события.

WidgetCreatedEvent

Создание виджета на дашборде.

Список параметров события
  • dashboard_short_id — внутренний идентификатор дашборда, которому принадлежит виджет,
  • widget_short_id — внутренний идентификатор виджета,
  • widget_type — тип виджета,
  • source — источник события,
  • widget_description — описание виджета.

WidgetUpdatedEvent

Изменение виджета на дашборде.

Список параметров события
  • dashboard_short_id — внутренний идентификатор дашборда, которому принадлежит виджет,
  • widget_short_id — внутренний идентификатор виджета,
  • widget_type — тип виджета,
  • source — источник события,
  • widget_description — описание виджета.

WidgetDeletedEvent

Удаление виджета с дашборда.

Список параметров события
  • dashboard_short_id — внутренний идентификатор дашборда, которому принадлежит виджет,
  • widget_short_id — внутренний идентификатор виджета,
  • widget_type — тип виджета,
  • source — источник события,
  • widget_description — описание виджета.

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