5.4.5 API HTTP

HTTP API est une interface d’application conçue pour le contrôle de certaines fonctionnalités des interphones IP 2N via HTTP. Il permet d'intégrer facilement nos appareils à des systèmes tiers, tels que la domotique, les systèmes de sécurité et de surveillance, les solutions d'Hypervision...etc.

Services

HTTP API offre les services suivants :

• API de système – permet les modifications de configuration de l'interphone, les informations d'état et les mises à jour.
• Gestion de l’accès à l’API – permet de gérer les accès et la façon dont l’authentification des utilisateurs est vérifiée.
• API d’interrupteur – permet le contrôle et la surveillance de l'état des interrupteurs, par ex. ouverture de la porte, etc.
• API E/S – permet le contrôle et la surveillance des entrées / sorties logiques de l'interphone.
• API Audio – permet un contrôle de la lecture audio et la surveillance du microphone.
• API de la Caméra – permet le contrôle et la surveillance des images de la caméra.
• API de l'Ecran – permet le contrôle de l'écran tactile et la surveillance des informations utilisateurs.
• API E-mail – permet l'envoi d'e-mails à des utilisateurs.
• API du téléphone/appel – assure le contrôle et la surveillance des appels entrants / sortants.
• API de enregistrement – permet la lecture et l'enregistrements des événements.
• API d’automatisation – permet de configurer les exigences de communication et d'autorisation sécurisées/non sécurisées.

Définissez le protocole de transport (HTTP ou HTTPS) et la méthode d'authentification (Aucune, Basic ou Digest) pour chaque fonctionnalité. Créez jusqu'à cinq comptes d'utilisateur (avec leur propre nom d'utilisateur et mot de passe) dans la configuration de l'API HTTP pour un contrôle d'accès détaillé des services et des fonctions.

Définissez les méthodes d'authentification pour les demandes à envoyer à l'interphone pour chaque service. Si l'authentification requise n'est pas exécutée, la demande sera rejetée. Les demandes sont authentifiées via un protocole d'authentification standard décrit par RFC-2617. Les trois méthodes d'authentification suivantes sont disponibles :

• Aucune – aucune authentification n'est requise. Dans ce cas, ce service est complètement non sécurisé sur le réseau local.
• Basic – l'authentification de base est requise selon RFC-2617. Dans ce cas, le service est protégé par un mot de passe transmis dans un format ouvert. Nous vous recommandons donc de combiner cette option avec HTTPS dans la mesure du possible.
• Digest – l'authentification Digest est requise selon RFC-2617. C'est l'option par défaut et la plus sécurisée des trois méthodes énumérées ci-dessus.

Référez vous au Manuel HTTP API pour découvrir les fonctionnalités et les détails de configuration.

Compte 1–5

L’interphone 2N IP permet de gérer jusqu'à cinq comptes d'utilisateurs qui sont destinés à l'accès aux services HTTP API. Le compte d'utilisateur comprend le nom et le mot de passe de l'utilisateur ainsi qu'un tableau des droits d'accès de l'utilisateur aux différents services de HTTP API.

• Compte activé – autorise ce compte d’utilisateur.

• Nom d’utilisateur – saisir le nom d’utilisateur pour l’authentification de HTTP API.
• Mot de passe – saisir le mot de passe d’authentification de HTTP API.

À l'aide du tableau des droits d'accès on peut gérer les privilèges du compte d'utilisateur pour les différents services.