# HiveWatch

HiveWatch Global Security Operations Center(GSOC) 운영 체제(OS)는 다양한 보안 시스템을 중앙 집중화하고 간소화하여 운영 효율성을 향상시키도록 설계된 종합적인 보안 운영 관리 플랫폼입니다. 이 플랫폼은 물리 보안 팀이 정보에 기반한 데이터 중심 의사결정을 내릴 수 있도록 지원합니다.

Verkada와 통합하면 Command 사용자는 HiveWatch GSOC OS를 Verkada 보안 카메라 및 출입 통제 장치와 원활하게 연결하여 보안 운영자를 위한 통합 인터페이스를 제공할 수 있습니다. 이 통합을 통해 사용자는 HiveWatch GSOC OS 내에서 동기화된 Verkada 카메라 피드를 통해 출입 통제 이벤트를 실시간으로 검토할 수 있습니다.

### 필요한 항목

* [Verkada 조직 ID](#h_da42c17b67)
* [Verkada API 키](#h_611b1b0a99):
  * 읽기 전용
  * 스트리밍 - 라이브/과거
* [카메라](#h_ab28f0de7b)
  * 카메라 이름
  * 카메라 ID
* [출입 통제](#h_9aab16a63e)
  * 출입 통제기 ID
  * 문 이름
  * 문 ID
* [Verkada 웹훅 비밀 키](#h_d5448bc001)

***

## 조직 구성

### 조직 ID 찾기

{% stepper %}
{% step %}
**Verkada Command에서 모든 제품 > 관리자 로 이동합니다.**
{% endstep %}

{% step %}
**왼쪽 탐색에서 조직 설정 > Verkada API를 선택합니다.**
{% endstep %}

{% step %}
**조직 ID를 복사하여 안전한 곳에 보관합니다.**
{% endstep %}
{% endstepper %}

### API 키 만들기

{% stepper %}
{% step %}
**Verkada Command에서 모든 제품 > 관리자 로 이동합니다.**
{% endstep %}

{% step %}
**왼쪽 탐색에서 조직 설정 > Verkada API를 선택합니다.**
{% endstep %}

{% step %}
**읽기 전용 키:**

a. 을(를) 클릭합니다. **API 키를 추가합니다.**\
b. 고유한 이름을 입력합니다.\
c. 설정 **권한 선택** 를 **읽기 전용.**\
d. 다음을 설정합니다 **만료일. 참고:** API 키 만료 날짜를 현재 날짜로부터 1년 후로 설정하는 것을 권장합니다. API 키는 최소 연 1회 교체하는 것이 좋습니다.\
e. 클릭 **API 키 생성 > 복사.** API 키는 한 번만 표시됩니다. 키를 복사하여 안전한 곳에 보관하세요.
{% endstep %}

{% step %}
**스트리밍 - 라이브/과거 키:**

a. 을(를) 클릭합니다. **API 키를 추가합니다.**\
b. 고유한 이름을 입력합니다.\
c. 설정 **권한 선택** 를 **스트리밍 - 라이브/과거.**\
d. 다음을 설정합니다 **만료일. 참고:** API 키 만료 날짜를 현재 날짜로부터 1년 후로 설정하는 것을 권장합니다. API 키는 최소 연 1회 교체하는 것이 좋습니다.\
e. 키가 적용될 사이트/장치를 선택합니다.\
f. 클릭 **API 키 생성 > 복사.** API 키는 한 번만 표시됩니다. 키를 복사하여 안전한 곳에 보관하세요.
{% endstep %}
{% endstepper %}

***

## 장치 정보 수집

### 카메라

HiveWatch 조직에 포함될 각 카메라의 카메라 이름과 카메라 ID를 확인해야 합니다.

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

**참고:** HiveWatch 팀은 대규모 배포를 위한 이 정보 수집을 지원할 수 있습니다. 도움이 필요하면 HiveWatch 담당자에게 문의하세요.
{% endstep %}

{% step %}
**카메라 사이트를 선택하고 비디오 플레이어 아래에서 설정을 클릭합니다.**
{% endstep %}

{% step %}
**일반에서 카메라 이름을 복사하여 안전한 위치에 보관합니다.**
{% endstep %}

{% step %}
**카메라 ID는 브라우저 URL에서 찾을 수 있습니다. 카메라 ID를 복사하여 카메라 이름과 함께 보관합니다.**

<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-f9c0078c33a699bf653d46ebdeddb7447beecd29%2F8d3821480d66a19a1730f620f445d88efae255ea.png?alt=media" alt="" width="607"></div>
{% endstep %}
{% endstepper %}

### 출입 통제

HiveWatch 통합에 포함될 각 문에 대해 Command에서 출입 통제기 ID, 문 이름, 문 ID를 확인해야 합니다.

{% stepper %}
{% step %}
**Verkada Command에서 전체 제품 > 출입으로 이동합니다.**
{% endstep %}

{% step %}
**컨트롤러 정보 수집:**

a. 상단에서 **컨트롤러를 선택합니다.**\
b. 컨트롤러를 선택하고 오른쪽의 컨트롤러 이미지를 클릭합니다.\
c. 컨트롤러 ID는 브라우저 URL에서 찾을 수 있습니다. 컨트롤러 ID를 복사하여 안전한 곳에 보관합니다.

<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-0cc10dc7a74ea3086c91d0a67f8feae4d04699b6%2F440fa6b0688a90a0abde63d262ff357bd014f22c.png?alt=media" alt="" width="736"></div>
{% endstep %}

{% step %}
**문 정보 수집:**

a. 문 위에 마우스를 올리고 을 클릭합니다.\
b. **일반에서** 문 이름을 복사하여 컨트롤러 ID와 함께 보관합니다.\
c. 문 ID는 브라우저 URL에서 찾을 수 있습니다. 문 ID를 복사하여 문 이름과 함께 보관합니다.
{% endstep %}

{% step %}
**HiveWatch 통합에 사용할 컨트롤러를 클릭하여 들어간 뒤 브라우저 URL에서 해당 컨트롤러의 ID를 복사합니다.**

<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-f285de2e08a325ac294d49bb653a531efa1f4b50%2F6ad1a09593b33fe9011ce86a862f29d60d272286.png?alt=media" alt="" width="648"></div>
{% endstep %}
{% endstepper %}

{% hint style="danger" %}
HiveWatch 담당자에게 연락하여 해당 Verkada 장치 정보와 API 키를 제공하면 통합 설정이 완료됩니다.
{% endhint %}

***

## Verkada 웹훅 생성

{% hint style="warning" %}
HiveWatch 구현 팀이 웹훅용 고유 통합 URL과 공유 비밀 키를 제공합니다.
{% endhint %}

{% stepper %}
{% step %}
**Verkada Command에서 모든 제품 > 관리자 로 이동합니다.**
{% endstep %}

{% step %}
**왼쪽 탐색에서 조직 설정 > Verkada API를 선택합니다.**
{% endstep %}

{% step %}
**웹훅 추가를 클릭합니다.**

a. 제공된 **웹훅 URL을 입력합니다.**\
b. 제공된 **공유 비밀 키를 입력합니다.**\
c. 클릭 **웹훅 추가.**
{% endstep %}
{% endstepper %}

이제 사용자는 Verkada 장치를 HiveWatch의 GSOC에 통합하는 데 필요한 모든 Verkada 정보를 갖게 되었습니다.

아래 이미지는 Verkada와 HiveWatch 간의 통합 완료 예시를 보여줍니다. HiveWatch GSOC에서 발생한 Verkada Door Held Open 이벤트와 이에 대응하는 Verkada 카메라 피드가 표시됩니다. 이 설정을 통해 이벤트를 효율적으로 검토하고 대응할 수 있습니다.

![](https://1764840814-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-93b2728644d54736b0084d012e12a14410355d90%2F1313460a6dcd4dc1880e7950760a5f86b3c1de30.png?alt=media)
