README

Symfony的UZI认证扩展包

PHP中熟练的UZI通行证读取器。

UZI卡是荷兰医护人员和医生的身份认证机制的一部分。这些卡片由CIBG分发。更多信息和相关客户端软件可以在www.uziregister.nl（荷兰语）找到。

pUZI是一个简单且实用的模块，允许您将UZI卡用作身份认证机制。它包括

1. 一个读取卡上数据并返回UziUser对象的读取器。
2. 一个验证器，将给定的UziUser与一组类型和角色进行比较。
3. 一个基于UZI卡的symfony守卫验证器（本存储库）。

有关文档、软件以及申请UZI卡，请访问www.uziregister.nl。

pUZI遵循EU PL许可。它是在2021年初的COVID19运动期间作为疫苗接种注册项目BRBA的一部分为“Ministerie van Volksgezondheid, Welzijn & Sport, programma Realisatie Digitale Ondersteuning”创建的。

欢迎通过GitHub提问和贡献。

需求

• Symfony 4或更高版本

Apache配置（或NginX等效配置）

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

安装

Composer

composer require minvws/puzi-auth-bundle

使用

步骤1：使用Composer安装扩展包

composer require minvws/puzi-auth-bundle

步骤2：创建配置文件

# config/packages/puzi_auth.yaml
puzi_auth:
    strict_ca_check: true
    allowed_types:
        - !php/const MinVWS\PUZI\UziConstants::UZI_TYPE_NAMED_EMPLOYEE
        - !php/const MinVWS\PUZI\UziConstants::UZI_TYPE_CARE_PROVIDER
    allowed_roles:
        - !php/const MinVWS\PUZI\UziConstants::UZI_ROLE_DOCTOR  

步骤3：将守卫添加到您的security.yml

firewalls:
    main:
        guard:
           authenticators:
            - puzi_auth.security.guard.authenticator
        stateless: true

此时，经过认证的用户将是MinVWS\PUZI\AuthBundle\Security\User\UziUser类。您可以使用$this->getUser()->getUzi()获取有关UZI卡本身的任何信息。

使用

puzi-php - PHP中的熟练UZI通行证读取器

phpseclib - PHP安全通信库

贡献

1. 分支项目

2. 确保您已安装Composer（请参阅Composer下载说明）

3. 安装开发依赖项

   composer install

4. 创建功能分支

5. （推荐）运行测试套件

   vendor/bin/phpunit

6. （推荐）运行以下命令以检查您的代码是否符合我们的编码标准：

   vendor/bin/phpstan analyse
   vendor/bin/phpcs

7. 向我们发送拉取请求