Журнал аудиту

Журнал аудиту фiксує кожну значну дiю, виконану у вашому облiковому записi Aether365.

Що фiксується

Кожен запис мiстить iдентифiкатор action, людського actor (електронна адреса, якщо доступна, iнакше user) та JSON-об'єкт details.

Категорiя	ID дiї	Примiтки
Облiковий запис	profile.updated	Змiна iменi / назви компанiї
	account.self_deleted	Самостiйне видалення
Сканування	scan.started	Ручний або запланований запуск
	scan.completed / scan.failed / scan.cancelled	Кiнцевий статус сканування
	scheduled_scan.created / .updated / .deleted	Керування розкладами
Пiдключення Microsoft	tenant.connected / tenant.disconnected	Первинна адмiнiстративна згода
	connection.activated	Встановлення основного пiдключення
	connection.removed	Вiд'єднання окремого пiдключення
	connection.label_updated	Перейменування пiдключення
Команда	member.invited / member.removed	Управлiння командою tenant'у
Сповiщення	notifications.updated	Канали Email + Teams
API-доступ	api_key.created / api_key.revoked	Функцiя Enterprise
SSO / SAML	sso.configured / sso.deleted	Функцiя Enterprise
Збереження журналiв	retention.updated	Функцiя Enterprise
Бiлiнг	billing.checkout.started	Створення сесiї Stripe Checkout
	subscription.created / subscription.updated / subscription.deleted	Подiї webhook Stripe
	invoice.payment_succeeded / invoice.payment_failed	Подiї webhook Stripe
Пiдтримка	support.ticket.created / support.ticket.replied	Дiяльнiсть служби пiдтримки

Перегляд журналу аудиту

Для доступу до журналу аудиту:

1. Перейдiть до Налаштування на бiчнiй панелi
2. Вiдкрийте вкладку Журнал аудиту

Журнал аудиту показує 500 останнiх записiв. Записи вiдсортованi вiд найновiших.

Фiльтрацiя

Сторiнка аудиту має чотири фiльтри зверху:

• Подiя - випадаючий список усiх дiй, що коли-небудь були записанi для вашого tenant'у.
• Виконавець - пошук пiдрядка без урахування регiстру за стовпцем електронної адреси.
• Вiд / До - календарнi селектори (значення до трактується як кiнець дня за мiсцевим часом).

Рядок фiльтрiв скидає посторiнковий вивiд на сторiнку 1 при кожнiй змiнi значення, а посилання Очистити фiльтри з'являється, коли будь-який фiльтр активний.

Експорт журналу аудиту

Для експорту журналу аудиту у CSV:

1. Вiдкрийте Налаштування > Журнал аудиту.
2. Застосуйте потрiбнi фiльтри.
3. Натиснiть Export CSV у верхньому правому кутi.

Експорт iтерує API посторiнково по 1000 рядкiв iз застосованими фiльтрами та завантажує CSV-файл у кодуваннi UTF-8 з назвою aether365-audit-YYYY-MM-DD.csv. Стовпцi: Time, Event (зрозумiла мiтка), Action ID, Actor, Details (JSON).

Журнал аудиту через API

Журнал аудиту доступний через REST API:

curl https://api.aether365.io/tenants/me/audit-logs \
  -H "Authorization: Bearer <token>"

Параметри запиту:

Параметр	Тип	Опис
page	integer	Номер сторiнки (за замовчуванням 1)
limit	integer	Результатiв на сторiнку (макс 1000)
action	string	Точний збiг за ID дiї
actor	string	Пошук пiдрядка за виконавцем без урахування регiстру
from	string	Часова мiтка ISO 8601 - нижня межа (включно)
to	string	Часова мiтка ISO 8601 - верхня межа (включно)

Приклад вiдповiдi

{
  "success": true,
  "data": [
    {
      "id": "f4b1c7d2-...",
      "action": "scan.started",
      "actor": "alice@example.com",
      "details": {
        "scanId": "8d3e1f...",
        "scanType": "compliance"
      },
      "createdAt": "2026-04-10T09:15:00Z"
    }
  ],
  "meta": {
    "total": 142,
    "page": 1,
    "limit": 50,
    "actions": ["api_key.created", "scan.started", "support.ticket.created"]
  }
}

meta.actions мiстить перелiк унiкальних ID дiй, якi використовувалися у вашому tenant'i - UI використовує його для заповнення випадаючого списку Подiя.

Збереження

Записи журналу аудиту зберiгаються протягом того ж перiоду, що i данi сканувань. Якщо вам потрiбен довший перiод збереження журналу аудиту для цiлей compliance, зверніться до support@aether365.io, щоб обговорити розширений варiант збереження.