# 감사 로그

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

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

{% hint style="warning" %}
2021년 6월 15일 이전의 이벤트에 액세스하려면 다음을 참조하세요. [기존 감사 로그](https://help.verkada.com/command/ko/organization-settings/manage-your-admin-page-settings/manage-and-view-audit-logs/legacy-audit-logs).
{% endhint %}

***

## 감사 로그 기능

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

* 사용자 로그인
* 사용자 관리(사용자 추가, 편집, 삭제)
* 조직, 사이트, 그룹 생성
* 사이트 간 이동된 카메라
* 조회된 영상(라이브, 기록, 아카이브)
* Verkada 지원 작업

이벤트에는 다음과 같은 특정 정보가 포함됩니다:

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

시스템 활동을 검토할 때 찾고 있는 내용을 알아내기 위해 감사 로그 페이지에서 사용할 수 있는 필터는 이벤트 데이터를 다음 범주로 나눕니다:

* **어떤 작업이 수행되었는지**
* **무엇에 영향을 미쳤는지** (사용자, 장치 또는 설정)
* **누가 수행했는지** (사용자, 관리자 또는 시스템)

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

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

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

***

## 조직 감사 로그 보기

다음 권한이 있는 사용자: [조직 관리자](https://app.gitbook.com/s/ylYKicREo6JpuOJH4teK/getting-started/roles-and-permissions-for-cameras) 다음과 같이 감사 로그에 액세스할 수 있습니다:

{% stepper %}
{% step %}
**Verkada Command에서 All Products > Admin으로 이동하세요.**
{% endstep %}

{% step %}
**왼쪽 탐색에서 보안 및 로그를 선택합니다.**
{% endstep %}

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

{% step %}
**기본 카테고리 필터를 사용하여 일반적인 사용 사례와 중요한 보안 이벤트를 빠르게 확인합니다.**

<div align="left" data-with-frame="true"><figure><img src="broken-reference" alt="" width="563"><figcaption></figcaption></figure></div>

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

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

1. 원하는 필터를 적용하여 감사 로그를 관련 데이터로 좁힙니다.
2. 클릭합니다. **보고서로 저장** 을 클릭하여 선택한 필터를 기반으로 사용자 지정 보고서를 만듭니다.
3. 선택 **보고서 예약** 을 클릭하여 지정된 수신자에게 감사 로그를 매일, 매주 또는 매월 자동으로 이메일로 전송합니다.
   {% endstep %}

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

***

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

다음 권한이 있는 사용자: [사이트 관리자](https://app.gitbook.com/s/ylYKicREo6JpuOJH4teK/getting-started/roles-and-permissions-for-cameras) 카메라 사이트에 대한 권한이 있으면 카메라별 감사 로그에 액세스할 수 있습니다.

{% stepper %}
{% step %}
**Verkada Command에서 모든 제품 > 카메라로 이동합니다.**
{% endstep %}

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

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

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

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

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

***

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

다음 권한이 있는 사용자: [조직 관리자](https://app.gitbook.com/s/ylYKicREo6JpuOJH4teK/getting-started/roles-and-permissions-for-cameras) 권한이 있으면 조직의 모든 카메라 감사 로그가 포함된 단일 CSV를 내보낼 수 있습니다.

{% stepper %}
{% step %}
**Verkada Command에서 모든 제품 > 카메라로 이동합니다.**
{% endstep %}

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

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

{% step %}
**CSV 내보내기를 선택합니다.**

<div align="left" data-with-frame="true"><img src="https://1764840814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-d2c5a95cdc7e5fcd362fb9ca72eeccdb3bdca5c3%2F919807ae027ccd261f999f00356a7e785a51568a.png?alt=media" alt="" width="595"></div>
{% endstep %}
{% endstepper %}

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

***

## 카메라 목록 내보내기

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

{% stepper %}
{% step %}
**Verkada Command에서 모든 제품 > 카메라로 이동합니다.**
{% 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) 변경을 수행했습니다
* **사용자 환경설정 설정됨**: 사용자가 환경설정을 설정하거나 변경했습니다
* **2단계 재설정**: 2단계 인증이 재설정되었습니다
* **SAML 구성 생성됨**: 새 보안 어설션 마크업 언어(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에서 조직 이름이 변경되었습니다
* **조직 속성 수정됨**: 조직의 속성 또는 설정이 수정되었습니다
* **사이트 작업 수행됨**: 사이트가 생성, 수정 또는 삭제되었습니다
* **웹훅 전환됨**: 웹훅이 활성화 또는 비활성화되었습니다
* **API 키 수정됨**: API 키가 생성되거나 수정되었습니다

</details>

<details>

<summary>장치 관리</summary>

* **장치 설치됨**: 사용자가 Command에 새 장치를 추가했습니다
* **장치 제거됨**: 사용자가 Command에서 장치를 제거했습니다
* **장치 원격 액세스됨**: 지원팀이 이 장치에 액세스했습니다
* **라이선스 청구 이벤트**: 라이선스 키가 조직에 추가되었습니다
* **라이선스 부여 이벤트**: Verkada에 의해 추가 라이선스가 조직에 추가되었습니다
* **평가판 재정의 이벤트**: Verkada가 이 조직의 평가판에 더 많은 일수를 추가했습니다
* **뷰잉 스테이션 그리드 업데이트됨**: 뷰잉 스테이션에 변경이 이루어졌습니다

</details>

<details>

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

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

</details>

<details>

<summary>액세스 이벤트</summary>

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

</details>

<details>

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

* **알람 설정 수정됨:** 알람 관련 변경이 이루어졌습니다

</details>

<details>

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

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

</details>

### 감사 로그 가져오기 API

Command 감사 로그는 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 %}