Nicht gepatchte Versionen von Python

Tools dürfen dieses PEP ignorieren, wenn sie auf Python ohne tarfile-Filter laufen.

Das Feature wurde für alle von python.org unterstützten Python-Versionen zurückportiert. Das Einbinden in Drittanbieter-Bibliotheken ist schwierig, und wir sollten nicht alle Tools dazu zwingen. Dies verlagert die Verantwortung für die Aktualisierung der Sicherheit von den Tools auf die Benutzer.

Berechtigungen

Gängige Tools (git, zip) bewahren keine Unix-Berechtigungen (Mode-Bits). Nutzern zu sagen, dass sie sich in sdists nicht darauf verlassen sollen, und Tools die Handhabung relativ frei zu überlassen, erscheint fair.

Die einzige Ausnahme ist die ausführbare Berechtigung. Wir empfehlen, aber verlangen nicht, dass Tools diese beibehalten. Da Skripte im Allgemeinen plattformspezifisch sind, scheint es passend zu sagen, dass ihre Ausführbarkeit ein Tool-spezifisches Verhalten ist.

Beachten Sie, dass git die Ausführbarkeit beibehält, während zip (und damit wheel) dies nicht nativ tut. (Es ist möglich, dies in „externe Attribute“ zu kodieren, aber Pythons ZipFile.extract berücksichtigt dies nicht.)

Entpacken mit dem Datenfilter

Beim Extrahieren einer Quell-Distribution müssen Tools entweder tarfile.data_filter verwenden (z.B. TarFile.extractall(..., filter='data')) ODER dem Abschnitt Unpacking without the data filter unten folgen.

Als Ausnahme, auf Python-Interpretern ohne hasattr(tarfile, 'data_filter') (PEP 706), dürfen Tools, die diesen Filter normalerweise verwenden (direkt oder indirekt), den Benutzer warnen und diese Spezifikation ignorieren. Der Kompromiss zwischen Benutzerfreundlichkeit (z.B. vollständiges Vertrauen in das Archiv) und Sicherheit (z.B. Ablehnung des Entpackens) liegt in diesem Fall beim Tool.

Entpacken ohne den Datenfilter

Tools, die den data-Filter nicht direkt verwenden (z.B. aus Gründen der Rückwärtskompatibilität, um zusätzliche Features zu erlauben, oder weil sie kein Python verwenden), MÜSSEN diesem Abschnitt folgen. (Zum Zeitpunkt der Erstellung folgt der data-Filter ebenfalls diesem Abschnitt, aber er könnte zukünftig davon abweichen.)

Die folgenden Dateien sind in einem sdist-Archiv ungültig. Bei der Begegnung mit einem solchen Eintrag SOLLTEN Tools den Benutzer benachrichtigen, den Eintrag NICHT entpacken und KÖNNEN mit einem Fehler abbrechen.

• Dateien, die außerhalb des Zielverzeichnisses platziert würden.
• Links (symbolisch oder hart), die außerhalb des Zielverzeichnisses zeigen.
• Gerätedateien (einschließlich Pipes).

Die folgenden sind ebenfalls ungültig. Tools KÖNNEN sie wie oben behandeln, sind aber NICHT dazu VERPFLICHTET.

• Dateien mit einer ..-Komponente im Dateinamen oder Linkziel.
• Links, die auf eine Datei zeigen, die nicht Teil des Archivs ist.

Tools KÖNNEN Links (symbolisch oder hart) als normale Dateien entpacken, wobei der Inhalt aus dem Archiv verwendet wird.

Beim Extrahieren von sdist-Archiven

• Führende Schrägstriche in Dateinamen MÜSSEN entfernt werden. (Dies ist heutzutage das Standardverhalten für tar-Entpackung.)
• Für jedes mode (Unix-Berechtigung) Bit müssen Tools entweder
  • die plattformspezifischen Standardwerte für eine neue Datei/Verzeichnis (bzw.) verwenden,
  • das Bit gemäß dem Archiv setzen, oder
  • das Bit von rw-r--r-- (0o644) für nicht ausführbare Dateien oder rwxr-xr-x (0o755) für ausführbare Dateien und Verzeichnisse verwenden.
• Hohe mode-Bits (setuid, setgid, sticky) MÜSSEN gelöscht werden.
• Es wird EMPFOHLEN, das Benutzer-ausführbar-Bit beizubehalten.

Weitere Hinweise

Tool-Autoren werden ermutigt, zu überlegen, wie die Hinweise für weitere Verifizierung in der Dokumentation von tarfile für ihr Tool gelten.