Controler automatiquement la sécurité de ses dépendances avec SensioLabs security checker, Jenkins et Phing

Aujourd'hui, nous incluons toujours plus de librairies externes dans nos projets. Même si on gagne beaucoup de temps, il n'est pas exclu que nous introduisions des failles de sécurité via ces lib. Ce contrôle n'est malheureusement pas systématique mais surtout rarement automatisé. Depuis quelques temps, SensioLabs propose un service pour réferencer des failles (CVE) dans des librairies ainsi que l'outil Security Checker pour controller les dépendances de son projet via le fichier composer.lock.

Security Checker

On peut trouver cet outil sur Github sous la forme d'un Phar ou en librairie à ajouter à notre projet. Pour l'exemple j'utilise la version Phar que j'ai ajouté dans mon path pour faciliter son utilisation. J'ai créé un projet vide en ajoutant des versions de librairies connues pour avoir une faille. L'utilisation de security checker est simple et le résultat très explicite.

~ / blog$ security-checker.phar security:check . / composer.lock Security Check Report ~~~~~~~~~~~~~~~~~~~~~ Checked file: / home / ulrich / blog / composer.lock [ CRITICAL ] 3 packages have known vulnerabilities doctrine / doctrine-bundle ( v1.2.0 ) --------------------------------- * CVE- 2015 - 5723 : Security Misconfiguration Vulnerability in various Doctrine projects http: // www.doctrine-project.org / 2015 / 08 / 31 / security_misconfiguration_vulnerability_in_various_doctrine_projects.html doctrine / orm ( v2.3.6 ) --------------------- * CVE- 2015 - 5723 : Security Misconfiguration Vulnerability in various Doctrine projects http: // www.doctrine-project.org / 2015 / 08 / 31 / security_misconfiguration_vulnerability_in_various_doctrine_projects.html zendframework / zend-json ( 2.2.1 ) ------------------------------- * Potential XXE / XEE attacks using PHP functions: simplexml_load_ * , DOMDocument::loadXML, and xml_parse http: // framework.zend.com / security / advisory / ZF2014-01 This checker can only detect vulnerabilities that are referenced Disclaimer in the SensioLabs security advisories database. Execute this command regularly to check the newly discovered vulnerabilities.

Automatisation

Comme beaucoup (j'espère) j'utilise un outil d'intégration continue, Jenkins dans mon cas. Et pour builder mon projet j'utilise Phing qui est un super outil, si si, même s'il n'est plus tout jeune. C'est donc l'occasion de parler un peu de Phing et de montrer comment faire une tâche un peu plus "intelligente". A la fin de l'article j'ai ajouté les équivalent pour Ant and Jenkins Pipeline.



Basiquement je pourrais créer une tâche ainsi:

<project name = "checksecu" basedir = "." default = "secu" > <target name = "secu" > <exec executable = "security-checker.phar" > <arg value = "security:check" /> <arg path = "./composer.lock" /> </exec > </target > </project >

Et l'exécution donne:

~ / blog$ phing.phar -f .. / jenkinsbuildconf / checksecu.xml Buildfile: / home / ulrich / blog / .. / jenkinsbuildconf / checksecu.xml checksecu > secu: BUILD FINISHED Total time: 0.4584 seconds

Le problème c'est que, d'une part je n'ai aucun retour, et surtout le build n'est pas considéré comme étant en erreur. Pour traiter le premier problème, il me suffit de renvoyer la sortie du script dans une variable via outputProperty et de l'afficher. Pour le second problème je peux utiliser checkreturn, ce qui me donne:

<project name = "checksecu" basedir = "." default = "secu" > <target name = "secu" > <exec executable = "security-checker.phar" outputProperty = "output" checkreturn = "true" > <arg value = "security:check" /> <arg path = "./composer.lock" /> </exec > <echo message = "output: ${output}" /> </target > </project >

et mon execution devient:

~ / blog$ phing.phar -f .. / jenkinsbuildconf / checksecu.xml Buildfile: / home / ulrich / blog / .. / jenkinsbuildconf / checksecu.xml checksecu > secu: Execution of target "secu" failed for the following reason: / home / ulrich / blog / .. / jenkinsbuildconf / checksecu.xml: 6 : 60 : Task exited with code 1 BUILD FAILED / home / ulrich / blog / .. / jenkinsbuildconf / checksecu.xml: 6 : 60 : Task exited with code 1 Total time: 0.9041 seconds

Super mon build failed, mais je n'ai pas la sortie de security-checker.phar ce qui est embettant. Je vais donc remplacer checkreturn par returnProperty pour stocker dans une variable l'exit code de la commande puis le tester avec un if.

<project name = "checksecu" basedir = "." default = "secu" > <target name = "secu" > <exec executable = "security-checker.phar" outputProperty = "output" returnProperty = "return" > <arg value = "security:check" /> <arg path = "./composer.lock" /> </exec > <if > <equals arg1 = "${return}" arg2 = "1" /> <then > <echo message = "output: ${output}" /> <fail message = "Le composer.lock montre que le projet se base sur des libs ayant des CVE." /> </then > </if > </target > </project >

Ce qui me donne à l'exécution:

~ / blog$ phing.phar -f .. / jenkinsbuildconf / checksecu.xml Buildfile: / home / ulrich / blog / .. / jenkinsbuildconf / checksecu.xml checksecu > secu: [ echo ] output: Security Check Report ~~~~~~~~~~~~~~~~~~~~~ Checked file: / home / ulrich / blog / composer.lock [ CRITICAL ] 3 packages have known vulnerabilities doctrine / doctrine-bundle ( v1.2.0 ) --------------------------------- * CVE- 2015 - 5723 : Security Misconfiguration Vulnerability in various Doctrine projects http: // www.doctrine-project.org / 2015 / 08 / 31 / security_misconfiguration_vulnerability_in_various_doctrine_projects.html doctrine / orm ( v2.3.6 ) --------------------- * CVE- 2015 - 5723 : Security Misconfiguration Vulnerability in various Doctrine projects http: // www.doctrine-project.org / 2015 / 08 / 31 / security_misconfiguration_vulnerability_in_various_doctrine_projects.html zendframework / zend-json ( 2.2.1 ) ------------------------------- * Potential XXE / XEE attacks using PHP functions: simplexml_load_ * , DOMDocument::loadXML, and xml_parse http: // framework.zend.com / security / advisory / ZF2014-01 This checker can only detect vulnerabilities that are referenced Disclaimer in the SensioLabs security advisories database. Execute this command regularly to check the newly discovered vulnerabilities. Execution of target "secu" failed for the following reason: / home / ulrich / blog / .. / jenkinsbuildconf / checksecu.xml: 11 : 12 : / home / ulrich / blog / .. / jenkinsbuildconf / checksecu.xml: 15 : 30 : Le composer.lock montre que le projet se base sur des libs ayant des CVE. BUILD FAILED / home / ulrich / blog / .. / jenkinsbuildconf / checksecu.xml: 11 : 12 : / home / ulrich / blog / .. / jenkinsbuildconf / checksecu.xml: 15 : 30 : Le composer.lock montre que le projet se base sur des libs ayant des CVE. Total time: 0.4784 seconds

Et voilà! Il ne me reste plus qu'a ajouter cette tâche dans mon build général de phing pour que Jenkins teste systèmatiquement si mon projet se base sur une version ayant une CVE connue. Pour ceux qui prèfere Ant à Phing, je pense que cette tache peut être très facilement transposable si pas réutilisable tel quel.





Si vous utilisez Ant plutôt que Phing, voici la code de la tache que vous pouvez ajouter à votre fichier de build:

<target name = "checks:security" description = "Checks if there is some security issues in our back-end dependencies" > <exec executable = "security-checker.phar" failonerror = "true" > <arg line = "security:check composer.lock" /> </exec > </target >





Si vous utilisez Pipeline dans Jenkins, voici la déclaration de mon Jenkinsfile:



stage ( 'Check Security' ) { steps { sh 'security-checker.phar security:check composer.lock' } }







