--- title: "Integración con un servidor de control de acceso de terceros" slug: "integration-with-third-party-access-control-server" status: "update" updated: 2026-11-02T10:08:29Z published: 2026-11-02T10:08:29Z canonical: "knowledge.akuvox.com/integration-with-third-party-access-control-server" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.akuvox.com/llms.txt > Use this file to discover all available pages before exploring further. # Integración con un servidor de control de acceso de terceros  Esta función permite que los dispositivos Akuvox reenvíen credenciales de acceso (como códigos QR, tarjetas o códigos PIN) a un servidor de terceros para su verificación en lugar de realizar autenticación local. **Casos de uso típicos**: - Control centralizado de acceso gestionado por una plataforma de terceros. - Lógica de seguridad personalizada implementada en servidores externos. **Cómo funciona:** ![](https://cdn.document360.io/f09a6106-e976-455e-b2d0-3d88b5385960/Images/Documentation/Gemini_Generated_Image_20jac420jac420ja.png) ## Modelos soportados Esta función está soportada en los siguientes modelos: | Modelo | Versión del firmware (o superior) | Modelo | Versión del firmware (o superior) | | --- | --- | --- | --- | | A01/A02 | 101.30.10.128 | A05V2 | 205.30.10.157 | | A08* | 108.30.11.122 | E18 | 18.30.11.27 | | E16V2* | 216.30.12.33 | X915V2 | 2915.30.10.815 | | X916 | 916.30.10.353 | R29 | 29.30.10.727 | | S535 | 535.30.11.13 | S539 | 539.30.10.428 | | X912 | 912.30.13.5 | S538 | 538.30.10.705 | | E16V3 | 416.30.11.206 | A15 | 1115.30.10.407 | > [!NOTE] > Nota > > - Los siguientes modelos y versiones mínimas soportan **el Modo de Autorización** y **el Modo de Solicitud de Autenticación Multifactor:** > - A08: 108.30.11.228 > - E16V2: 216.30.12.33 > - **La autenticación por código de barras** se soporta en dispositivos A08 que ejecutan el firmware 108.30.12.9 o posterior. Los códigos de barras escaneados se tratan como credenciales de tarjeta y se transmiten usando la variable **{Card}** . ## Antes de que empieces Asegúrate de tener: - La API HTTP proporcionada por el servidor de terceros. - ID de dispositivo asignado por el sistema de terceros. - Método de autenticación planificado (código QR, tarjeta, PIN o multifactor). ## Resumen de la configuración Se soportan dos modos de integración: **Integración general** - Se usa solo para **autenticación por código QR**. - El dispositivo envía una solicitud HTTP predefinida que contiene datos de códigos QR. **Integración personalizada** - Se utiliza para **múltiples métodos de autenticación**. - Soporta código QR, tarjeta, PIN y autenticación multifactor. - Permite un formato flexible de datos para el procesamiento en el lado del servidor. ## Pasos de configuración Tomemos a A08 como ejemplo. 1. Utiliza la IP del dispositivo para iniciar sesión en su interfaz web. El nombre de usuario inicial y la contraseña son **administrador**. 2. Ve a **control de acceso > relé > integración de terceros**. 3. Selecciona el tipo de integración. - **General**: Transmite la URL HTTP vinculada por código QR en el método de Akuvox. - **Personalizar**: Transmite los datos de las credenciales de acceso de forma personalizada. ![](https://cdn.document360.io/f09a6106-e976-455e-b2d0-3d88b5385960/Images/Documentation/Screenshot 2026-04-10 145414.png) ### Opción A: Integración general (solo código QR) **Cuándo usar:** - Solo se requiere autenticación por código QR. - El servidor verifica los códigos QR mediante solicitudes HTTP. 1. Introduce el comando HTTP proporcionado por el proveedor de servicios externo. **Formato de ejemplo**: *http://192.168.31.123:8090/api/visitor/scan?codeKey={QRCode}&deviceId={DeviceID}* 2. Introduce el ID del dispositivo proporcionado por el servidor de terceros. 3. **Seleccione el modo de autorización**. Configure el **nombre de usuario** y **la contraseña** usados para la autenticación cuando se seleccione **el modo Básico** o **Digest**. ![](https://cdn.document360.io/f09a6106-e976-455e-b2d0-3d88b5385960/Images/Documentation/image-F9LC0OWK.png) 1. Envía la configuración. #### Formato de respuesta del servidor Tras recibir la solicitud, el servidor de terceros debe devolver una **respuesta JSON válida** indicando si se ha concedido el acceso. El dispositivo determina el resultado en función de campos específicos en la respuesta. **Parámetro de éxito soportado**: - "es válido": verdadero - "es válido": 1 - "validation_result": "1" **Parámetro fallido soportado**: - "es válido": falso - "es válido": 0 - "validation_result": "0" #### Tiempo de espera de respuesta El dispositivo espera una respuesta del servidor de terceros en un plazo limitado. - **Tiempo muerto: 3 segundos** Si no se recibe respuesta válida dentro de este plazo: - La solicitud se **considerará rechazada.** - El acceso se **denegará automáticamente.** #### Resultado - Cuando se escanea un código QR: - `{QRCode}` se sustituye por el contenido real de QR. - `{DeviceID}` identifica el dispositivo. - El servidor verifica la solicitud. - El dispositivo abre la puerta si la verificación tiene éxito. ![](https://cdn.document360.io/f09a6106-e976-455e-b2d0-3d88b5385960/Images/Documentation/image-AQVTW9CX.png) Ejemplo de URL recibida ### Opción B: Integración personalizada **Cuándo usar**: - Se requieren múltiples métodos de autenticación. - La lógica de verificación personalizada se implementa en el servidor. **Credenciales soportadas:** - Código QR - Código de barras (tratado como credencial de tarjeta) - Tarjeta RF - PIN - Autenticación multifactor > [!NOTE] > Nota > > En A08, los códigos de barras escaneados se procesan como credenciales de tarjeta y se transmiten usando la variable **{Card}** durante la integración con servidores de terceros. Antes de configurar la integración, especifique qué **Modo de Autenticación** utiliza el dispositivo. Seleccione el modo de autenticación en la interfaz **de Control de Acceso > Relé > Modo de Autenticación de Acceso** . ![](https://cdn.document360.io/f09a6106-e976-455e-b2d0-3d88b5385960/Images/Documentation/image-HI41VU7C.png) #### Escenario 1: Cualquier Modo Método En este modo, cualquier credencial seleccionada puede activar la verificación. 1. Selecciona el(los) método(s) de acceso que el servidor de terceros va a verificar. 2. **Seleccione el modo de autorización**. Configure el **nombre de usuario** y **la contraseña** usados para la autenticación cuando se seleccione **el modo Básico** o **Digest**. 3. Introduce el comando HTTP proporcionado por el proveedor de servicios externo. **Formato de ejemplo**: *http://192.168.31.123:8090/api/visitor/scan?codeKey={QRCode}/{Card}/{Pin}&deviceId={DeviceID}.* 4. Introduce el ID del dispositivo proporcionado por el servidor de terceros. ![](https://cdn.document360.io/f09a6106-e976-455e-b2d0-3d88b5385960/Images/Documentation/image-05I3TGS5.png) 1. Envía la configuración. > [!WARNING] > Propina > > Modelos específicos (X916, S535, R29, A05V2, A15, E18, E16V2 y E16V3) soportan la función **de Prompt en LCD** . > > - Selecciona **Predeterminado** para adoptar la señal de apertura de puerta del teléfono Akuvox. > - **Selecciona Valor de retorno** para usar el valor de retorno del servidor de terceros como indicación. #### Formato de respuesta del servidor Tras recibir la solicitud, el servidor de terceros debe devolver una **respuesta válida** indicando si se concede el acceso. El dispositivo determina el resultado en función de campos específicos en la respuesta. **Parámetro de éxito soportado**: - "es válido": verdadero - "es válido": 1 - "validation_result": "1" **Parámetro fallido soportado**: - "es válido": falso - "es válido": 0 - "validation_result": "0" #### Tiempo de espera de respuesta El dispositivo espera una respuesta del servidor de terceros en un plazo limitado. - **Tiempo muerto: 3 segundos** Si no se recibe respuesta válida dentro de este plazo: - La solicitud se **considerará rechazada.** - El acceso se **denegará automáticamente.** #### Resultado - El dispositivo envía la credencial utilizada (QR, tarjeta o PIN). - La variable correspondiente se reemplaza en la URL. - El servidor verifica la credencial y devuelve el resultado. ![](https://cdn.document360.io/f09a6106-e976-455e-b2d0-3d88b5385960/Images/Documentation/image-JON6PLTJ.png) Ejemplo de URL recibida #### Escenario 2: Modo de autenticación en dos pasos Este modo requiere dos credenciales en secuencia. Las combinaciones soportadas son **Tarjeta RF + PIN** y **PIN + Tarjeta RF**. > [!NOTE] > Nota > > En dispositivos A08/E16V2 que ejecutan el firmware **108.30.11.228/216.30.12.33 o posterior**, el flujo de trabajo depende del **modo de solicitud de autenticación multifactor** . En todos los demás modelos —y en el firmware A08 anterior a 108.30.11.228— solo se aplica el flujo de trabajo de Solicitudes Separadas. **Flujo de trabajo:** | Solicitudes separadas | Solicitud Combinada Única | | --- | --- | | El usuario completa el primer paso de autenticación (por ejemplo, desliza la tarjeta de RF). | El usuario completa el primer paso de autenticación (por ejemplo, desliza la tarjeta de RF). | | El dispositivo envía inmediatamente la primera credencial al servidor usando **{Token}**. El servidor la verifica y devuelve un resultado. | El dispositivo guarda la credencial recogida y espera — aún no se envía ninguna solicitud. | | El usuario completa el segundo paso de autenticación (por ejemplo, introduce el PIN). | El usuario completa el segundo paso de autenticación (por ejemplo, introduce el PIN). | | El dispositivo envía la segunda credencial al servidor usando **{Token}**. El servidor la verifica y devuelve un resultado. | El dispositivo envía ambas credenciales juntas en una sola solicitud usando **{Card}** y **{Pin}**. El servidor verifica ambas y devuelve un resultado. | En ambos casos, si la credencial introducida en cualquiera de los pasos no coincide con el Modo de Autenticación de Dos Factores configurado, se pide al usuario que utilice el método correcto antes de enviar la solicitud. 1. Selecciona el modo de verificación remota **multifactor** . 2. Seleccione el **modo de solicitud de autenticación multifactor**. 3. **Seleccione el modo de autorización**. Configure el **nombre de usuario** y **la contraseña** usados para la autenticación cuando se seleccione **el modo Básico** o **Digest**. 4. Introduce el comando HTTP proporcionado por el proveedor de servicios externo. **Formato de ejemplo**: Para el modo **Solicitudes Separadas** : *http://192.168.31.123:8090/api/visitor/scan?codeKey={Token}/{Type}&deviceId={DeviceID}* Para el modo **de Solicitud Combinada Simple** : *http://192.168.31.123:8090/api/visitor/scan?codeKey={Card}/{Pin}/{Type}&deviceId={DeviceID}* 1. Introduce el ID del dispositivo proporcionado por el servidor de terceros. ![](https://cdn.document360.io/f09a6106-e976-455e-b2d0-3d88b5385960/Images/Documentation/image-1S5BYIJY.png) 1. Envía la configuración. > [!WARNING] > Propina > > Modelos específicos (X916, S535, R29, A05V2, E18, X912, E16V2 y E16V3) soportan la función **de Prompt en LCD** . > > - Selecciona **Predeterminado** para adoptar la señal de apertura de puerta del teléfono Akuvox. > - **Selecciona Valor de retorno** para usar el valor de retorno del servidor de terceros como indicación. #### Formato de respuesta del servidor Tras recibir la solicitud, el servidor de terceros debe devolver una **respuesta JSON válida** indicando si se ha concedido el acceso. El dispositivo determina el resultado en función de campos específicos en la respuesta. **Parámetro de éxito soportado**: - "es válido": verdadero - "es válido": 1 - "validation_result": "1" **Parámetro fallido soportado**: - "es válido": falso - "es válido": 0 - "validation_result": "0" #### Tiempo de espera de respuesta El dispositivo espera una respuesta del servidor de terceros en un plazo limitado. - **Tiempo muerto: 3 segundos** Si no se recibe respuesta válida dentro de este plazo: - La solicitud se **considerará rechazada** - El acceso se **denegará automáticamente** #### Resultado - `{Token}` representa la credencial recogida en cada paso. - `{Type}` indica la secuencia de autenticación: - `1` = Tarjeta RF + PIN - `2` = PIN + Tarjeta RF - `3` = Carta de cara + RF - `4` = Cara + PIN - El servidor verifica ambas credenciales antes de conceder acceso. ![](https://cdn.document360.io/f09a6106-e976-455e-b2d0-3d88b5385960/Images/Documentation/image-IMUT4APX.png) Ejemplo de URL recibida ## Descripción de la variable | Variable | Descripción | | --- | --- | | {QRCode} | Contenido del código QR | | {Card} / {CardCode} | Contenido del número de tarjeta o código de barras cuando se utiliza un código de barras como credencial de tarjeta | | {Pin} / {PINCode} | Código PIN | | {UserID} | El ID de usuario asociado con la cara del usuario. | | {Cara} | Los valores de las características se convirtieron a partir de los datos de la cara. | | {BLE} | El código de desbloqueo Bluetooth. | | {DeviceID} | Identificador de dispositivo | | {Token} | Credenciales recogidas en el paso actual | | {Tipo} | Tipo de autenticación en dos factores | | {Tiempo} | La hora actual del dispositivo | ## Diferencias de capacidad de modelo ### Capacidades de autenticación Diferentes modelos soportan distintos métodos de autenticación para la integración con servidores de terceros. | Modelo | Métodos soportados | | --- | --- | | S539 / S538 | Código QR | | S535 | Código QR, Tarjeta, Cara, PIN | | E18 | Código QR, tarjeta, PIN | | E16V3 | Código QR, tarjeta | | X916 | Código QR, Tarjeta, Cara | | R29 / A15 / E16V2 / X915V2 | Código QR, tarjeta, figura, NIP, dos pasos | | X912 | Código QR, tarjeta, rostro, PIN, Bluetooth, dos pasos | | A08 | Código QR, PIN, tarjeta RF, dos pasos, Código de barras (como tarjeta) compatible con el firmware 108.30.12.9 | | A05 | Código QR, Tarjeta, Cara | | A02 / A01 | Tarjeta, PIN | ### Variables soportadas por modelo Diferentes modelos soportan variables distintas al enviar datos al servidor. | Modelo | Formato variable | | --- | --- | | S539 / S538 | {QRCode}, {DeviceID}, {Time} | | S535 | {QRCode}, {Card}, {Pin}, {UserID}, {DeviceID}, {Time} | | E18 | {QRCode}, {Card}, {Pin}, {DeviceID}, {Time} | | E16V3 | {QRCode}, {Card}, {DeviceID}, {Time} | | X916 | {QRCode}, {Card}, {UserID}, {DeviceID}, {Time} | | A15 / E16V2 / X915V2 | {QRCode}, {Card}, {Pin}, {UserID}, {DeviceID}, {Token}, {Type}, {Time} | | X912 | {QRCode}, {Card}, {Pin}, {UserID}, {BLE}, {DeviceID}, {Token}, {Type}, {Time} | | R29 | {QRCode}, {Card}, {Pin}, {Face}, {UserID}, {DeviceID}, {Token}, {Type}, {Time} | | A08 | {QRCode}, {Card}, {Pin}, {DeviceID}, {Token}, {Type}, {Time} | | A05V2 | {QRCode}, {Card}, {UserID}, {DeviceID}, {Time} | | A02 / A01 | {Card}, {PINCode}, {DeviceID}, {Time} | > [!NOTE] > Nota > > - Los formatos de variables NO son intercambiables entre modelos. > - Solo las variables soportadas por el modelo de dispositivo pueden usarse en el comando HTTP. > - El uso de variables no soportadas puede resultar en solicitudes fallidas.