Download the PHP package mhtutorials/dpfp4500ws without Composer
On this page you can find all versions of the php package mhtutorials/dpfp4500ws. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download mhtutorials/dpfp4500ws
More information about mhtutorials/dpfp4500ws
Files in mhtutorials/dpfp4500ws
Package dpfp4500ws
Short Description Biometria FingerPrint-4500 + WebSockets
License MIT
Informations about the package dpfp4500ws
DPFP 4500 Para Laravel | Comunicación por WebSockets
Lector de huella FP 4500 Digital Persona + WebSockets
Video Tutorial
Pre-Requisitos
- Tener composer instalado
- Tener NodeJs instalado
- CRUD de usuarios funcional en tu aplicación laravel.
Crear proyecto laravel si aún no lo has creado
1.Puedes usar laravel new: Si tienes el instalador de Laravel (laravel/installer) instalado globalmente, puedes usar el siguiente comando:
Reemplaza nombre-del-proyecto con el nombre que deseas para tu nuevo proyecto Laravel.
2.Puedes usar composer create-project: Si prefieres utilizar Composer directamente, puedes hacerlo de la siguiente manera:
Al igual que antes, reemplaza nombre-del-proyecto con el nombre que deseas para tu nuevo proyecto Laravel.
Crear Dominio Local:
Sigue el paso a paso que nos comparte nuestro amigo de codersfree.com https://codersfree.com/posts/configurar-virtualhost-xampp-windows-guia-paso-a-paso
Instalar rutas de api (Laravel 10 o superior)
Ejecuta el comando:
Regenerar id de proyecto (Laravel 10 o superior)
Ejecuta el comando:
Con esto se creará el archivo api.php en el directorio routes.
Crear Login (Opcional)
Ejecuta el siguiente comando para descargar el paquete de login de laravel
Ejecuta el siguiente comando para publicar las vistas del login
Instalación
Para instalar el paquete, ejecuta el siguiente comando en tu terminal:
composer require mhtutorials/dpfp4500ws
Una vez instalado, publicar los modelos, controladores, vistas, migraciones, etc. Para ello ejecuta el siguiente comando en tu terminal:
Agregar configuración al archivo config/services.php
Copiar la clave "mhdpfp" en el archivo config/services.php de tu aplicación. En esta configuración se almacenará la clave de api para que el pluguin pueda conectarse a los servicios de tu proyecto laravel.
NOTA: si tu archivo ya contiene otras claves puedes agregarla al final como una clave mas del array
Modificar archivo .env
Crear la clave: PLUGIN_BIOMETRIC_KEY en tu archivo .env de la siguiente manera:
El valor de la clave se genera codificando en base 64 "usuario:contraseña".
Un ejemplo de tu clave api: codifica "tu_usuario:tupass" -> resultado dHVfdXN1YXJpbzp0dXBhc3M= esta ultima será la clave que debes configurar.
Puedes ir a la pagina: https://www.base64encode.org/, copia tu_usuario:tupass y da click en el botón "ENCODE", el resultado seria: dHVfdXN1YXJpbzp0dXBhc3M=
NOTA: Estas credenciales se configurarán posteriormente en el plugin biometrico.
Agregar Rutas api
-
Copia el import a continuación en tu archivo routes/api.php
- Copia y pega las rutas a continuación en tu archivo routes/api.php
Agregar Rutas web
-
Copia los import a continuación en tu archivo routes/web.php
- Copia y pega las rutas a continuación en tu archivo routes/web.php
Ejecutar las migraciones:
- Ejecuta el comando
Actualizar campo tipo BLOB a LONGBLOG:
- Modifica el campo 'fingerprint' de tipo blob a longblob en la tabla: fingerprints
Agrega la relación de huellas al modelo User.php
Copia y pega la relacion a continuación en tu modelo User.php
Cambia la siguiente linea en el archivo ServerNodeJs/index.js
http://pruebafp.test por http://tu-dominio en las lineas 6 y 20
Instala Express en el servidor NodeJs: ServerNodeJs
Ingresa a la ruta del servidor NodeJs en tu ptoyecto, ejempo: "Tu_Proyecto_Laravel/ServerNodeJs" y ejecuta el comando:
Instalar PM2 en tu proyecto:
Instalar Node.js si aun no lo has instalado:
PM2 es una herramienta de administración de procesos de Node.js, por lo que necesitas tener Node.js instalado en tu sistema. Puedes descargar la última versión de Node.js desde su sitio web oficial https://nodejs.org/en.
- Instalar PM2:
Abre la línea de comandos (cmd) como administrador. Ejecuta el siguiente comando para instalar PM2 de forma global:
El flag -g instala PM2 globalmente para que puedas acceder a él desde cualquier lugar en tu sistema.
- Verificar la instalación:
Después de la instalación, puedes verificar si PM2 se instaló correctamente ejecutando el siguiente comando:
Esto debería mostrar la versión de PM2 que has instalado.
- Uso básico:
Para ejecutar una aplicación con PM2, navega hasta el directorio de tu aplicación en la línea de comandos y ejecuta el siguiente comando:
(Reemplaza "app.js" con el nombre de tu archivo principal de la aplicación).
-
Para ver la lista de procesos gestionados por PM2, utiliza el siguiente comando:
- Puedes detener una aplicación con PM2 usando:
(Reemplaza "
Puedes obtener más información sobre PM2 y sus comandos en la documentación oficial de PM2.
Información Importante:
Recuerda publicar el acceso directo a "storage" para que se puedan almacenar las huellas de los usuarios, para ello ejecuta el comando a continuación:
Descargar y configurar el plugin biometrico solo para windows
Descarga el instalador del plugin biometrico "BiometricWebBridgeSocket-For-Laravel Setup.exe" desde el siguiente enlace: https://drive.google.com/file/d/1thg3cE6Va-N9Gm1xrx2DiW50CxYwM170/view?usp=sharing
-
Abre el programa plugin biometrico, diligencia los campos en el formulario de configuración
Url Api: es la url de tu proyecto que apunta hacia las rutas de api, ejemplo: http://localhost/tu-projecto/public/api/ o http://tu-dominio.xx/api/
Url Socket: es la url de tu proyecto con el cual configuraste el web socket, por defecto es: ws://localhost:3000
Para obtener las claves ve a la ruta de tu proyecto: /users y da click los links "Crear Server Key" y "Crear Client Key"
Server Key y Client Key: Son las claves generadas por la aplicacion web
Usuario y Password: Son las credenciales que codificaste un paso mas arriba, en el apartado 'Modificar archivo .env', para este ejemplo son:
Usuario: tu_usuario
Password: tupass
Ahora presiona el botón con el icono de guardar, el plugin se reiniciara automaticamente y si todo ha quedado bien configurado ya puedes comenzar a enrolar y verificar las huellas de tus usuarios.
Espero que este paquete te ayude en tus proyectos :)