> 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/integrations/set-up-the-verkada-hivewatch-integration.md).
# HiveWatch
HiveWatch 글로벌 보안 운영 센터(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에서 All Products > Admin으로 이동합니다.**
{% endstep %}
{% step %}
**왼쪽 탐색에서 Org Settings > Verkada API를 선택합니다.**
{% endstep %}
{% step %}
**조직 ID를 복사하여 안전한 곳에 보관하세요.**
{% endstep %}
{% endstepper %}
### API 키 만들기
{% stepper %}
{% step %}
**Verkada Command에서 All Products > Admin으로 이동합니다.**
{% endstep %}
{% step %}
**왼쪽 탐색에서 Org Settings > 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에서 All Products > Cameras로 이동합니다.**
**참고:** HiveWatch 팀은 대규모 배포의 경우 이 정보 수집을 도와드릴 수 있습니다. 도움이 필요하면 HiveWatch 담당자에게 문의하세요.
{% endstep %}
{% step %}
**카메라 사이트를 선택한 다음 비디오 플레이어 아래에서 설정을 클릭합니다.**
{% endstep %}
{% step %}
**일반에서 카메라 이름을 복사하여 안전한 위치에 저장합니다.**
{% endstep %}
{% step %}
**카메라 ID는 브라우저 URL에서 찾을 수 있습니다. 카메라 ID를 복사하여 카메라 이름과 함께 저장합니다.**
{% endstep %}
{% endstepper %}
### 출입 통제
HiveWatch 통합에 포함될 각 문의 출입 통제 컨트롤러 ID, 문 이름, 문 ID를 Command에서 가져와야 합니다.
{% stepper %}
{% step %}
**Verkada Command에서 모든 제품 > 출입으로 이동합니다.**
{% endstep %}
{% step %}
**컨트롤러 정보 수집:**
a. 상단에서 **컨트롤러를 선택합니다.**\
b. 컨트롤러를 선택하고 오른쪽의 컨트롤러 이미지를 클릭합니다.\
c. 컨트롤러 ID는 브라우저 URL에서 찾을 수 있습니다. 컨트롤러 ID를 복사하여 안전한 위치에 저장합니다.
{% endstep %}
{% step %}
**문 정보 수집:**
a. 문 위에 마우스를 올리고 .을 클릭합니다.\
b. **일반,** 에서 문 이름을 복사하여 컨트롤러 ID와 함께 저장합니다.\
c. 문 ID는 브라우저 URL에서 찾을 수 있습니다. 문 ID를 복사하여 문 이름과 함께 저장합니다.
{% endstep %}
{% step %}
**HiveWatch 통합에 사용할 컨트롤러로 들어가 브라우저 URL에서 컨트롤러 ID를 복사합니다.**
{% endstep %}
{% endstepper %}
{% hint style="danger" %}
HiveWatch 담당자에게 연락하여 해당 Verkada 디바이스 정보와 API 키를 제공하면 통합 설정을 완료할 수 있습니다.
{% endhint %}
***
## Verkada 웹훅 생성
{% hint style="warning" %}
HiveWatch 구현 팀이 웹훅용 고유 통합 URL과 공유 비밀키를 제공합니다.
{% endhint %}
{% stepper %}
{% step %}
**Verkada Command에서 All Products > Admin으로 이동합니다.**
{% endstep %}
{% step %}
**왼쪽 탐색에서 Org Settings > Verkada API를 선택합니다.**
{% endstep %}
{% step %}
**웹훅 추가를 클릭합니다.**
a. 제공된 **웹훅 URL을 입력합니다.**\
b. 제공된 **공유 비밀키를 입력합니다.**\
c. 클릭 **웹훅 추가.**
{% endstep %}
{% endstepper %}
이제 사용자는 Verkada 장치를 HiveWatch GSOC에 통합하는 데 필요한 모든 Verkada 정보를 갖추었습니다.
아래 이미지는 Verkada와 HiveWatch 간의 통합이 완료된 모습을 보여줍니다. HiveWatch GSOC 내에서 발생한 Verkada 도어 열린 상태 유지 이벤트와 해당 Verkada 카메라 피드가 함께 표시됩니다. 이 설정을 통해 이벤트를 효율적으로 검토하고 대응할 수 있습니다.
---
# 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/integrations/set-up-the-verkada-hivewatch-integration.md?ask=&goal=
```
`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.