binfinder

Findet Binärdateien, die nicht über den Paketmanager installiert wurden

Voraussetzungen

Software

• go-Version >= 1.12
• docker-Version >= 19

Binfinder erstellen und ausführen

Build

$ make build

Sobald der Build abgeschlossen ist, können Sie binfinder mit folgendem Befehl ausführen:

$ ./binfinder --images <comma separated list of image> --output data --top 20

Die Ausgabe sind Diff-Dateien pro Image. Das top-Flag (Standardwert 0) zieht, wenn der Wert größer als 0 ist, die N beliebtesten Images heran, auf denen binfinder ausgeführt wird.

Um die Diff-Dateien zu analysieren, die nach dem Finden von Diffs erstellt wurden, können Sie die Analyse ausführen, um die Anzahl pro Diff über alle JSON-Dateien hinweg zu erhalten:

$ ./binfinder --analyze --output data

Die Ausgabe ist eine analysis.csv-Datei.

Um binfinder auf einer Registry auszuführen, übergeben Sie das Flag --registry host an die CLI:

$ ./binfinder --top=10 --registry=http://localhost:5000 --output data

Die CLI zieht Images aus dem Repository und prüft auf binäre Diff-Dateien.

Um binfinder auf einer DTR-Registry auszuführen, übergeben Sie das Flag --registry={HOSTNAME} --dtr --user={USER} --password={PASSWORD} an die CLI:

$ ./binfinder --top=10 --registry=https://vm01-7b86bb7b.westeurope.cloudapp.azure.com:8443 --dtr --user={user} --password={password} --output data

Die CLI zieht Images von DTR und prüft auf binäre Diff-Dateien.

Hinweise:

• Binfinder benötigt die Shell-Dateien alpine.sh, ubuntu.sh, centos.sh und centos_get_all_pkg.sh, um zu funktionieren. Diese Shell-Dateien müssen im Verzeichnis vorhanden sein, aus dem der Befehl ausgeführt wird.
• Ziehen Sie das Docker-Image vor der Ausführung von binfinder, um die Leistung zu verbessern.
• Busybox-basierte Images werden derzeit nicht unterstützt.