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.

PolePoznámky
AktérUživatel nebo klíč API, který akci provedl
AkceTypovaná hodnota, například engine.created nebo member.role_changed
CílEntita, které se akce týkala (např. engine, role nebo položka glosáře)
MetadataID souvisejících entit — nikdy jména, e-mailové adresy ani úryvky obsahu
Kontext požadavkurequest_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.

KategorieAktuálně zaznamenávané akce
Organizaceorg.created, org.settings_updated, org.deleted
Členovémember.invited, member.removed, member.role_changed
Rolerole.created, role.updated, role.deleted
Engineengine.created, engine.updated, engine.deleted
Klíče APIapi_key.created, api_key.revoked
Obsahglossary_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:

  1. Nárok na funkci — organizace musí mít aktivní funkci auditních logů (plán Enterprise).
  2. 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 seq s 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.

Další kroky #