Auditný protokol

Auditný protokol zaznamenáva každú významnú akciu vykonanú vo vašom účte Aether365.

Čo sa zaznamenáva

Každý záznam obsahuje ID action, ľudského actor (e-mail ak je k dispozícii, inak user) a JSON details payload.

Kategória	ID akcie	Poznámky
Účet	profile.updated	Zmena celého mena / názvu firmy
	account.self_deleted	Samoobslužné vymazanie účtu
Skeny	scan.started	Manuálne alebo plánované spustenie
	scan.completed / scan.failed / scan.cancelled	Konečný stav skenu
	scheduled_scan.created / .updated / .deleted	Správa plánovaných skenov
Pripojenia Microsoftu	tenant.connected / tenant.disconnected	Prvotný administrátorský súhlas
	connection.activated	Nastavenie ako primárne pripojenie
	connection.removed	Odpojenie jedného pripojenia
	connection.label_updated	Premenovanie uloženého pripojenia
Tím	member.invited / member.removed	Správa tímu na úrovni tenantu
Notifikácie	notifications.updated	E-mailové + Teams kanály
API prístup	api_key.created / api_key.revoked	Funkcia Enterprise
SSO / SAML	sso.configured / sso.deleted	Funkcia Enterprise
Uchovávanie záznamov	retention.updated	Funkcia Enterprise
Fakturácia	billing.checkout.started	Vytvorená Stripe Checkout relácia
	subscription.created / subscription.updated / subscription.deleted	Udalosti Stripe webhook
	invoice.payment_succeeded / invoice.payment_failed	Udalosti Stripe webhook
Podpora	support.ticket.created / support.ticket.replied	Aktivita help-desku

Zobrazenie auditného protokolu

Pre prístup k auditnému protokolu:

1. Prejdite na Nastavenia v bočnom menu
2. Otvorte záložku Auditný protokol

Auditný protokol zobrazuje 500 najnovších záznamov. Záznamy sú zoradené od najnovšieho.

Filtrovanie

Stránka auditu má v hornej časti štyri filtre:

• Udalosť - rozbaľovací zoznam obsahujúci každú akciu, ktorú váš tenant zaznamenal.
• Aktér - porovnanie podreťazca v stĺpci e-mail (bez rozlišovania veľkosti písmen).
• Od / Do - výber dátumu (hodnota do sa interpretuje ako koniec dňa v lokálnom čase).

Riadok filtra resetuje stránkovanie na stránku 1 pri každej zmene hodnoty a po aktivácii akéhokoľvek filtra sa zobrazí odkaz Zrušiť filtre.

Export auditného protokolu

Pre export auditného protokolu ako CSV:

1. Otvorte Nastavenia > Auditný protokol.
2. Aplikujte požadované filtre.
3. Kliknite na Export CSV v pravom hornom rohu.

Export iteruje API v stránkach po 1000 riadkov s aplikovanými filtrami a stiahne UTF-8 CSV súbor s názvom aether365-audit-YYYY-MM-DD.csv. Stĺpce: Čas, Udalosť (ľudský popis), ID akcie, Aktér, Detaily (JSON).

Auditný protokol cez API

Auditný protokol je prístupný cez REST API:

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

Parametre dopytu:

Parameter	Typ	Popis
page	integer	Číslo stránky (predvolené 1)
limit	integer	Výsledkov na stránku (max 1000)
action	string	Presná zhoda s ID akcie
actor	string	Porovnanie podreťazca s aktérom (bez rozlišovania veľkosti)
from	string	Časová pečiatka ISO 8601 - dolná hranica (vrátane)
to	string	Časová pečiatka ISO 8601 - horná hranica (vrátane)

Príklad odpovede

{
  "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 uvádza zoznam rôznych ID akcií, ktoré váš tenant použil - UI ho používa na naplnenie rozbaľovacieho zoznamu Udalosť.

Uchovávanie

Záznamy auditného protokolu sa uchovávajú rovnakú dobu ako dáta skenov. Ak vyžadujete dlhšie uchovávanie auditného protokolu z dôvodov zhody, kontaktujte support@aether365.io pre diskusiu o rozšírenej možnosti uchovávania.