Intégration avec un serveur de contrôle d’accès tiers

Cette fonctionnalité permet aux appareils Akuvox de transférer des identifiants d'accès (tels que des codes QR, des cartes ou des codes PIN) à un serveur tiers pour vérification, au lieu d'effectuer une authentification locale.

Cas d'usage typiques :

• Contrôle d'accès centralisé géré par une plateforme tierce.

• Logique de sécurité personnalisée implémentée sur des serveurs externes.

Comment cela fonctionne :

Modèles pris en charge

Cette fonctionnalité est prise en charge sur les modèles suivants :

Note

* Sur A08, le mode d'autorisation et le mode de demande d'authentification multifactorielle (voir ci-dessous) nécessitent le firmware 108.30.11.228 ou ultérieur. Toutes les autres fonctionnalités décrites dans cet article sont disponibles à partir du 108.30.11.122.

Avant de commencer

Assurez-vous d'avoir :

• L'API HTTP fournie par le serveur tiers.

• ID de périphérique attribué par le système tiers.

• Méthode d'authentification prévue (code QR, carte, code PIN ou multi-facteurs).

Aperçu de la configuration

Deux modes d'intégration sont pris en charge :

Intégration générale  

• Utilisé uniquement pour l'authentification par code QR.

• L'appareil envoie une requête HTTP prédéfinie contenant des données de code QR.

Intégration personnalisée  

• Utilisé pour plusieurs méthodes d'authentification.

• Prend en charge le code QR, la carte, le code PIN et l'authentification multi-facteurs.

• Permet une mise en forme flexible des données pour le traitement côté serveur.

Étapes de configuration

Prenons A08 comme exemple.

1. Utilisez l'adresse IP de l'appareil pour vous connecter à son interface web. Le nom d'utilisateur initial et le mot de passe sont admin.

2. Allez dans le contrôle d'accès > Relay > intégration tierce.

3. Sélectionnez le type d'intégration.

• Général : Transmettez l'URL HTTP liée par code QR dans la méthode d'Akuvox.

• Personnalisez : Transmettez les données d'accès aux identifiants de manière personnalisée.

Option A : Intégration générale (code QR uniquement)

Quand utiliser :

• Seule l'authentification par code QR est requise.

• Le serveur vérifie les codes QR via des requêtes HTTP.

1. Voici la commande HTTP fournie par le fournisseur de services tiers.

   Exemple de format :

   http://192.168.31.123:8090/api/visitor/scan?codeKey={QRCode}&deviceId={DeviceID}

2. Saisissez l'identifiant de l'appareil fourni par le serveur tiers.

3. Sélectionnez le mode d'autorisation. Configurez le nom d'utilisateur et le mot de passe utilisés pour l'authentification lorsque le mode Basic ou Digest est sélectionné.

4. Soumettez le cadre.

Format de réponse serveur

Après avoir reçu la demande, le serveur tiers doit renvoyer une réponse JSON valide indiquant si l'accès est accordé.

Le dispositif détermine le résultat en fonction de champs spécifiques dans la réponse.

Paramètre de réussite supporté :

• « est valide » : vrai

• « est valide » : 1

• « validation_result » : « 1 »

Paramètre défaillant pris en charge :

• « est invalide » : faux

• « est valide » : 0

• « validation_result » : « 0 »

Délai d'attente de réponse

L'appareil attend une réponse du serveur tiers dans un délai limité.

• Temps mort : 3 secondes

Si aucune réponse valide n'est reçue dans ce délai :

• La demande sera considérée comme échouée.

• L'accès sera automatiquement refusé.

Résultat

• Lorsqu'un code QR est scanné :

  • {QRCode} est remplacé par le contenu QR réel.

  • {DeviceID} identifie l'appareil.

• Le serveur vérifie la demande.

• L'appareil ouvre la porte si la vérification réussit.

Option B : Intégration personnalisée

Quand utiliser :

• Plusieurs méthodes d'authentification sont nécessaires.

• Une logique de vérification personnalisée est implémentée sur le serveur.

Références prises en charge :

• Code QR

• Carte RF

• PIN

• Authentification multi-facteurs

Avant de configurer l'intégration, spécifiez quel mode d' authentification est utilisé par l'appareil.

Sélectionnez le mode d'authentification sur l'interface de contrôle d'accès > relais > mode d'authentification d'accès .

Scénario 1 : N'importe quel mode méthode

Dans ce mode, toute accréditation sélectionnée peut déclencher une vérification.

1. Sélectionnez la(s) méthode(s) d'accès à vérifier par le serveur tiers.

2. Sélectionnez le mode d'autorisation. Configurez le nom d'utilisateur et le mot de passe utilisés pour l'authentification lorsque le mode Basic ou Digest est sélectionné.

3. Voici la commande HTTP fournie par le fournisseur de services tiers.

   Exemple de format :

   http://192.168.31.123:8090/api/visitor/scan?codeKey={QRCode}/{Card}/{Pin}&deviceId={DeviceID}.

4. Saisissez l'identifiant de l'appareil fourni par le serveur tiers.

5. Soumettez le cadre.

Conseil

Certains modèles spécifiques (X916, S535, R29, A05V2, E18 et E16V2) prennent en charge la fonction Prompt on LCD .

• Sélectionnez par défaut pour adopter l'invite d'ouverture de porte du téléphone Akuvox.

• Sélectionnez Retour de valeur pour utiliser la valeur de retour du serveur tiers comme invite.

Format de réponse serveur

Après avoir reçu la demande, le serveur tiers doit retourner une réponse valide indiquant si l'accès est accordé.

Le dispositif détermine le résultat en fonction de champs spécifiques dans la réponse.

Paramètre de réussite supporté :

• « est valide » : vrai

• « est valide » : 1

• « validation_result » : « 1 »

Paramètre défaillant pris en charge :

• « est invalide » : faux

• « est valide » : 0

• « validation_result » : « 0 »

Délai d'attente de réponse

L'appareil attend une réponse du serveur tiers dans un délai limité.

• Temps mort : 3 secondes

Si aucune réponse valide n'est reçue dans ce délai :

• La demande sera considérée comme échouée.

• L'accès sera automatiquement refusé.

Résultat

• L'appareil envoie l'identifiant utilisé (QR, carte ou code PIN).

• La variable correspondante est remplacée dans l'URL.

• Le serveur vérifie l'identifiant et renvoie le résultat.

Scénario 2 : Mode d'authentification à deux facteurs

Ce mode nécessite deux identifiants en séquence. Les combinaisons prises en charge sont Carte RF + PIN et PIN + Carte RF.

Note

Sur les appareils A08 fonctionnant sous le firmware 108.30.11.228 ou ultérieur, le flux de travail dépend du mode de demande d'authentification multifactorielle . Sur tous les autres modèles — et sur le firmware A08 antérieur à 108.30.11.228 — seul le flux de travail Demandes séparées s'applique.

Flux de travail :

Dans les deux cas, si l'identifiant saisi à l'une ou l'autre étape ne correspond pas au mode d'authentification à deux facteurs configuré, l'utilisateur est invité à utiliser la méthode correcte avant l'envoi de la requête.

1. Sélectionnez le mode de vérification à distance multi-facteurs .

2. Sélectionnez le mode de demande d'authentification multifactorielle.

3. Sélectionnez le mode d'autorisation. Configurez le nom d'utilisateur et le mot de passe utilisés pour l'authentification lorsque le mode Basic ou Digest est sélectionné.

4. Voici la commande HTTP fournie par le fournisseur de services tiers.

   Exemple de format :

   Pour le mode Demandes séparées :

   http://192.168.31.123:8090/api/visitor/scan?codeKey={Token}/{Type}&deviceId={DeviceID}

   Pour le mode Demande Combinée Unique :

   http://192.168.31.123:8090/api/visitor/scan?codeKey={Card}/{Pin}/{Type}&deviceId={DeviceID}

5. Saisissez l'identifiant de l'appareil fourni par le serveur tiers.

6. Soumettez le cadre.

Conseil

Certains modèles spécifiques (X916, S535, R29, A05V2, E18, X912 et E16V2) prennent en charge la fonction Prompt sur LCD .

• Sélectionnez par défaut pour adopter l'invite d'ouverture de porte du téléphone Akuvox.

• Sélectionnez Retour de valeur pour utiliser la valeur de retour du serveur tiers comme invite.

Format de réponse serveur

Après avoir reçu la demande, le serveur tiers doit renvoyer une réponse JSON valide indiquant si l'accès est accordé.

Le dispositif détermine le résultat en fonction de champs spécifiques dans la réponse.

Paramètre de réussite supporté :

• « est valide » : vrai

• « est valide » : 1

• « validation_result » : « 1 »

Paramètre défaillant pris en charge :

• « est invalide » : faux

• « est valide » : 0

• « validation_result » : « 0 »

Délai d'attente de réponse

L'appareil attend une réponse du serveur tiers dans un délai limité.

• Temps mort : 3 secondes

Si aucune réponse valide n'est reçue dans ce délai :

• La demande sera considérée comme échouée

• L'accès sera automatiquement refusé

Résultat

• {Token} représente la qualification recueillie à chaque étape.

• {Type} indique la séquence d'authentification :

  • 1 = Carte RF + PIN

  • 2 = PIN + Carte RF

  • 3 = Face + Carte RF

  • 4 = Face + PIN

• Le serveur vérifie les deux identifiants avant d'accorder l'accès.

Variable Description

Différences de capacités de modèle

Capacités d'authentification

Différents modèles prennent en charge différentes méthodes d'authentification pour l'intégration avec des serveurs tiers.

Variables prises en compte par modèle

Différents modèles prennent en charge différentes variables lors de l'envoi de données vers le serveur.

Note

• Les formats variables ne sont PAS interchangeables entre les modèles.

• Seules les variables prises en charge par le modèle de périphérique peuvent être utilisées dans la commande HTTP.

• L'utilisation de variables non prises en charge peut entraîner des requêtes échouées.