Auditní logy
Procházejte historii akcí měnících stav vaší organizace — kdo co udělal, kdy a odkud. Do historie lze pouze přidávat a případné neoprávněné zásahy lze odhalit.
Auditní logy nabízejí časovou osu podporovaných akcí správy ve vaší organizaci s možností vyhledávání a filtrování. Zaznamenávají například přiřazení rolí, úpravy engine a vydání klíčů API. Podívejte se na omezení rozsahu záznamů. Jsou dostupné s plánem Enterprise spolu s funkcí Role a oprávnění.
Už na úrovni databáze lze do logu pouze přidávat: databázové připojení aplikace nemůže auditní řádky aktualizovat, mazat ani odstranit příkazem TRUNCATE. Co se zapíše, zůstane zapsáno.
Co se zaznamenává #
Každá událost zachycuje aktéra, akci, cíl a kontext HTTP, ve kterém požadavek dorazil.
| Pole | Poznámky |
|---|---|
| Aktér | Uživatel nebo klíč API, který akci provedl |
| Akce | Typovaná hodnota, například engine.created nebo member.role_changed |
| Cíl | Entita, které se akce týkala (např. engine, role nebo položka glosáře) |
| Metadata | ID souvisejících entit — nikdy jména, e-mailové adresy ani úryvky obsahu |
| Kontext požadavku | request_id, IP adresa, identifikace klienta — zaznamenávají se při přijetí volání přes HTTP |
| Časové razítko | Čas v UTC a monotónní pořadové číslo pro odhalování mezer |
Záměrně jen ID
Do sloupce metadat se ukládají ID, nikoli hodnoty čitelné pro člověka. Rozhraní k nim při načítání přiřazuje aktuální názvy a jména, takže přejmenování engine nebo uživatele nepřepisuje historii. Auditní řádky se tak ani nedostávají do rozporu s právem na výmaz podle GDPR — neobsahují žádný obsah, který by bylo třeba odstranit.
Zaznamenávané akce #
Události jsou rozdělené do kategorií, které odpovídají filtru na řídicím panelu.
| Kategorie | Aktuálně zaznamenávané akce |
|---|---|
| Organizace | org.created, org.settings_updated, org.deleted |
| Členové | member.invited, member.removed, member.role_changed |
| Role | role.created, role.updated, role.deleted |
| Engine | engine.created, engine.updated, engine.deleted |
| Klíče API | api_key.created, api_key.revoked |
| Obsah | glossary_item.*, instruction.*, brand_voice.* (pouze jednotlivé operace) |
Přístup k logu #
Položka Protokol auditu se v Nastavení v části Správa zobrazuje vždy. Pokud váš plán tuto funkci nezpřístupňuje, uvidíte místo časové osy zprávu „Protokol auditu není dostupný ve vašem plánu“. Na stránce najdete:
- Seznam s filtry — výsledky zúžíte pomocí filtrů Akce, Aktér a Období (předvolba, například Posledních 7 dní, nebo rozsah dat Od / Do). Budoucí data nelze vybrat.
- Načíst starší události — nejnovější události se zobrazují jako první. Kliknutím na Načíst starší události na konci seznamu načtete další stránku.
- Detail události — kliknutím na libovolný řádek jej rozbalíte přímo v seznamu a zobrazíte úplná metadata, ID požadavku, IP adresu a identifikaci klienta.
- Sdílení zobrazení — filtry i otevřená událost se promítají do URL, takže můžete sdílet libovolné zobrazení.
Kdo může log zobrazit #
Přístup na stránku má dvě podmínky:
- Nárok na funkci — organizace musí mít aktivní funkci auditních logů (plán Enterprise).
- Oprávnění — role uživatele, který stránku prohlíží, musí zahrnovat
org:view_audit_logs. Předem vytvořená role Plný přístup toto oprávnění obsahuje ve výchozím nastavení; vlastníci ho mají vždy.
Členům bez oprávnění se místo časové osy zobrazí stránka „Přístup odepřen“. Členům organizace bez nároku na funkci se zobrazí výzva k přechodu na placený plán.
Když vyprší platnost plánu Enterprise
Přístup k auditním logům vyžaduje stejnou úroveň plánu jako RBAC. Dřívější události zůstanou v databázi, ale stránka zobrazí zprávu „Protokol auditu není dostupný ve vašem plánu“ a koncové body pro čtení budou až do obnovení plánu vracet stav 403.
Odhalování neoprávněných zásahů #
Auditní logy nejsou jen záznamem — jejich dodatečné pozměnění je výrazně ztížené.
- Už na úrovni databáze lze pouze přidávat. Migrace, která vytváří tabulku, provede pro roli API
REVOKE UPDATE, DELETE, TRUNCATE. Jakýkoli budoucí pokus o změnu z kódu — ať už kvůli chybě, novému koncovému bodu, nebo dokonce útoku pomocí vložení SQL — Postgres odmítne dříve, než dojde ke změně řádku. - Monotónní posloupnost. Každý řádek má sloupec
seqs přísně rostoucí hodnotou. Auditor tak při kontrole posloupnosti odhalí smazané záznamy podle mezer.
To postačuje pro kontrolní mechanismy typu SOC 2. Nechrání to však před útočníkem s přímými přihlašovacími údaji k produkční databázi — silnější zabezpečení (samostatná role vlastníka, zrcadlo WORM) je dostupné na vyžádání.
Doba uchovávání #
Auditní události se ve výchozím nastavení uchovávají neomezeně. Vlastní doby uchovávání — obvykle 1, 3 nebo 7 let — jsou dostupné s plánem Enterprise. Ozvěte se, pokud potřebujete konkrétní zásady uchovávání pro splnění předpisů nebo požadavků bezpečnostních dotazníků.
Co zatím není podporováno #
První verze má několik záměrných omezení, o kterých je dobré vědět:
- Zápis bez záruky, nikoli transakčně. Transakční zápis plánujeme v blízké době. Auditní událost se zapisuje až po akci, kterou popisuje — nikoli v rámci stejné databázové transakce. Ve vzácných případech selhání (kdy akce uspěje, ale následný zápis auditního záznamu selže) tak může akce proběhnout bez odpovídající události.
- Některé typy akcí se zatím nezaznamenávají. Změny členství v engine, připojení / aktualizace / odpojení integrací, úpravy konfigurace modelů, změny fakturačního předplatného a hromadné operace s obsahem (nahrání CSV,
createMany/updateMany/deleteMany) zatím nevytvářejí události. Označení těchto akcí jsou rezervovaná, takže se po zavedení jejich zaznamenávání objeví ve stávajících kategoriích filtru. - Čtení se nezaznamenává. Zobrazení samotného auditního logu, procházení logů požadavků engine ani stažení glosáře nevytváří události. Ty vznikají pouze při akcích měnících stav.
- Zatím bez exportů. Auditní data jsou dostupná na řídicím panelu. Export CSV, webhook pro SIEM a zrcadlo S3 plánujeme — dejte nám vědět, pokud je potřebujete.
- Bez zobrazení pro konkrétní engine. Všechny auditní události organizace se zobrazují na jedné časové ose. Výběr zúžíte filtrováním podle akce nebo aktéra.
- Bez průběžného načítání událostí. Není zde tlačítko Obnovit ani datový proud přes WebSocket — novější události načtete obnovením stránky.