YAML (YAML Ain't Markup Language) ist eine benutzerfreundliche, sprachübergreifende Datenserialisierungssprache, die häufig für Konfigurationsdateien verwendet wird und Daten als Zuordnungen, Sequenzen und Skalare darstellt. Version 1.2 machte YAML zu einem strengen Superset von JSON. In der Proxy- und Scraping-Arbeit erscheint YAML in Konfigurationsdateien. Zum Beispiel ist die statische Konfiguration des Envoy-Proxys in YAML geschrieben und definiert die Listener und Cluster, durch die der Datenverkehr fließt.

YAML-Syntax Grundlagen

  • Zuordnungen: key: value Paare, wie Wörterbücher oder Hashes.
  • Sequenzen: Listen, wobei jedes Element in einer eigenen Zeile beginnt mit -.
  • Einrückung: Im Blockstil bestimmt die Einrückung die Struktur, sodass ein fehlplatzierter Raum die Bedeutung der Daten ändert.
  • Keine Tabs: Tabulatorzeichen dürfen nicht zur Einrückung verwendet werden.
  • Kommentare: Ein # beginnt einen Kommentar.

YAML sicher in Scraper- und Proxy-Konfigurationen verwenden

YAML-Parser können mehr als nur einfache Daten lesen. Die PyYAML-Dokumentation warnt, dass das Aufrufen von yaml.load mit Daten aus einer nicht vertrauenswürdigen Quelle nicht sicher ist, da es beliebige Python-Objekte konstruieren kann. Seine yaml.safe_load-Funktion erkennt nur Standard-YAML-Tags, was es zur dokumentierten Wahl für nicht vertrauenswürdige Eingaben macht.

Mehrzeilige Strings, Anker und mehrere Dokumente

  • Wörtlicher Block (|): Beibehaltung jedes Zeilenumbruchs in einem mehrzeiligen String.
  • Gefalteter Block (>): Wandelt jeden Zeilenumbruch in ein Leerzeichen um, außer vor leeren oder stärker eingerückten Zeilen.
  • Anker und Aliase: &name kennzeichnet einen Knoten, und *name verwendet ihn später wieder, anstatt ihn zu wiederholen.
  • Mehrere Dokumente: --- kennzeichnet den Beginn des Inhalts eines Dokuments, sodass ein Stream mehrere Dokumente enthalten kann. ... beendet ein Dokument, ohne ein neues zu beginnen.

Verwandte Begriffe