Esta página trata sobre la autenticación de tarjetas de identificación o PIN a través de un servicio personalizado mediante API. Esto resulta útil cuando su servicio de autenticación no es compatible de forma nativa con MyQ. Para autenticar las credenciales de los usuarios frente a servidores LDAP o RADIUS, consulte Autenticación de usuarios desde LDAP o RADIUS.
La autenticación externa se utiliza para iniciar sesión en el terminal integrado de MyQ y en el Cliente de Escritorio MyQ. La interfaz web de MyQ y el Cliente Móvil MyQ X requieren credenciales configuradas en MyQ.
Cómo funciona
Se configura un conector API entre MyQ y el servicio de autenticación. MyQ solicita la autenticación a través de este conector, y en el otro extremo se encuentra el propio servicio de autenticación, donde se almacenan los usuarios y sus credenciales.
-
El usuario intenta iniciar sesión en el terminal integrado de MyQ mediante uno de estos métodos:
-
Pasando su tarjeta de identificación
-
Introduciendo su PIN
-
-
La solicitud se envía al conector API, incluyendo el tipo de método de inicio de sesión y el valor correspondiente.
-
El conector gestiona la comunicación con el servicio de autenticación y devuelve a MyQ el usuario que coincide.
Existen dos modos de funcionamiento para la autenticación externa. Puede ser la forma principal de autenticar a los usuarios o bien configurarse como autenticación de respaldo en caso de que falle la autenticación en MyQ. Para ello, se puede seleccionar la opción Utilizar solo si falla la autenticación en la base de datos de MyQ.
Solicitud de autenticación
Métodos de inicio de sesión compatibles
Esta configuración define el método de inicio de sesión para el que se utiliza la autenticación externa. El otro método de inicio de sesión, el que no esté seleccionado, autentica al usuario mediante las credenciales de MyQ.
-
Tarjeta ID
-
PIN
MyQ envía el tipo de método de inicio de sesión junto con el valor real del PIN o de la tarjeta de identificación, de modo que el conector de la API pueda reconocer qué propiedad de usuario debe utilizarse para identificar al usuario correcto.
Por ejemplo, si se selecciona Tarjeta ID y el usuario realiza la autenticación en el terminal integrado con una tarjeta ID, MyQ envía loginType=1&loginValue=1234. Esto puede interpretarse como el número de tarjeta ID 1234.
Si hay un lector de tarjetas que emula pulsaciones de teclas conectado al dispositivo y un usuario pasa su tarjeta, MyQ no puede reconocer si el valor recibido es un PIN o el número de una tarjeta de identificación. MyQ indica esto al conector de la API (loginType=7). El conector debe configurarse para gestionar estas solicitudes, por ejemplo, intentando la autenticación con ambas propiedades de usuario.
Respuesta de autenticación
Identificadores de usuario admitidos
El conector de la API debe responder a MyQ en formato JSON con uno de los valores para emparejar al usuario correcto e iniciar su sesión en el cliente.
-
Número personal de un usuario existente en MyQ
-
Nombre de usuario de un usuario existente en MyQ
Ejemplos de respuestas:
-
{"result":0,"personalNumber":"123456"}significa que el servicio de autenticación ha identificado correctamente al usuario y que su número personal es123456. El usuario con este número personal en MyQ ha sido autenticado. -
{"result":0,"username":"JohnDoe"}significa que se ha identificado al usuario y que su nombre de usuario esJohnDoe. El usuario con este nombre de usuario en MyQ ha sido autenticado.
Estados de error
-
Usuario no válido (
{"result":1}): se ha encontrado al usuario, pero su cuenta no es válida (por ejemplo, está desactivada) -
No se ha encontrado ningún usuario (
{"result":2}): no hay ningún usuario asociado a las credenciales
Casos de uso habituales
El conector de API externa puede utilizarse, en su forma más sencilla, para «traducir» solicitudes. No obstante, también permite flujos de trabajo de autenticación más avanzados, ya que el propio conector puede realizar una serie de operaciones antes de devolver el usuario correspondiente a MyQ.
Ejemplo 1: Se requiere un servicio de autenticación no compatible con MyQ
Un conector que traduce las llamadas a la API entre MyQ y el servicio de autenticación remoto.
Ejemplo 2: Flujo de trabajo de autenticación avanzado: identidades múltiples
La autenticación externa puede utilizarse en aquellos casos en los que sea necesario que se produzca alguna operación entre MyQ y el servidor de autenticación. Esto puede incluir transformaciones, reconocimiento avanzado de usuarios en entornos con varios dominios y mucho más.
Configuración de la autenticación externa
La autenticación externa se puede habilitar y configurar en MyQ > Configuración > Autenticación de Usuarios.
-
URL: introduzca la URL en la que se ejecuta el conector de la API
-
Nombre de usuario: introduzca el nombre de usuario necesario para la conexión con el servidor externo a través de la API
-
Contraseña: introduzca la contraseña necesaria para la conexión con el servidor externo a través de la API
-
Método de inicio de sesión: seleccione el método de inicio de sesión de los usuarios: tarjeta ID o PIN
-
Utilizar solo si falla la autenticación con la base de datos de MyQ: esta opción define si la autenticación externa será el método principal o secundario de autenticación
-
Si está habilitada, el usuario se autentica primero en el MyQ Print Server y, solo si falla, el siguiente intento se realiza a través del servicio de autenticación remota
-
Si está desactivada, no se realiza ninguna autenticación en el MyQ Print Server; siempre se utiliza el servicio de autenticación externa
-