# HiveWatch
Le système d’exploitation (OS) du Centre d’Opérations de Sécurité Global (GSOC) HiveWatch est une plateforme complète de gestion des opérations de sécurité conçue pour centraliser et rationaliser divers systèmes de sécurité, améliorant ainsi l’efficacité opérationnelle. Cette plateforme permet aux équipes de sécurité physique de prendre des décisions éclairées basées sur les données.
En s’intégrant à Verkada, les utilisateurs de Command peuvent connecter de manière transparente leur OS HiveWatch GSOC aux caméras de sécurité et aux dispositifs de contrôle d’accès Verkada, offrant une interface unifiée aux opérateurs de sécurité. Cette intégration permet aux utilisateurs de consulter les événements de contrôle d’accès en temps réel via des flux de caméras Verkada synchronisés au sein de l’OS HiveWatch GSOC.
### Ce dont vous avez besoin
* [ID d’organisation Verkada](#h_da42c17b67)
* [Clés API Verkada](#h_611b1b0a99):
* Lecture seule
* Streaming - En direct/Historique
* [Caméras](#h_ab28f0de7b)
* Noms des caméras
* ID des caméras
* [Contrôle d’accès](#h_9aab16a63e)
* ID des contrôleurs d’accès
* Noms des portes
* ID des portes
* [Secret Webhook Verkada](#h_d5448bc001)
***
## Configuration de l’organisation
### Localisez votre ID d’organisation
{% stepper %}
{% step %}
**Dans Verkada Command, allez dans All Products > Admin.**
{% endstep %}
{% step %}
**Dans la navigation de gauche, sélectionnez Org Settings > Verkada API.**
{% endstep %}
{% step %}
**Copiez l’ID d’organisation et rangez-le dans un endroit sûr.**
{% endstep %}
{% endstepper %}
### Créer une clé API
{% stepper %}
{% step %}
**Dans Verkada Command, allez dans All Products > Admin.**
{% endstep %}
{% step %}
**Dans la navigation de gauche, sélectionnez Org Settings > Verkada API.**
{% endstep %}
{% step %}
**Clé Lecture seule :**
a. Cliquez **Ajouter une clé API.**\
b. Entrez un nom unique.\
c. Définir **Sélectionner la permission** sur **Lecture seule.**\
d. Définir la **Expiration.Remarque :** Nous recommandons de définir la date d’expiration de la clé API à un an à partir de la date actuelle. Il est recommandé de faire pivoter les clés API au moins une fois par an.\
e. Cliquez **Générer la clé API > Copier.** La clé API n’est affichée qu’une seule fois. Copiez la clé et rangez-la dans un endroit sûr.
{% endstep %}
{% step %}
**Clé Streaming - En direct/Historique :**
a. Cliquez **Ajouter une clé API.**\
b. Entrez un nom unique.\
c. Définir **Sélectionner la permission** sur **Streaming - En direct/Historique.**\
d. Définir la **Expiration.Remarque :** Nous recommandons de définir la date d’expiration de la clé API à un an à partir de la date actuelle. Il est recommandé de faire pivoter les clés API au moins une fois par an.\
e. Sélectionnez les sites/appareils auxquels la clé s’appliquera.\
f. Cliquez **Générer la clé API > Copier.** La clé API n’est affichée qu’une seule fois. Copiez la clé et rangez-la dans un endroit sûr.
{% endstep %}
{% endstepper %}
***
## Rassembler les infos des appareils
### Caméras
Vous devez récupérer le nom de la caméra et l’ID de la caméra pour chaque caméra qui fera partie de l’organisation HiveWatch.
{% stepper %}
{% step %}
**Dans Verkada Command, allez dans All Products > Cameras.**
**Remarque :** L’équipe HiveWatch peut aider à collecter ces informations pour des déploiements à grande échelle. Contactez votre représentant HiveWatch pour obtenir de l’aide.
{% endstep %}
{% step %}
**Sélectionnez un site de caméra et, sous le lecteur vidéo, cliquez sur Settings.**
{% endstep %}
{% step %}
**Sous General, copiez le nom de la caméra et conservez-le dans un emplacement sécurisé.**
{% endstep %}
{% step %}
**L’ID de la caméra se trouve dans l’URL du navigateur. Copiez l’ID de la caméra et conservez-le avec le nom de la caméra.**
{% endstep %}
{% endstepper %}
### Contrôle d’accès
Vous devez récupérer l’ID du contrôleur d’accès, le nom de la porte et l’ID de la porte depuis Command pour chaque porte qui fera partie de l’intégration HiveWatch.
{% stepper %}
{% step %}
**Dans Verkada Command, allez dans All Products > Access.**
{% endstep %}
{% step %}
**Rassembler les infos du contrôleur :**
a. En haut, sélectionnez **Contrôleurs.**\
b. Sélectionnez un contrôleur et cliquez sur l’image du contrôleur à droite.\
c. L’ID du contrôleur se trouve dans l’URL du navigateur. Copiez l’ID du contrôleur et conservez-le dans un emplacement sécurisé.
{% endstep %}
{% step %}
**Rassembler les infos de la porte :**
a. Survolez une porte et cliquez .\
b. Sous **General,** copiez le nom de la porte et conservez-le avec l’ID du contrôleur.\
c. L’ID de la porte se trouve dans l’URL du navigateur. Copiez l’ID de la porte et conservez-le avec le nom de la porte.
{% endstep %}
{% step %}
**Cliquez sur un contrôleur qui sera utilisé pour l’intégration HiveWatch et copiez l’ID du contrôleur depuis l’URL du navigateur.**
{% endstep %}
{% endstepper %}
{% hint style="danger" %}
Contactez votre représentant HiveWatch et fournissez-lui les informations correspondantes des appareils Verkada et les clés API pour compléter la configuration de l’intégration.
{% endhint %}
***
## Créer un Webhook Verkada
{% hint style="warning" %}
L’équipe d’implémentation HiveWatch fournira une URL d’intégration unique et un secret partagé pour le Webhook.
{% endhint %}
{% stepper %}
{% step %}
**Dans Verkada Command, allez dans All Products > Admin.**
{% endstep %}
{% step %}
**Dans la navigation de gauche, sélectionnez Org Settings > Verkada API.**
{% endstep %}
{% step %}
**Cliquez sur Add Webhook.**
a. Saisissez le **Webhook URL fourni.**\
b. Saisissez le **Secret partagé fourni.**\
c. Cliquez **Ajouter le Webhook.**
{% endstep %}
{% endstepper %}
Les utilisateurs disposent maintenant de toutes les informations Verkada requises pour intégrer les appareils Verkada dans le GSOC de HiveWatch.
L’image ci-dessous montre une intégration complète entre Verkada et HiveWatch. Elle affiche un événement Verkada Door Held Open signalé dans le GSOC HiveWatch, accompagné du flux de caméra Verkada correspondant. Cette configuration permet une révision et une réponse efficaces aux événements.
