composer audit gehört in die Pipeline: der blinde Fleck im vendor-Ordner

Bei einer Übernahme wird der eigene Code geprüft, der vendor-Ordner nicht. Dabei steckt dort das größte Risiko: bekannte Sicherheitslücken in alten Abhängigkeiten, die niemand verfolgt. composer audit macht sie sichtbar, und erst in der CI wird daraus ein verlässliches Netz. Warum der Befehl auf jeden Push und zusätzlich auf einen Zeitplan gehört.

20. November 2026 8 min · 1.469 Wörter

Bei einer Übernahme wird der Code geprüft, gelesen und irgendwann getestet. Der vendor-Ordner nicht. Dabei steckt dort der größte Teil dessen, was in Produktion tatsächlich läuft, und er ist der blinde Fleck fast jeder gewachsenen Anwendung. Ein bekanntes Sicherheitsleck in einer alten Abhängigkeit ist eine offene Tür, an der jahrelang niemand vorbeischaut, weil der eigene Code ja in Ordnung ist.

Das Unangenehme daran: Diese Tür geht auf, ohne dass irgendjemand etwas tut. Der Code bleibt unverändert, die Abhängigkeit bleibt unverändert, und trotzdem wird aus einer gestern noch harmlosen Bibliothek heute eine Lücke, einfach weil jemand die Schwachstelle gefunden und veröffentlicht hat. Genau deshalb reicht ein einmaliger Blick nicht. Man braucht etwas, das dauerhaft hinschaut.

Was composer audit tut

Seit Composer 2.4 gibt es dafür einen eingebauten Befehl:

composer audit

Er nimmt die installierten Pakete mit ihren Versionen, mit --locked den Stand aus dem Lockfile, und gleicht sie gegen die Security-Advisory-Datenbank von Packagist ab. Die speist sich aus den GitHub Security Advisories und dem Repository FriendsOfPHP/security-advisories. Für jeden Treffer bekomme ich den Paketnamen, die Advisory-ID, eine CVE-Kennung, sofern eine vergeben ist, einen Titel, den Link zur Meldung und die betroffenen Versionsbereiche. Ich brauche dafür keinen Account und keinen zusätzlichen Dienst, nur Netzzugriff auf Packagist. Ein Befehl, und ich sehe, welche meiner Abhängigkeiten eine bekannte Lücke haben.

Das Entscheidende für die Automatisierung: Der Befehl beendet sich mit einem Exit-Code ungleich null, sobald er eine Advisory findet. Das klingt nach einem Detail, ist aber der ganze Hebel. Ein Exit-Code ungleich null lässt eine Pipeline rot werden, und damit wird aus einer Information, die man sich holen müsste, eine, die sich von selbst meldet.

Warum manuell nicht reicht

Die ehrliche Wahrheit über manuelle Sicherheitschecks ist, dass sie nicht stattfinden. Nicht weil die Leute nachlässig wären, sondern weil es nie der richtige Moment ist. Im Sprint ist dafür kein Platz vorgesehen, und von außen sieht man der Anwendung nichts an. Ein Befehl, den man gelegentlich von Hand laufen lässt, läuft in der Praxis genau einmal, am Tag der Einrichtung.

In der CI dreht sich das um. Dort läuft composer audit bei jedem Push mit und kostet niemanden einen Gedanken. Aber der wichtigere Teil ist der zweite: ein zusätzlicher Lauf nach Zeitplan, einmal pro Nacht. Denn die gefährlichste Lücke ist nicht die, die ich mit einer Änderung einbaue. Es ist die, die über Nacht in einer Abhängigkeit auftaucht, die ich seit Monaten nicht angefasst habe. Der nächtliche Lauf prüft genau diesen Fall: Code unverändert, trotzdem eine neue Meldung, weil die Advisory erst gestern veröffentlicht wurde. Ohne den Zeitplan erfahre ich davon erst beim nächsten Deployment, und das kann Wochen dauern.

Ein Einwand kommt an der Stelle oft: Composer passt doch inzwischen selbst auf. Das stimmt zum Teil. Seit Version 2.9 weigert sich Composer bei composer update, composer require und composer remove, eine Version mit bekannter Advisory überhaupt auszuwählen. Dieser Schutz greift aber nur in dem Moment, in dem Abhängigkeiten neu aufgelöst werden. Ein composer install aus einem bestehenden Lockfile installiert, was dort steht, auch wenn für genau diese Version gestern eine Advisory erschienen ist. Und in den Phasen, in denen niemand an den Abhängigkeiten arbeitet, wird gar nichts neu aufgelöst. Den Bestand überwacht nur der Audit.

Wie der Schritt aussieht

In der Pipeline ist es ein einzelner Schritt. Im einfachsten Fall:

composer audit --locked --no-dev

Mit --locked prüft der Befehl den Stand aus der composer.lock und braucht dafür keinen installierten vendor-Ordner. Das ist genau der Stand, den das nächste Deployment installiert. Das --no-dev nimmt die reinen Entwicklungs-Abhängigkeiten heraus, die gar nicht in Produktion landen. Eine Lücke in einem Test- oder Debug-Paket ist unangenehm, aber sie läuft nicht auf dem Server. Für den Produktions-Blick schaue ich zuerst auf das, was wirklich ausgeliefert wird, und kümmere mich um die Dev-Abhängigkeiten in einem zweiten, weniger scharfen Schritt. Wie man eine erste Pipeline in eine Anwendung ohne jede CI einzieht, habe ich am Laravel-Fall beschrieben. Der Audit ist eine der ersten Stufen, die dort dazukommt.

Was tue ich mit einem Treffer? Meistens reicht ein gezieltes Update der betroffenen Abhängigkeit auf die gepatchte Version, oft nur ein Patch- oder Minor-Sprung. Manchmal hält ein zu enger Constraint in der composer.json das Update auf, und dann ist der Treffer zugleich der Hinweis, dass dieser Constraint überfällig ist. Für die Weiterverarbeitung gibt es --format=json, womit sich die Ausgabe in einen Report oder ein Dashboard hängen lässt, statt sie nur im Log zu lesen.

Den nächtlichen Lauf hängt man an einen Zeitplan der CI, nicht an einen Push. GitHub Actions kann das über einen schedule-Trigger, GitLab über eine geplante Pipeline. Derselbe Befehl, nur eben zeitgesteuert statt ereignisgesteuert.

Ein Wort zu roave/security-advisories, weil das Paket in übernommenen Projekten oft noch in der composer.json steht. Es hat lange dafür gesorgt, dass bekannt verwundbare Versionen gar nicht erst installiert werden konnten. Diese Aufgabe erledigt Composer seit 2.9 selbst, und laut der Release-Ankündigung zu Composer 2.9 kann das Paket dann entfallen. Läuft im Projekt oder in der CI noch ein älteres Composer, behält es seinen Zweck. An der Arbeitsteilung ändert das nichts: Die Sperre beim Auflösen hält Neues draußen, der Audit überwacht den Bestand.

Der erste Lauf bei einer Übernahme

Bei einer frisch übernommenen Anwendung ist der erste composer audit selten grün. Abhängigkeiten, die Jahre zurückliegen, sammeln bekannte Lücken an, und die ganze Liste auf einmal kann erschlagend wirken. Das ist dieselbe Situation wie bei der statischen Analyse, über die ich im PHPStan-Beitrag geschrieben habe, und ich gehe sie ähnlich an.

Zuerst sortiere ich nach Schwere. Eine kritische Lücke in einer Bibliothek, die Nutzereingaben verarbeitet, ist etwas anderes als eine Randnotiz in einem Paket, das nur im Build läuft. Die kritischen Treffer werden sofort angegangen, meist durch ein gezieltes Update der betroffenen Abhängigkeit. Was sich nicht sofort lösen lässt, weil ein Update andere Teile mitzieht, wird bewusst und mit Begründung dokumentiert, statt stillschweigend ignoriert zu werden. Einzelne Advisories lassen sich dafür in der composer.json gezielt ausnehmen, mit der Begründung direkt daneben:

{
    "config": {
        "policy": {
            "advisories": {
                "ignore-id": {
                    "CVE-1234": "Betroffene Komponente wird nicht genutzt, Update mit dem Framework-Upgrade geplant"
                }
            }
        }
    }
}

So sieht das ab Composer 2.10 aus. Die Kennung ist ein Platzhalter und kann eine CVE-, GHSA- oder PKSA-ID sein. Bis 2.9 steht dieselbe Zuordnung unter config.audit.ignore.

Dazu kommt bei alten Anwendungen meist eine zweite Liste: Pakete, die ihr Autor als abandoned markiert hat. Seit Composer 2.7 lässt schon ein solches Paket den Audit fehlschlagen. Ein abandoned-Paket ist ein Warnsignal und gehört auf die Liste für später, eine Sicherheitslücke ist es deshalb noch nicht. Für den Anfang stelle ich das Verhalten in der Composer-Konfiguration auf report (bis 2.9 audit.abandoned, ab 2.10 im Abschnitt policy), damit die Pipeline nur wegen echter Advisories rot wird. Um den Ersatz dieser Pakete kümmere ich mich getrennt.

Erst wenn die Liste auf einem ehrlichen Stand ist, schalte ich den Schritt scharf, sodass ab dann jede neue Meldung die Pipeline stoppt.

Stolperfallen

Keine Meldung heißt nicht sicher. composer audit kennt nur, was in der Advisory-Datenbank steht. Eine Lücke, die noch niemand gemeldet hat, taucht nicht auf. Ein grüner Audit sagt also nicht, dass die Anwendung sicher ist, sondern nur, dass keine der öffentlich bekannten Lücken auf die installierten Versionen passt. Das ist viel wert, aber es ist keine Unbedenklichkeitsbescheinigung.

Den Schritt bei einer Übernahme sofort scharf schalten. Wer bei einer alten Codebase den Audit am ersten Tag blockierend macht, legt die Pipeline lahm, bevor überhaupt jemand die Treffer sortiert hat. Dann wird der Schritt entnervt wieder entfernt, und das Netz ist weg. Erst sichten und die kritischen Dinge lösen, dann scharf schalten.

Nur bei Code-Änderungen prüfen. Wer composer audit allein an den Push hängt und den Zeitplan weglässt, verpasst genau die Lücken, die ohne eigenes Zutun entstehen. Der nächtliche Lauf ist nicht die Kür, er ist der eigentliche Grund, warum der Audit in die CI gehört.


Die Abhängigkeiten sind bei fast jeder Übernahme der unterschätzte Teil. Der eigene Code bekommt Aufmerksamkeit, der vendor-Ordner läuft mit und wird erst zum Thema, wenn es zu spät ist. Ein Audit in der Pipeline dreht das um, mit überschaubarem Aufwand. Wenn Sie wissen wollen, wie es um die Abhängigkeiten Ihrer Anwendung steht und wie man den Bestand sauber unter Kontrolle bekommt, schildern Sie mir kurz Ihre Ausgangslage. Ich melde mich mit einer ersten Einschätzung. Termin buchen.