# 감사 로그

Verkada의 감사 로그 기능은 다음 내에서 발생하는 사용자 및 장치 활동을 캡처합니다 [Verkada Command](/command/ko/getting-started/get-started-with-verkada-command.md) 플랫폼. 이러한 로그는 2개 수준에서 유지됩니다:

* **조직 수준** - 조직이 생성된 시점부터
* **개별 카메라 수준** - 카메라가 추가된 시점부터

***

## 감사 로그 기능

감사 로그는 시스템 접근을 추적하고 각 작업을 사용자와 연결합니다. 기록되는 이벤트 유형의 예는 다음과 같습니다:

* 사용자 로그인
* 사용자 관리(사용자 추가, 수정, 삭제)
* 조직, 사이트 및 그룹 생성
* 사이트 간 카메라 이동
* 조회된 비디오 영상(실시간, 과거, 아카이브)
* Verkada 지원 작업

이벤트에는 다음과 같은 구체적인 정보가 포함됩니다:

* 작업이 발생한 시각의 타임스탬프
* 작업을 수행한 사용자 또는 장치의 IP 주소
* 작업을 수행한 사용자 이름, 전화번호 또는 장치

시스템 활동을 검토할 때 원하는 내용을 찾을 수 있도록, 감사 로그 페이지에서 사용할 수 있는 필터는 이벤트 데이터를 다음 범주로 나눕니다:

* **수행된 작업**
* **영향을 받은 대상** (사용자, 장치 또는 설정)
* **수행 주체** (사용자, 관리자 또는 시스템)

검색 인터페이스에는 다음 필터 범주가 있는 사이드 패널이 포함됩니다:

* **기간**
* **행위자** (사용자/시스템 시작)
* **이벤트**: 관리자, 사용자 관리, 장치 관리, 카메라, 출입 통제, 센서, 알람, 신규 알람, 인터콤, 워크플레이스, 게이트웨이, 통합, 기타
* **대상**: 사용자 또는 장치
* **장치 유형**:
* **일련번호**

{% hint style="warning" %}
해당 **이벤트** 필터는 관련 작업을 그룹화하여 특정 이벤트 유형을 더 쉽게 찾을 수 있게 합니다. 분기별 감사 또는 장기 조사에 활용할 수 있도록 한 번에 최대 90일치 로그를 조회할 수 있습니다.
{% endhint %}

***

## 조직 감사 로그 보기

다음 권한이 있는 사용자 [조직 관리자](/verkada-cameras/ko/getting-started/roles-and-permissions-for-cameras.md) 권한이 있으면 다음과 같이 감사 로그에 액세스할 수 있습니다:

{% stepper %}
{% step %}
**Verkada Command에서 All Products > Admin으로 이동합니다.**
{% endstep %}

{% step %}
**왼쪽 탐색 메뉴에서 Security & Logs를 선택합니다.**
{% endstep %}

{% step %}
**Audit Log를 클릭합니다.**
{% endstep %}

{% step %}
**(선택 사항) AI Search를 사용하여 감사 로그 이벤트를 찾고 필터링합니다.**&#x20;

{% hint style="danger" %}
감사 로그에서 AI Search를 사용하려면 조직에서 AI 기반 Search가 활성화되어 있어야 합니다. 조직 관리자는 다음으로 이동하여 AI 기반 Search를 활성화할 수 있습니다 **Admin > Feature Manager > AI Features**. 자세한 내용은 [Feature Manager](/command/ko/organization-settings/manage-your-admin-page-settings/feature-manager.md) 를 참조하세요.
{% endhint %}
{% endstep %}

{% step %}
**(선택 사항) 기본 범주 필터를 사용하여 범주별 일반 감사 로그 이벤트를 빠르게 확인합니다.**

{% hint style="info" %}
이러한 사전 필터링된 보기에서는 대량의 시스템 로그보다 관련 데이터가 우선 표시되므로 중요한 내용에 더 쉽게 집중할 수 있습니다.
{% endhint %}
{% endstep %}

{% step %}
**(선택 사항) 사용자 지정 예약 보고서를 생성합니다.**

1. 원하는 필터를 적용하여 감사 로그를 관련 데이터로 좁힙니다.
2. 클릭 **Save as Report** 선택한 필터를 기반으로 사용자 지정 보고서를 생성합니다.
3. 선택 **Schedule Report** 를 선택하여 감사 로그를 지정된 수신자에게 매일, 매주 또는 매월 자동으로 이메일로 보냅니다.
   {% endstep %}

{% step %}
**Export를 클릭하여 감사 이벤트를 CSV 파일로 다운로드합니다.**
{% endstep %}
{% endstepper %}

***

## 카메라별 감사 로그 보기

다음 권한이 있는 사용자 [사이트 관리자](/verkada-cameras/ko/getting-started/roles-and-permissions-for-cameras.md) 카메라가 속한 사이트에 대한 권한이 있으면 카메라별 감사 로그에 액세스할 수 있습니다.

{% stepper %}
{% step %}
**Verkada Command에서 All Products > Cameras로 이동합니다.**
{% endstep %}

{% step %}
**카메라를 선택합니다.**
{% endstep %}

{% step %}
**카메라 피드 오른쪽에서 Settings를 클릭합니다.**
{% endstep %}

{% step %}
**General 아래에서 Audit Log를 선택합니다.**
{% endstep %}

{% step %}
**(선택 사항) 필터 또는 검색창을 사용하여 이벤트를 좁힙니다.**
{% endstep %}

{% step %}
**Export를 클릭하여 카메라의 감사 이벤트를 CSV로 다운로드합니다.**
{% endstep %}
{% endstepper %}

***

## 모든 카메라의 카메라 감사 로그 내보내기

다음 권한이 있는 사용자 [조직 관리자](/verkada-cameras/ko/getting-started/roles-and-permissions-for-cameras.md) 권한이 있으면 해당 조직의 모든 카메라 감사 로그를 단일 CSV로 내보낼 수 있습니다.

{% stepper %}
{% step %}
**Verkada Command에서 All Products > Cameras로 이동합니다.**
{% endstep %}

{% step %}
**왼쪽 탐색 메뉴에서 Camera Settings를 클릭합니다.**
{% endstep %}

{% step %}
**Export Camera Audit Log 아래에서 드롭다운을 클릭하고 기간을 설정합니다.**
{% endstep %}

{% step %}
**Export CSV를 선택합니다.**

<div align="left" data-with-frame="true"><img src="/files/f55a3af5d5a1a3dfcb0aeef3afd357f2bc150e22" alt="" width="595"></div>
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
내보내기는 30일로 제한됩니다. 더 넓은 날짜 범위를 내보내려면 여러 번 내보내기를 수행해야 합니다.
{% endhint %}

***

## 카메라 목록 내보내기

다음 권한이 있는 사용자 [조직 관리자](/verkada-cameras/ko/getting-started/roles-and-permissions-for-cameras.md) 권한이 있으면 모든 카메라 정보가 포함된 CSV 파일을 내보낼 수 있습니다.

{% stepper %}
{% step %}
**Verkada Command에서 All Products > Cameras로 이동합니다.**
{% endstep %}

{% step %}
**왼쪽 탐색 메뉴에서 Camera Settings를 클릭합니다.**
{% endstep %}

{% step %}
**Export Camera List 아래에서 Export CSV를 선택합니다.**
{% endstep %}
{% endstepper %}

CSV에는 다음이 포함됩니다:

* 카메라 이름
* 사이트
* 위치
* 모델
* 일련번호
* 조직에 추가된 날짜
* 장치 보존 기간
* 클라우드 백업 보존 기간
* 펌웨어 상태
* 로컬 IP
* 미디어 액세스 제어(MAC) 주소
* 상태
* 마지막 온라인 날짜

{% hint style="warning" %}
내보내기 프로세스는 카메라 수와 선택한 날짜 범위에 따라 최대 1분이 걸릴 수 있습니다.
{% endhint %}

***

## 모든 감사 로그 이벤트 이해하기

<details>

<summary>사용자 로그인</summary>

* **사용자 로그인 시도**: 로그인 성공 또는 실패와 그 이유를 표시합니다
* **사용자 로그아웃 시도**: 로그아웃 성공 또는 실패와 그 이유를 표시합니다

</details>

<details>

<summary>Verkada 지원 액세스</summary>

고객이 Verkada 지원팀 구성원에게 액세스 권한을 부여하면, 해당 이벤트와 세부 정보(시간, 액세스 창 크기 등), 그리고 지원팀 구성원이 수행한 작업(예: 구성 변경)이 함께 기록됩니다. 이러한 작업이 수행될 때 알림을 설정할 수 있습니다.

* **지원 액세스**: 관리자 사용자가 Verkada 지원팀 구성원에게 조직 액세스 권한을 부여했습니다.
* **지원 액세스 부여됨**: 관리자가 Verkada 지원 액세스 창을 생성하거나 수정했습니다. 이 이벤트는 관리자가 Verkada 지원팀 구성원이 조직에 액세스할 수 있는 기간을 생성하거나 수정할 때 발생합니다.

</details>

<details>

<summary>사용자 관리</summary>

* **사용자 CSV 내보내기**: 이 조직에서 사용자 목록이 내보내졌습니다
* **사용자가 조직에 추가됨**: 사용자가 추가되었습니다
* **사용자가 조직에서 제거됨**: 사용자가 제거되었습니다
* **여러 사용자가 조직에서 제거됨**: 여러 사용자가 제거되었습니다
* **조직 사용자 프로비저닝됨**: SCIM에 의해 사용자가 추가되었습니다
* **사용자의 조직 가입 초대 재전송**: 조직의 기존 사용자에게 초대가 전송되었습니다
* **사용자 생성됨**: 조직 내에 새 사용자가 생성되었습니다
* **사용자 초대됨**: 새 사용자가 조직에 초대되었습니다
* **사용자 로그인**: 사용자가 로그인을 시도했습니다
* **사용자 로그아웃**: 사용자가 로그아웃했습니다
* **사용자 이메일 수정됨**: 사용자의 이메일이 변경되었습니다
* **사용자 고용 정보 수정됨**: 출입 사용자 직원 정보가 변경되었습니다
* **사용자 이름 수정됨:** 사용자의 이름 및/또는 성이 변경되었습니다
* **사용자 비밀번호 변경됨**: 사용자가 자신의 비밀번호를 변경했습니다
* **사용자 권한 수정됨**: 사용자 권한이 수정되었습니다
* **사용자 역할 수정됨**: 액세스 역할 권한을 포함한 사용자 권한이 수정되었습니다
* **사용자가 RTSP 자격 증명을 수정함**: 사용자가 카메라에서 RTSP(실시간 스트리밍 프로토콜) 변경을 수행했습니다
* **사용자 기본 설정 지정됨**: 사용자가 기본 설정을 지정하거나 변경했습니다
* **2단계 인증 재설정**: 2단계 인증이 재설정되었습니다
* **SAML 구성 생성됨**: 새 Security Assertion Markup Language(SAML) 구성이 생성되었습니다
* **SAML 구성 삭제됨**: SAML 구성이 삭제되었습니다
* **SAML IDP 시작됨:** SAML IDP(Identity Provider)가 시작되었습니다
* **SAML 구성 업데이트됨**: SAML 구성이 업데이트되었습니다
* **SCIM 공급자 생성됨**: 새 SCIM(System for Cross-domain Identity Management) 공급자가 생성되었습니다
* **SCIM 공급자 삭제됨**: SCIM 공급자가 삭제되었습니다
* **SCIM 공급자 수정됨**: SCIM 공급자가 수정되었습니다
* **SCIM 토큰 재생성됨**: SCIM 토큰이 재생성되었습니다
* **사용자 그룹 작업 수행됨**: 사용자 그룹이 생성, 수정 또는 삭제되었습니다
* **여러 사용자가 조직에서 제거됨**: 사용자 또는 사용자 집합이 조직에서 제거되었습니다
* **강제 로그아웃 요청됨**: 관리자가 사용자를 강제로 로그아웃했습니다

</details>

<details>

<summary>조직, 사이트 및 그룹 작업</summary>

* **조직 수정됨**: Verkada Command에서 조직 이름이 변경되었습니다
* **조직 속성 수정됨**: 조직의 속성 또는 설정이 수정되었습니다
* **사이트 작업 수행됨**: 사이트가 생성, 수정 또는 삭제되었습니다
* **Webhook 전환됨**: Webhook이 활성화되거나 비활성화되었습니다
* **API 키 수정됨**: API 키가 생성되거나 수정되었습니다

</details>

<details>

<summary>장치 관리</summary>

* **장치 설치됨**: 사용자가 Command에 새 장치를 추가했습니다
* **장치 제거됨**: 사용자가 Command에서 장치를 제거했습니다
* **장치가 원격으로 액세스됨**: 지원팀이 이 장치에 액세스했습니다
* **라이선스 클레임 이벤트**: 라이선스 키가 조직에 추가되었습니다
* **라이선스 부여 이벤트**: Verkada가 조직에 추가 라이선스를 부여했습니다
* **체험판 재정의 이벤트**: Verkada가 이 조직의 체험 기간에 일수를 추가했습니다
* **Viewing Station 그리드 업데이트됨**: Viewing Station이 변경되었습니다

</details>

<details>

<summary>카메라 이벤트</summary>

* **아카이브 작업 수행됨**: 사용자가 비디오 아카이브를 생성, 수정 또는 삭제했습니다
* **카메라 구성 수정됨**: 사용자가 카메라 구성을 수정했습니다. 어떤 구성인지 자세한 내용을 참조하세요
* **프로필 이미지 다운로드됨**: 사용자가 카메라 영상에서 정지 이미지를 다운로드했습니다
* **프로필 이미지 업로드됨**: 사용자가 프로필에 이미지를 업로드했습니다
* **ID로 프로필 결과 검색됨**: 프로필이 사람 검색에 사용되었습니다
* **프로필 사진 추가됨:** 사용자가 사람 프로필 사진을 추가했습니다
* **프로필 생성됨**: 사용자가 Command에서 사람 프로필을 생성하고 이름을 지정했습니다
* **프로필 삭제됨**: 사람 프로필이 삭제되었습니다
* **프로필 조회됨**: 사용자가 프로필/사람을 조회했습니다
* **프로필 병합됨**: 사용자가 두 개의 프로필/사람을 하나의 프로필로 병합했습니다
* **프로필 병합 해제됨**: 사용자가 프로필의 병합을 해제했습니다
* **프로필 업데이트됨**: 사용자가 프로필을 업데이트했습니다
* **프로필 검색됨**: 사용자가 프로필/사람을 검색했습니다
* **세부 정보 포함 프로필 검색됨**: 사용자가 속성이 포함된 프로필/사람을 검색했습니다
* **프로필 세부 정보 조회됨**: 사용자가 프로필/사람의 세부 정보를 조회했습니다
* **이미지 업로드로 프로필 검색됨**: 사용자가 Command에서 검색을 수행하기 위해 이미지를 업로드했습니다
* **프로필 제안 조회됨**: 사용자가 제안된 프로필/사람을 조회했습니다
* **프로필 제안 업데이트됨**: 제안된 프로필/사람이 업데이트되었습니다
* **차량 검색됨**: 사용자가 차량을 검색했습니다
* **기록 조회됨:** 사용자가 과거 영상을 조회했습니다
* **실시간 스트림 시작됨**: 사용자가 실시간 비디오 스트림을 시작했습니다
* **임베드 링크 생성됨**: 사용자가 비디오 임베드 링크를 생성했습니다
* **라이브 링크 생성됨**: 사용자가 공유 가능한 링크를 생성했습니다
* **타임랩스 작업 수행됨**: 사용자가 비디오 타임랩스를 생성, 수정, 삭제 또는 다운로드했습니다
* **카메라 보존 설정 업데이트됨**: 카메라의 보존 기간이 변경되었습니다
* **카메라 사이트 변경됨**: 카메라 사이트가 수정되었습니다
* **Helix 이벤트 수정됨**: API를 통해 Helix 이벤트 변경이 이루어졌습니다
* **비디오 공유 계약 업데이트됨**: 비디오 공유 정책 계약이 변경되었습니다.
* **공유 리소스 생성됨**: 아카이브가 공유되었습니다

</details>

<details>

<summary>출입 이벤트</summary>

* **출입 알림 수정됨:** 출입 알림 관련 변경이 이루어졌습니다
* **보조 입력 수정됨**: AUX 입력 관련 변경이 이루어졌습니다
* **도어 생성됨**: 새 출입 도어가 생성되었습니다
* **도어 삭제됨**: 출입 도어가 삭제되었습니다
* **도어 수정됨**: 출입 도어에 변경이 이루어졌습니다
* **도어 이동됨**: 도어 설정이 다른 도어 포트로 이동되었습니다
* **엘리베이터 수정됨**: 엘리베이터 관련 변경이 이루어졌습니다
* **출입 그룹 사용자 추가됨**: 사용자가 출입 그룹에 추가되었습니다
* **출입 그룹 생성됨**: 출입용 새 그룹이 생성되었습니다
* **출입 그룹 사용자 제거됨**: 사용자가 출입 그룹에서 제거되었습니다
* **출입 수준 수정됨**: 출입 수준 관련 변경이 이루어졌습니다
* **출입 잠금 수정됨**: 잠금이 수정되었습니다
* **출입 집결 보고서 수정됨**: 점호 보고서가 실행되었습니다
* **출입 집결 템플릿 수정됨**: 점호 템플릿 관련 변경이 이루어졌습니다
* **출입 장치 인근 카메라 수정됨**: 도어의 카메라가 변경되었습니다
* **출입 조직 배지 템플릿 수정됨**: 배지 템플릿 관련 변경이 이루어졌습니다
* **출입 일정 생성됨**: 사용자가 출입 일정을 생성했습니다
* **출입 일정 삭제됨**: 사용자가 출입 일정을 삭제했습니다
* **출입 일정 수정됨**: 사용자가 출입 일정을 수정했습니다
* **출입 사이트 구성 수정됨**: 출입 사이트 관련 변경이 이루어졌습니다
* **출입 장치 이동됨**: 출입 컨트롤러가 다른 사이트로 이동되었습니다
* **출입 방법 추가됨**: 새 도어 잠금 해제 방식(배지, Bluetooth 등)이 사용자에게 추가되었습니다
* **출입 방법 제거됨**: 도어 잠금 해제 방식이 사용자에게서 제거되었습니다
* **출입 방법 수정됨**: 사용자의 도어 잠금 해제 방식이 수정되었습니다
* **출입 역할 부여됨**: 사용자가 액세스 역할을 부여함
* **액세스 역할 철회됨**: 사용자가 액세스 역할을 철회함
* **액세스 사용자 내보내기 완료**: 사용자가 액세스 사용자 목록을 내보냄
* **액세스 조직 설정 수정됨**: 액세스 조직 설정이 변경됨

</details>

<details>

<summary>알람 이벤트</summary>

* **알람 설정 수정됨:** 알람 관련 변경이 이루어짐

</details>

<details>

<summary>센서 이벤트</summary>

* S**ensor 알림 구성 수정됨**: 센서 알림에 변경이 이루어짐
* **센서 보정**: 센서 보정 관련 이벤트가 조직에서 발생함(센서 판독값 보정 및/또는 인증서 생성)
* **센서 구성 수정됨**: 공기질 센서에 변경이 이루어짐
* **센서 대시보드 수정됨**: 공기질 대시보드에 변경이 이루어짐
* **센서 장치 세부정보 수정됨**: 공기질 센서의 이름, 위치 등이 변경됨
* **센서 사이트 변경됨**: 공기질 센서가 다른 사이트로 이동됨

</details>

***

### 감사 로그 API 조회

명령 감사 로그는 REST API 호출을 통해서도 검색할 수 있습니다.

해당 [감사 로그 조회](https://apidocs.verkada.com/reference/getauditlogsviewv1) API 호출은 지정된 시간 범위 내의 조직에 대한 감사 로그를 반환합니다. 모든 감사 로그에는 UTC 형식의 타임스탬프, 사용자 정보, IP 주소, 이벤트 정보 및 장치 정보가 포함됩니다. 참고 [apidocs.verkada.com](https://apidocs.verkada.com/reference/introduction) 를 참조하세요.

***

{% hint style="info" %}
**실제로 보고 싶으신가요?** 다음을 확인해 보세요: [동영상 튜토리얼](https://www.youtube.com/watch?v=J71I4rpf8Dg).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.verkada.com/command/ko/organization-settings/manage-your-admin-page-settings/manage-and-view-audit-logs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
