Download the PHP package iserranodev/certificate-auth-bundle without Composer
On this page you can find all versions of the php package iserranodev/certificate-auth-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download iserranodev/certificate-auth-bundle
More information about iserranodev/certificate-auth-bundle
Files in iserranodev/certificate-auth-bundle
Package certificate-auth-bundle
Short Description Symfony bundle for X.509 client certificate authentication with configurable user lookup, pluggable identifier transformation, and role-based redirects.
License MIT
Informations about the package certificate-auth-bundle
CertificateAuthBundle
Bundle de Symfony para autenticación mediante certificados digitales X.509 (DNIe, FNMT, etc.). Totalmente configurable y sin dependencias externas más allá de Symfony y Doctrine.
Instalación
Al instalar, el bundle crea automáticamente:
config/packages/certificate_auth.yaml— configuración del bundleconfig/routes/certificate_auth.yaml— registro de rutas
Si usas Symfony Flex, el bundle se registra automáticamente. Si no, añádelo manualmente:
Configuración
Edita config/packages/certificate_auth.yaml (creado automáticamente):
El único parámetro obligatorio es user_class. Todo lo demás tiene valores por defecto razonables.
Configuración automática de Security
El bundle registra automáticamente el firewall, el provider y el checker en security.yaml mediante PrependExtensionInterface. No necesitas añadir nada manualmente en security.yaml.
El bundle inyecta esta configuración:
Si necesitas personalizar el firewall (por ejemplo, cambiar el pattern), puedes sobreescribirlo en tu propio security.yaml, ya que la configuración del bundle se inyecta con prependExtensionConfig (menor prioridad que tu config).
Configuración completa (referencia)
Transformación del identificador
Por defecto, el bundle busca el identificador del certificado (NIF, etc.) directamente en la base de datos sin transformarlo.
Con transformer personalizado
Con EncryptBundle u otro servicio
Configuración del servidor web
Apache
Nginx + PHP-FPM
Extensibilidad
Personalizar el UserChecker
Personalizar el extractor de datos del certificado
Sobreescribir el firewall
Si el pattern ^/certificado no te sirve, simplemente define tu firewall en security.yaml con la misma key certificate_auth y tu config tendrá prioridad:
Servicios registrados
| Service ID | Clase |
|---|---|
certificate_auth.authenticator |
CertificateAuthenticator |
certificate_auth.provider |
CertificateProvider |
certificate_auth.checker |
CertificateChecker |
certificate_auth.data_extractor |
CertificateDataExtractor |
certificate_auth.login_controller |
CertificateLoginController |
Requisitos
- PHP >= 8.1
- Symfony 6.x o 7.x
- Doctrine ORM
All versions of certificate-auth-bundle with dependencies
composer-plugin-api Version ^2.0
symfony/framework-bundle Version ^6.0|^7.0
symfony/security-bundle Version ^6.0|^7.0
doctrine/orm Version ^2.14|^3.0
doctrine/doctrine-bundle Version ^2.7