
Piense en la iluminación como su consultor de rendimiento y seguridad. ¡Enlightn "revisará" las configuraciones de su código y servidor, y le brindará recomendaciones procesables para mejorar el rendimiento, la seguridad y la confiabilidad!
La versión Enlightn OSS (Software de código abierto) tiene 66 comprobaciones automatizadas que escanean su código de aplicación, configuraciones de servidor web y rutas para identificar cuellos de botella de rendimiento, posibles vulnerabilidades de seguridad y problemas de confiabilidad del código.
Enlightn Pro (Commercial) está disponible para su compra en el sitio web de Enlightn y tiene 64 cheques automatizados adicionales (total de 131 cheques ).
Cada uno de los 131 cheques disponibles está bien documentados. Puede encontrar la documentación completa aquí.
| Iluminar | Laravado | Larastán | Phpstan |
|---|---|---|---|
| 1.x | 6.x-9.x | 0.6x-1.x | 0.12x-1.1x |
| 2.x | 9.x-11.x | 2.x | 1.4x+ |
NOTA: La misma matriz de compatibilidad se aplica para las versiones de Enlightn Pro.
Puede instalar CoLightn en su proyecto utilizando el Composer Package Manager:
composer require enlightn/enlightnDespués de instalar Ollightn, puede publicar sus activos utilizando el proveedor: Publicar el comando artesanal:
php artisan vendor:publish --tag=enlightnNOTA: Si necesita instalar CoLLEDN PRO, visite la documentación en el sitio web de Enlightn aquí.
Después de instalar Enlightn, simplemente ejecute el comando de enlightn Artisan para ejecutar Enlightn:
php artisan enlightn Puede agregar el indicador --report , si desea ver sus informes en la interfaz de usuario web de Enlightn además del terminal:
php artisan enlightn --reportSi desea ejecutar clases de analizador específicas, puede especificarlas como argumentos opcionales:
php artisan enlightn Enlightn \ Enlightn \ Analyzers \ Security \ CSRFAnalyzer Enlightn \ EnlightnPro \ Analyzers \ Security \ DirectoryTraversalAnalyzerTenga en cuenta que los nombres de la clase deben estar completamente calificados y escaparse con cortes dobles como se indicó anteriormente.
Si desea obtener la experiencia completa de la iluminación, se recomienda que al menos ejecute la iluminación una vez en producción. Esto se debe a que varios de los cheques de Illightn son específicos del entorno. Por lo tanto, solo pueden activarse cuando su entorno de aplicaciones es la producción.
En caso de que no desee ejecutar en producción, puede simular un entorno de producción configurando su App_env en producción, configurando servicios y configuración lo más cerca posible de producción y ejecutando su script de implementación de producción a nivel local. Luego ejecute el comando artesanal de la luz.
De manera predeterminada, el comando enlightn artesanal resalta las rutas de archivo, los números de línea asociados y un mensaje para cada verificación fallida. Si desea mostrar mensajes de error detallados para cada línea, puede usar la opción --details :
php artisan enlightn --details Si desea integrar a CoNlightn con su CI, simplemente puede activar la opción --ci al ejecutar Enlightn en su herramienta CI/CD:
php artisan enlightn --ci Puede agregar el indicador --report si desea ver sus informes de CI en la interfaz de usuario web de Enlightn. Recuerde agregar las credenciales de su proyecto a su archivo config/enlightn.php como se explica aquí.
php artisan enlightn --ci --reportEnlightn Pre-Configuras que los analizadores se pueden ejecutar en modo CI para usted. Por lo tanto, el comando anterior excluye los analizadores que necesitan una configuración completa para ejecutarse (por ejemplo, analizadores utilizando análisis dinámico).
Para obtener más información sobre la integración de CI, consulte la documentación de la iluminación.
A veces, especialmente en entornos CI, es posible que desee declarar la lista actualmente reportada de errores como la "línea de base". Esto significa que los errores actuales no se informarán en ejecuciones posteriores y solo se marcarán nuevos errores.
Para generar la línea de base automáticamente, puede ejecutar el comando enlightn:baseline Artisan:
php artisan enlightn:baseline Si desea ejecutar este comando en modo CI, puede usar la opción --ci :
php artisan enlightn:baseline --ciPara obtener más información sobre cómo establecer una línea de base, consulte los documentos.
Enlightn ofrece un hermoso panel de interfaz de usuario web donde puede ver sus informes de Enlightn activados desde su CI o ejecución de comando programado.
La interfaz de usuario web es gratuita para todos los usuarios e incluye lo siguiente:
Para obtener acceso a la interfaz de usuario web, todo lo que necesita hacer es registrarse de forma gratuita en el sitio web de Enlightn y seguir las instrucciones mencionadas aquí.
Además de integrar la iluminación con su herramienta de CI/CD, es una buena práctica programar una ejecución de iluminación en una frecuencia regular (como diario o semanal) como así:
// In your app/Console/Kernel.php file:
/**
* Define the application's command schedule.
*
* @param IlluminateConsoleSchedulingSchedule $schedule
* @return void
*/
protected function schedule ( Schedule $ schedule )
{
$ schedule -> command ( ' enlightn --report ' )-> runInBackground ()-> daily ()-> at ( ' 01:00 ' );
}Esto le permitirá monitorear las verificaciones de análisis dinámicos de la iluminación, que generalmente se excluyen de CI. Los informes se pueden ver en la interfaz de usuario de la web de iluminación.
Enlightn ofrece un bot GitHub que puede preparar un informe que resalta las verificaciones fallidas y también agregue comentarios de revisión para solicitudes de extracción en las líneas de código que introducen nuevos problemas.
Para integrarse con el Bot de Enlightn GitHub, consulte los documentos.
Todos los cheques que fallan incluirán una descripción de por qué fallan junto con las líneas de código asociadas (si corresponde) y un enlace a la documentación para la verificación específica.
Finalmente, después de que se han ejecutado todos los cheques, el comando enlightn Artisan generará una tarjeta de calificaciones, que contiene información sobre cuántos y qué porcentaje de cheques pasaron, fallaron o fueron omitidos.
Las verificaciones indicadas como "no aplicables" no eran aplicables a su aplicación específica y se omitieron. Por ejemplo, el analizador CSRF no es aplicable para aplicaciones sin estado.
Las verificaciones informadas en la fila de "error" indican los analizadores que fallaron con excepciones durante el análisis. Normalmente, esto no debería suceder, pero si lo hace, el mensaje de error asociado se mostrará y puede tener algo que ver con su aplicación.
Una buena práctica sería ejecutar a la luz cada vez que esté implementando código o presionando una nueva versión. Se recomienda integrar a la cofresión con su herramienta CI/CD para que se active para cada empuje o nueva versión.
Además de las verificaciones de CI automatizadas, también debe ejecutar la CoULDEN en una frecuencia regular utilizando un comando de consola programado como se describió anteriormente. Esto le permitirá monitorear las comprobaciones de análisis dinámico, que generalmente se excluyen de CI.
Solo los sistemas MacOS y Linux son compatibles con la iluminación. Windows no es compatible actualmente.
¡Gracias por considerar contribuir a la iluminación! La guía de contribución se puede encontrar aquí.
Nuestra política de soporte se puede encontrar en la documentación de la iluminación.
El OSS de Enlightn (en este repositorio de GitHub) tiene licencia bajo la licencia LGPL V3 (o posterior).
Ollightn Pro tiene licencia bajo una licencia comercial.