README

数字指纹读取器 FP 4500 Digital Persona

视频教程

先决条件

在你的 Laravel 应用程序中实现用户 CRUD 功能。

安装

要安装此包，请在您的终端中执行以下命令

composer require mhtutorials/dpfp4500

安装完成后，发布模型、控制器、视图、迁移等。为此，请在您的终端中执行以下命令

    php artisan vendor:publish --tag=mhtutorials-dpfp4500-p

将配置添加到 config/services.php 文件中

将 "mhdpfp" 密钥复制到您的应用程序的 config/services.php 文件中。在此配置中，将存储 api 密钥，以便插件可以连接到您的 Laravel 项目的服务。

注意：如果您的文件已包含其他密钥，您可以将其添加到数组末尾作为另一个密钥

return [   
 'mhdpfp' => [
            'key' => env('PLUGIN_BIOMETRIC_KEY'),        
     ],
];

修改 .env 文件

在您的 .env 文件中创建键：PLUGIN_BIOMETRIC_KEY，如下所示

PLUGIN_BIOMETRIC_KEY="tu clave aqui"

键的值是通过 base64 编码 "用户:密码" 生成的。

您的 api 键的示例：将 "tu_usuario:tupass" 编码为 base64 -> 结果 dHVfdXN1YXJpbzp0dXBhc3M=，这将是您需要配置的键。

您可以访问页面：https://www.base64encode.org/，复制 tu_usuario:tupass 并点击按钮 "ENCODE"，结果将是：dHVfdXN1YXJpbzp0dXBhc3M=

注意：这些凭据将在以后配置到生物识别插件中。

添加 API 路由

将下面的导入复制到您的 routes/api.php 文件中

use App\Http\Controllers\DpfpApi\UserRestApiController;
use App\Http\Controllers\DpfpApi\SseController;

将下面的路由复制并粘贴到您的 routes/api.php 文件中

//SensorRestApi
Route::get("/sse/{token_pc}", [SseController::class, "stream"]);
Route::get("/ssejs/{token_pc}", [SseController::class, "streamjs"]);
Route::post("sensor_close", [SseController::class, "update"])->name("sensor_close");

//UserRestApi
Route::post("list_finger", [UserRestApiController::class, "index"]);
Route::post("save_finger", [UserRestApiController::class, "store"]);
Route::post("update_finger", [UserRestApiController::class, "update"]);
Route::post("sincronizar", [UserRestApiController::class, "sincronizar"]);

添加 Web 路由

将下面的导入复制到您的 routes/web.php 文件中

use App\Http\Controllers\DpfpApi\UserRestApiController;
use App\Http\Controllers\DpfpApi\TempFingerprintController;

将下面的路由复制并粘贴到您的 routes/web.php 文件中

// Ruta Home del paquete 
Route::get('/home_dpfp', function () {
    return view('dpfp_views/home_dpfp');
});
//Rutas para interactuar con el plugin
Route::get('/users/verify-users', [UserRestApiController::class, 'verify_users'])->name('verify-users');
Route::get('/users', [UserRestApiController::class, 'users_list'])->name('users_list');
Route::get("/users/{user}/finger-list", [UserRestApiController::class, "fingerList"])->name("finger-list");
Route::post('/active_sensor_read', [TempFingerprintController::class, 'store_read']);
Route::post('/active_sensor_enroll', [TempFingerprintController::class, 'store_enroll']);
Route::get("/get-finger/{user}", [UserRestApiController::class, "get_finger"])->name("get_finger");

执行迁移

执行以下命令
```
   php artisan migrate
```
将 temp_fingerprint 表中的 'image' 和 'fingerprint' 字段从 blob 类型更改为 longblob 类型
将 fingerprints 表中的 'fingerprint' 字段从 blob 类型更改为 longblob 类型

在 User.php 模型中添加指纹关系

将以下关系复制并粘贴到您的 User.php 模型中

//Relacion uno a muchos
public function fingerprints() {
       return $this->hasMany("App\Models\DpfpModels\FingerPrint");
}

重要信息

请记住发布 "storage" 的直接访问权限，以便可以存储用户的指纹，为此请执行以下命令

php artisan storage:link

仅针对 Windows 下载和配置生物识别插件

从以下链接下载生物识别插件安装程序 "BiometricWebBridgeV2-For-Laravel_Setup.exe"：https://drive.google.com/file/d/1VwDyreAWn1u2Y63pxAu4Mo8rFrlS_Q2N/view?usp=drive_link

打开生物识别插件程序，填写配置表单中的字段

Api URL：指向您的项目 api 路由的 URL，例如：https:///tu-projecto/public/api 或 http://tu-dominio.xx/api

要获取令牌，请转到您的项目路由：home_dpfp，并点击链接 "Create Token"

PC 令牌：是从您的 web 应用程序生成的令牌。

用户和密码：是您在上面的 '修改 .env 文件' 部分中编码的凭据，对于本例而言是

用户：tu_usuario

密码：tupass

现在点击带有保存图标的按钮，插件将自动重启。如果一切配置正确，您就可以开始注册并验证用户的指纹。

希望这个包能帮助到您的项目 :)