Dzienniki audytu

Kto może to zrobić: Administratorzy firmy
Które plany: abonament Enterprise
Które platformy: Przeglądarka

Dzienniki audytu pozwalają administratorom organizacji posiadającym odpowiednie uprawnienia śledzić aktywność użytkowników w ich organizacji Miro. Dzienniki są niezwykle przydatne przy badaniu problemu lub przy tworzeniu szczegółowego raportu ważnych zdarzeń (na przykład zmian globalnych ustawień bezpieczeństwa, zaproszeń nowych użytkowników lub nowo utworzonych tablic).

✏️ Obecnie zdarzenia są rejestrowane od momentu utworzenia subskrypcji Enterprise i domyślnie przechowywane przez 180 dni:
a) Jeśli dokonasz zmiany na wyższą wersję i przejdziesz na Enterprise z innego abonamentu, zdarzenia będą rejestrowane od momentu tej zmiany.
b) Jeśli przeniesiesz niektóre zespoły do subskrypcji Enterprise, ich dane będą rejestrowane dopiero po dołączeniu do subskrypcji.

Dostęp do dzienników audytu

Aby uzyskać dostęp do dzienników audytu, wykonaj następujące czynności:

1. Przejdź do Ustawień firmy.
2. W lewym panelu kliknij Bezpieczeństwo > Dziennik audytu.
3. Możesz filtrować dziennik audytu, wybierając Zakres dat, jednego lub więcej Podmiotów (w tym aplikacje i agentów AI działających w imieniu użytkownika), jedną lub więcej Kategorii zdarzeń, jedno lub więcej konkretnych Zdarzeń oraz jeden lub więcej Obiektów objętych.

Kliknij przycisk Wyświetl zdarzenia, aby podejrzeć zdarzenia pasujące do zastosowanych filtrów. Czas jest wyświetlany w formacie ISO 8601, w strefie czasowej lokalnej. Szczegóły konkretnego zdarzenia możesz zobaczyć, klikając w menu z 3 kropkami w kolumnie Szczegóły.

✏️ Możesz podejrzeć zdarzenia sięgające wstecz do okresu retencji dziennika audytu w Twojej organizacji (do 365 dni).

Eksportowanie dzienników audytu

Możesz eksportować dzienniki w formacie pliku CSV.

W pliku eksportu CSV data i godzina zdarzenia są podane w formacie ISO 8601, w strefie czasowej UTC. Nie ma limitu liczby rekordów, które można wyeksportować naraz; jednak im więcej danych wyeksportujesz, tym dłużej potrwa przygotowanie pliku do pobrania. Pamiętaj też, że popularne aplikacje do pracy z tabelami mają ograniczenia dotyczące ilości danych, które mogą otworzyć. Wyeksportowany plik odzwierciedla wszystkie zastosowane filtry, w tym filtr „Obiekty objęte”.

Aby wyeksportować dzienniki, kliknij przycisk Eksportuj do CSV.

Poniżej pojawi się pasek z informacjami o pliku eksportu. Gdy plik będzie gotowy do pobrania, możesz kliknąć przycisk Pobierz CSV. Plik będzie dostępny do pobrania przez 24 godziny.

✏️ Obecnie w organizacji jednocześnie dostępny jest tylko jeden plik eksportu do pobrania. Kliknięcie przycisku Eksportuj do CSV zastąpi bieżący plik eksportu.

Dostęp do dzienników audytu przez API

Administratorzy firmy mogą użyć Audit Log API lub obsługiwanych SIEM Integrations, aby programowo uzyskać dostęp do danych z dziennika audytu i je zbierać.

API obsługuje te same filtry co interfejs (UI): wykonawca, kategoria zdarzeń, zdarzenie i obiekt, którego dotyczy — każdy z nich może przyjmować wiele wartości. Za pomocą API możesz pobrać pełną historię dziennika audytu swojej organizacji.

Wycofanie Audit Logs API v1

Wersja v1 Audit Logs API została wycofana. Jeśli masz własną integrację opartą na v1 (GET /v1/audit/logs), przenieś ją do v2 (GET /v2/audit/logs). Uwierzytelnianie i parametry zakresu czasu pozostają bez zmian, jednak paginacja, format odpowiedzi i niektóre nazwy pól różnią się — zobacz dokumentację API, aby poznać szczegóły. Jeśli używasz aplikacji dostarczonej przez Miro lub konektora z Marketplace (na przykład aplikacji Miro dla Splunk lub Microsoft Sentinel), zaktualizuj ją do najnowszej wersji, która już obsługuje v2.

Najważniejsze zmiany w odpowiedzi v2:

• Paginacja oparta na kursorze (wartość kursora traktowana jako niejawna) zamiast na offsetach; brak łącznej liczby wpisów.
• createdBy.id jest zwracane jako ciąg znaków (wcześniej liczba).
• Każde zdarzenie zawiera pole na najwyższym poziomie category.
• Identyfikatory zdarzeń to ciągi UUID (wcześniej liczbowy sufiks); traktuj je jako wartości niejawne.
• createdAt odzwierciedla moment zapisania zdarzenia, a nie dokładny czas wystąpienia akcji (zwykle opóźnienie kilku sekund).
• Pola details używają camelCase (np. organizationId), duże wartości liczbowe są serializowane jako ciągi znaków, znaczniki czasowe używają ISO 8601, a klucze o wartości null są pomijane.
• Dla akcji wykonywanych przez aplikację, integrację lub agenta AI w imieniu użytkownika obiekt aktora zawiera pole onBehalfOf identyfikujące tego użytkownika.
• Nazwa aktora dla niezalogowanych odwiedzających to teraz "Odwiedzający" (wcześniej "Gość").
• Zdarzenia dotyczące tablic odwołują się do publicznego boardKey zamiast do wewnętrznego identyfikatora numerycznego.
• Event types and categories that referenced "project" now use "space" (for example, project_created is now space_created); this applies retroactively to historical events retrieved via v2.

Usuwanie dzienników audytu

Administratorzy mogą ustawić zasadę retencji dla dzienników audytu. Można wybrać 30, 90, 180 lub 365 dni.

⚠️ Po usunięciu dzienników audytu nie można ich odzyskać.

✏️ Bezterminowa retencja dzienników audytu została wycofana.

Aby ustawić okres usuwania, wykonaj następujące kroki:

1. Przejdź do Ustawień firmy.
2. W lewym panelu kliknij Bezpieczeństwo > Dzienniki audytu.
3. W sekcji Dzienniki audytu kliknij kartę Ustawienia.
4. Wybierz opcję z listy rozwijanej. Zostaniesz poproszony(a) o potwierdzenie wyboru.

Zdarzenia w dziennikach audytu

Dzienniki audytu zawierają zapisy dotyczące następujących kategorii zdarzeń:

Często zadawane pytania