# HiveWatch

Das HiveWatch Global Security Operations Center (GSOC) Operating System (OS) ist eine umfassende Plattform für das Management von Sicherheitsoperationen, die darauf ausgelegt ist, verschiedene Sicherheitssysteme zu zentralisieren und zu optimieren und so die betriebliche Effizienz zu steigern. Diese Plattform befähigt physische Sicherheitsteams, fundierte, datengestützte Entscheidungen zu treffen.

Durch die Integration mit Verkada können Command-Benutzer ihr HiveWatch GSOC OS nahtlos mit Verkada-Sicherheitskameras und Zutrittskontrollgeräten verbinden und so eine einheitliche Benutzeroberfläche für Sicherheitsoperatoren bereitstellen. Diese Integration ermöglicht es Benutzern, Zutrittskontrollereignisse in Echtzeit über synchronisierte Verkada-Kamerafeeds innerhalb des HiveWatch GSOC OS zu überprüfen.

### Was Sie benötigen

* [Verkada-Organisations-ID](#h_da42c17b67)
* [Verkada-API-Schlüssel](#h_611b1b0a99):
  * Nur lesen
  * Streaming – Live/Verlauf
* [Kameras](#h_ab28f0de7b)
  * Kameranamen
  * Kamera-IDs
* [Zutrittskontrolle](#h_9aab16a63e)
  * IDs der Zutrittscontroller
  * Türnamen
  * Tür-IDs
* [Verkada Webhook-Geheimnis](#h_d5448bc001)

***

## Organisationskonfiguration

### Ihre Organisations-ID finden

{% stepper %}
{% step %}
**Gehen Sie in Verkada Command zu Alle Produkte > Admin .**
{% endstep %}

{% step %}
**Wählen Sie in der linken Navigation Org-Einstellungen > Verkada API aus.**
{% endstep %}

{% step %}
**Kopieren Sie die Organisations-ID und speichern Sie sie an einem sicheren Ort.**
{% endstep %}
{% endstepper %}

### Einen API-Schlüssel erstellen

{% stepper %}
{% step %}
**Gehen Sie in Verkada Command zu Alle Produkte > Admin .**
{% endstep %}

{% step %}
**Wählen Sie in der linken Navigation Org-Einstellungen > Verkada API aus.**
{% endstep %}

{% step %}
**Schlüssel nur lesen:**

a. Klicken Sie auf **API-Schlüssel hinzufügen.**\
b. Geben Sie einen eindeutigen Namen ein.\
c. Legen Sie **Berechtigung auswählen** auf **Nur lesen.**\
d. Legen Sie die **Ablauf.Note:** Wir empfehlen, das Ablaufdatum des API-Schlüssels auf ein Jahr ab dem aktuellen Datum festzulegen. Es wird empfohlen, API-Schlüssel mindestens einmal pro Jahr zu rotieren.\
e. Klicken Sie auf **API-Schlüssel generieren > Kopieren.** Der API-Schlüssel wird nur einmal angezeigt. Kopieren Sie den Schlüssel und speichern Sie ihn an einem sicheren Ort.
{% endstep %}

{% step %}
**Streaming – Live/Verlaufsschlüssel:**

a. Klicken Sie auf **API-Schlüssel hinzufügen.**\
b. Geben Sie einen eindeutigen Namen ein.\
c. Legen Sie **Berechtigung auswählen** auf **Streaming – Live/Verlauf.**\
d. Legen Sie die **Ablauf.Note:** Wir empfehlen, das Ablaufdatum des API-Schlüssels auf ein Jahr ab dem aktuellen Datum festzulegen. Es wird empfohlen, API-Schlüssel mindestens einmal pro Jahr zu rotieren.\
e. Wählen Sie die Standorte/Geräte aus, auf die der Schlüssel angewendet wird.\
f. Klicken Sie auf **API-Schlüssel generieren > Kopieren.** Der API-Schlüssel wird nur einmal angezeigt. Kopieren Sie den Schlüssel und speichern Sie ihn an einem sicheren Ort.
{% endstep %}
{% endstepper %}

***

## Geräteinformationen erfassen

### Kameras

Sie müssen den Kameranamen und die Kamera-ID für jede Kamera abrufen, die Teil der HiveWatch-Organisation sein wird.

{% stepper %}
{% step %}
**Gehen Sie in Verkada Command zu Alle Produkte > Kameras.**

**Hinweis:** Das HiveWatch-Team kann bei der Erfassung dieser Informationen für groß angelegte Bereitstellungen unterstützen. Wenden Sie sich für Hilfe an Ihren HiveWatch-Ansprechpartner.
{% endstep %}

{% step %}
**Wählen Sie einen Kamerastandort aus und klicken Sie unter dem Videoplayer auf Einstellungen.**
{% endstep %}

{% step %}
**Unter Allgemein kopieren Sie den Kameranamen und speichern Sie ihn an einem sicheren Ort.**
{% endstep %}

{% step %}
**Die Kamera-ID finden Sie in der Browser-URL. Kopieren Sie die Kamera-ID und speichern Sie sie zusammen mit dem Kameranamen.**

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

### Zutrittskontrolle

Sie müssen die ID des Zutrittscontrollers, den Türnamen und die Tür-ID aus Command für jede Tür abrufen, die Teil der HiveWatch-Integration sein wird.

{% stepper %}
{% step %}
**Gehen Sie in Verkada Command zu Alle Produkte > Zutritt.**
{% endstep %}

{% step %}
**Controller-Informationen erfassen:**

a. Wählen Sie oben **Controller.**\
b. Wählen Sie einen Controller aus und klicken Sie rechts auf das Controller-Bild.\
c. Die Controller-ID finden Sie in der Browser-URL. Kopieren Sie die Controller-ID und speichern Sie sie an einem sicheren Ort.

<div align="left" data-with-frame="true"><img src="/files/639bbb8a0cefec0805996a35e185d75be9568c8b" alt="" width="736"></div>
{% endstep %}

{% step %}
**Türinformationen erfassen:**

a. Bewegen Sie den Mauszeiger über eine Tür und klicken Sie auf .\
b. Unter **Allgemein** kopieren Sie den Türnamen und speichern Sie ihn zusammen mit der Controller-ID.\
c. Die Tür-ID finden Sie in der Browser-URL. Kopieren Sie die Tür-ID und speichern Sie sie zusammen mit dem Türnamen.
{% endstep %}

{% step %}
**Klicken Sie auf einen Controller, der für die HiveWatch-Integration verwendet wird, und kopieren Sie die Controller-ID aus der Browser-URL.**

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

{% hint style="danger" %}
Wenden Sie sich an Ihren HiveWatch-Ansprechpartner und stellen Sie ihm die entsprechenden Verkada-Geräteinformationen und API-Schlüssel zur Verfügung, um die Integrationskonfiguration abzuschließen.
{% endhint %}

***

## Einen Verkada Webhook erstellen

{% hint style="warning" %}
Das HiveWatch-Implementierungsteam stellt eine eindeutige Integrations-URL und ein Shared Secret für den Webhook bereit.
{% endhint %}

{% stepper %}
{% step %}
**Gehen Sie in Verkada Command zu Alle Produkte > Admin .**
{% endstep %}

{% step %}
**Wählen Sie in der linken Navigation Org-Einstellungen > Verkada API aus.**
{% endstep %}

{% step %}
**Klicken Sie auf Webhook hinzufügen.**

a. Geben Sie die bereitgestellte **Webhook-URL ein.**\
b. Geben Sie das bereitgestellte **Shared Secret ein.**\
c. Klicken Sie auf **Webhook hinzufügen.**
{% endstep %}
{% endstepper %}

Benutzer verfügen nun über alle erforderlichen Verkada-Informationen, um Verkada-Geräte in HiveWatches GSOC zu integrieren.

Das folgende Bild zeigt eine abgeschlossene Integration zwischen Verkada und HiveWatch. Es zeigt ein in HiveWatch GSOC ausgelöstes Verkada-Ereignis „Tür offen gehalten“, begleitet vom entsprechenden Verkada-Kamerafeed. Dieses Setup ermöglicht eine effiziente Überprüfung und Reaktion auf Ereignisse.

<div align="left" data-with-frame="true"><img src="/files/651d4049348eeb90d2cd616237f509cccba99c5b" alt=""></div>


---

# 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/de/organisationseinstellungen/integrations/set-up-the-verkada-hivewatch-integration.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.
