PHPackages                             minvws/puzi-laravel - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Security](/categories/security)
4. /
5. minvws/puzi-laravel

ActiveLaravel[Security](/categories/security)

minvws/puzi-laravel
===================

Laravel authentication middleware for UZI passes.

v3.2.2(3y ago)12.5k5[3 issues](https://github.com/minvws/pUZI-laravel/issues)EUPL-1.2PHPPHP ^8.0CI failing

Since Mar 16Pushed 8mo ago13 watchersCompare

[ Source](https://github.com/minvws/pUZI-laravel)[ Packagist](https://packagist.org/packages/minvws/puzi-laravel)[ RSS](/packages/minvws-puzi-laravel/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (10)Dependencies (8)Versions (19)Used By (0)

[![pUZI logo](pUZI.svg "pUZI logo")](pUZI.svg)

pUZI Laravel
============

[](#puzi-laravel)

[![Laravel](https://github.com/minvws/pUZI-laravel/actions/workflows/test.yml/badge.svg)](https://github.com/minvws/pUZI-laravel/actions/workflows/test.yml)

Proficient UZI pass reader in php.

The UZI card is part of an authentication mechanism for medical staff and doctors working in the Netherlands. The cards are distributed by the CIBG. More information and the relevant client software can be found at [www.uziregister.nl](http://www.uziregister.nl) (in Dutch).

pUZI is a simple and functional module which allows you to use the UZI cards as authentication mechanism. It consists of:

1. a reader that reads the data on the card and gives an UziUser object in return.
2. middleware (for the Laravel framework) that allows authentication and user creation based on UZI cards (this repository).

For documentation, software and to apply for an UZI card, please check out [www.uziregister.nl](https://www.uziregister.nl).

pUZI is available under the EU PL licence. It was created early 2021 during the COVID19 campaign as part of the vaccination registration project BRBA for the ‘Ministerie van Volksgezondheid, Welzijn &amp; Sport, programma Realisatie Digitale Ondersteuning.’

Questions and contributions are welcome via [GitHub](https://github.com/minvws/pUZI-laravel/issues).

Requirements
------------

[](#requirements)

- PHP 8
- Laravel 8 or later.

Apache config (or NginX equivalent):

```
SSLEngine on
SSLProtocol -all +TLSv1.3
SSLHonorCipherOrder on
SSLCipherSuite ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384
SSLVerifyClient require
SSLVerifyDepth 3
SSLCACertificateFile /path/to/uziCA.crt
SSLOptions +StdEnvVars +ExportCertData
```

Installation
------------

[](#installation)

### Composer

[](#composer)

```
composer require minvws/puzi-laravel
```

### Manual

[](#manual)

Add the following to your `composer.json` and then run `composer install`.

```
{
    "require": {
        "minvws/puzi-laravel": "^v3.0"
    }
}
```

Usage
-----

[](#usage)

```
php artisan vendor:publish --provider="MinVWS\PUZI\Laravel\UziServiceProvider"
```

Add to `$routeMiddleware` array in `app/Http/Kernel.php`:

```
    'auth.uzi' => \MinVWS\PUZI\Laravel\Middleware\AuthenticateWithUzi::class,
```

Add some `allowed_types` and `allowed_roles` to the `config/uzi.php`.

For example:

```
    // Which card types are allowed to log in
    'allowed_types' => [
        \MinVWS\PUZI\UziConstants::UZI_TYPE_CARE_PROVIDER
    ],

    // Which roles are allowed to log in
    'allowed_roles' => [
        \MinVWS\PUZI\UziConstants::UZI_ROLE_DOCTOR
    ],
```

In `routes/web.php` add the middleware to some routes, for example:

```
Route::middleware(['auth:web,auth.uzi'])->group(function () {
    Route::get('/any', [Controller::class, 'all'])->name('any');
    Route::get('/all', [Controller::class, 'all'])->name('all');
});

Route::middleware('auth.uzi')->group(function () {
    Route::get('/uzi', [Controller::class, 'uzi'])->name('uzi');
});
```

Uses
----

[](#uses)

puzi-php - [Proficient UZI pass reader in PHP](https://github.com/minvws/pUZI-php)

phpseclib - [PHP Secure Communications Library](https://phpseclib.com/)

Contributing
------------

[](#contributing)

1. Fork the Project
2. Ensure you have Composer installed (see [Composer Download Instructions](https://getcomposer.org/download/))
3. Install Development Dependencies

    ```
    composer install
    ```
4. Create a Feature Branch
5. (Recommended) Run the Test Suite

    ```
    vendor/bin/phpunit
    ```
6. (Recommended) Check whether your code conforms to our Coding Standards by running

    ```
    vendor/bin/phpstan analyse
    vendor/bin/psalm
    vendor/bin/phpcs
    ```
7. Send us a Pull Request

[![pUZI](pUZI-hidden.svg "pUZI")](pUZI-hidden.svg)

###  Health Score

35

—

LowBetter than 79% of packages

Maintenance23

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community21

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~79 days

Recently: every ~5 days

Total

10

Last Release

1171d ago

Major Versions

0.2.0 → v1.0.02022-03-14

v1.0.0 → v2.0.02023-02-06

v2.1.0 → v3.0.02023-02-07

PHP version history (2 changes)0.1.0PHP &gt;=7.3

v1.0.0PHP ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/19b14ca62f80ce8c77ae749ddf04e2d4077451db9f701f3bd37dec1dc950c76b?d=identicon)[JayTaph](/maintainers/JayTaph)

![](https://www.gravatar.com/avatar/35585f12d5551026d3cf7e8e25170cd718a16a5017096b3201ed196311ac51d9?d=identicon)[annejan](/maintainers/annejan)

![](https://www.gravatar.com/avatar/44e7cc7a950c1f964d8c8a5e3421d5fa61d6592add09ee3936ed267d75b2be33?d=identicon)[rdobeheer](/maintainers/rdobeheer)

---

Top Contributors

[![annejan](https://avatars.githubusercontent.com/u/294470?v=4)](https://github.com/annejan "annejan (28 commits)")[![jaytaph](https://avatars.githubusercontent.com/u/241458?v=4)](https://github.com/jaytaph "jaytaph (22 commits)")[![ricklambrechts](https://avatars.githubusercontent.com/u/1367665?v=4)](https://github.com/ricklambrechts "ricklambrechts (15 commits)")[![sigio](https://avatars.githubusercontent.com/u/781641?v=4)](https://github.com/sigio "sigio (2 commits)")[![nicktencate](https://avatars.githubusercontent.com/u/4581304?v=4)](https://github.com/nicktencate "nicktencate (1 commits)")[![ppvg](https://avatars.githubusercontent.com/u/67802?v=4)](https://github.com/ppvg "ppvg (1 commits)")

---

Tags

icorelaraveluzi-cardsecuritycryptographycryptosignaturex509asn1UZI

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Psalm

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/minvws-puzi-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/minvws-puzi-laravel/health.svg)](https://phpackages.com/packages/minvws-puzi-laravel)
```

###  Alternatives

[phpseclib/phpseclib

PHP Secure Communications Library - Pure-PHP implementations of RSA, AES, SSH2, SFTP, X.509 etc.

5.6k434.8M1.3k](/packages/phpseclib-phpseclib)[defuse/php-encryption

Secure PHP Encryption Library

3.9k162.4M214](/packages/defuse-php-encryption)[ionux/phactor

Phactor is a high-performance PHP implementation of the elliptic curve math functions required to generate &amp; verify private/public (asymmetric) EC keypairs and ECDSA signatures based on secp256k1 curve parameters. This library also includes a class to generate Service Identification Numbers (SINs) based on the published Identity Protocol v1 spec.

5275.0k30](/packages/ionux-phactor)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
