> For the complete documentation index, see [llms.txt](https://help.verkada.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.verkada.com/command/ko/organization-settings/manage-your-admin-page-settings/manage-and-view-audit-logs.md).

# 감사 로그

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 %}
**왼쪽 탐색에서 보안 및 로그를 선택합니다.**
{% endstep %}

{% step %}
**감사 로그를 클릭합니다.**
{% endstep %}

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

{% hint style="danger" %}
감사 로그에서 AI Search를 사용하려면 조직에서 AI 기반 검색이 활성화되어 있어야 합니다. Org Admin은 다음으로 이동하여 AI 기반 검색을 활성화할 수 있습니다 **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. 클릭 **보고서로 저장** 를 클릭하여 선택한 필터를 기반으로 사용자 지정 보고서를 만듭니다.
3. 선택 **보고서 예약** 를 클릭하여 감사 로그를 지정된 수신자에게 매일, 매주 또는 매월 자동으로 이메일로 전송합니다.
   {% endstep %}

{% step %}
**내보내기를 클릭하여 감사 이벤트를 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 %}
**카메라 피드 오른쪽에서 설정을 클릭합니다.**
{% endstep %}

{% step %}
**일반에서 감사 로그를 선택합니다.**
{% endstep %}

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

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

***

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

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

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

{% step %}
**왼쪽 탐색에서 카메라 설정을 클릭합니다.**
{% endstep %}

{% step %}
**카메라 감사 로그 내보내기 아래에서 드롭다운을 클릭하고 기간을 설정합니다.**
{% endstep %}

{% step %}
**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 %}
**왼쪽 탐색에서 카메라 설정을 클릭합니다.**
{% endstep %}

{% step %}
**카메라 목록 내보내기 아래에서 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) 변경을 수행했습니다
* **사용자 환경설정 설정됨**: 사용자가 환경설정을 설정하거나 변경했습니다
* **이중 인증 재설정**: 이중 인증이 재설정되었습니다
* **SAML 구성 생성됨**: 새 Security Assertion Markup Language(SAML) 구성이 생성되었습니다
* **SAML 구성 삭제됨**: SAML 구성이 삭제되었습니다
* **SAML IDP 시작됨:** SAML IDP(Identity Provider)가 시작되었습니다
* **SAML 구성 업데이트됨**: SAML 구성이 업데이트되었습니다
* **SCIM 제공자 생성됨**: 새로운 System for Cross-domain Identity Management(SCIM) 제공자가 생성되었습니다
* **SCIM 제공자 삭제됨**: SCIM 제공자가 삭제되었습니다
* **SCIM 제공자 수정됨**: SCIM 제공자가 수정되었습니다
* **SCIM 토큰 재생성됨**: SCIM 토큰이 재생성되었습니다
* **사용자 그룹 작업 수행됨**: 사용자 그룹이 생성, 수정 또는 삭제되었습니다
* **조직에서 사용자들 제거됨**: 사용자 또는 사용자 집합이 조직에서 제거되었습니다
* **강제 로그아웃 요청됨**: 관리자가 사용자를 강제로 로그아웃시켰습니다

</details>

<details>

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

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

</details>

<details>

<summary>디바이스 관리</summary>

* **디바이스 설치됨**: 사용자가 Command에 새 디바이스를 추가했습니다
* **디바이스 제거됨**: 사용자가 Command에서 디바이스를 제거했습니다
* **디바이스 원격 액세스됨**: 지원팀이 이 디바이스에 액세스했습니다
* **라이선스 청구 이벤트**: 라이선스 키가 조직에 추가되었습니다
* **라이선스 부여 이벤트**: 추가 라이선스가 Verkada에 의해 조직에 추가되었습니다
* **평가판 재정의 이벤트**: Verkada가 이 조직의 평가판에 며칠을 더 추가했습니다
* **Viewing Station Grid 업데이트됨**: Viewing Station에 변경이 이루어졌습니다

</details>

<details>

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

* **아카이브 작업 수행됨**: 사용자가 동영상 아카이브를 생성, 수정 또는 삭제했습니다
* **카메라 구성 수정됨**: 사용자가 카메라 구성을 수정했습니다. 어떤 구성이었는지는 세부 정보를 참조하세요
* **프로필 이미지 다운로드됨**: 사용자가 카메라 영상에서 정지 이미지를 다운로드했습니다
* **프로필 이미지 업로드됨**: 사용자가 프로필에 이미지를 업로드했습니다
* **아이덴티티로 프로필 결과 검색됨**: 프로필이 사람 검색에 사용되었습니다
* **프로필 사진 추가됨:** 사용자가 사람 프로필 사진을 추가했습니다
* **프로필 생성됨**: 사용자가 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.