oryxlabs/polardnsPolarDNS ist ein spezialisierter autoritativer DNS-Server, der sich für Penetrationstests und Sicherheitsforschung eignet.
PolarDNS ist ein spezialisierter autoritativer DNS-Server, geschrieben in Python 3.x, ursprünglich entwickelt als Werkzeug für Sicherheitstests von rekursiven DNS-Resolvern von der Serverseite aus.
_
PolarDNS kann getestet werden für:
Es unterstützt sowohl UDP- als auch TCP-Protokolle und gibt dem Betreiber die vollständige Kontrolle über die DNS-Protokollebene.
Der PolarDNS-Server kann eine Vielzahl von nicht standardmäßigen und nicht konformen DNS-Antworten erzeugen, DNS-Antworten, die gegen die RFC-Spezifikationen verstoßen, einschließlich stark abnormaler und fehlerhafter DNS-Antworten.
Dies kann nützlich sein für:
Es gibt drei verfügbare Methoden, um PolarDNS zu installieren.
PolarDNS benötigt Python 3.11 oder neuer und hat keine zusätzlichen Abhängigkeiten.
Dies ist der einfachste Weg, PolarDNS zu installieren und auszuführen:
pip install polardns
polardns
Sie können auch das Repository klonen und PolarDNS direkt ausführen:
git clone https://github.com/oryxlabs/PolarDNS.git
cd PolarDNS
python polardns.py
Diese Methode wird empfohlen, wenn Sie vorhaben, den Code zu debuggen oder zu modifizieren oder neue Funktionen hinzuzufügen.
Sie können PolarDNS auch in einem Docker-Container ausführen:
docker run -p 53:53/tcp -p 53:53/udp oryxlabs/polardns
Der PolarDNS-Server ist über die Konfigurationsdatei polardns/polardns.toml konfigurierbar.
Nach dem Start von PolarDNS sollten Sie eine Ausgabe ähnlich der folgenden sehen:
python polardns.py
1741599804.9039893 | PolarDNS v1.6.1 server starting up
1741599804.9039893 | Using '/path/to/your/polardns/polardns.toml' config file
1741599804.9039893 | Starting listener at tcp://0.0.0.0:53
1741599804.9039893 | Starting listener at udp://0.0.0.0:53
Dies zeigt an, dass der Server läuft und bereit ist.
Standardmäßig beginnt der Server auf allen Schnittstellen auf UDP- und TCP-Port 53 (0.0.0.0:53) zu lauschen und ist bereit, DNS-Anfragen zu beantworten.
Sie können ihn lokal testen, indem Sie die folgende Beispielabfrage stellen, die immer etwas auflösen sollte.
Abfrage im UDP-Modus:
dig always.yourdomain.com @127.0.0.1
Abfrage im TCP-Modus:
dig always.yourdomain.com @127.0.0.1 +tcp
Sie sollten einen A-Eintrag mit der IP-Adresse 2.3.4.5 erhalten, ähnlich wie in diesem Screenshot:
Dies zeigt an, dass der Server ordnungsgemäß funktioniert.
Indem Sie den PolarDNS-Server bitten, etwas aufzulösen, geben Sie ihm im Wesentlichen Anweisungen, wie er auf Sie antworten soll. Das bedeutet, dass Sie (der Client) dem PolarDNS-Server vorgeben, welche Art von Antwort er für Sie erzeugen soll.
Betrachten Sie zum Beispiel die folgende Abfrage:
dig always.ttl2000000000.slp1500.yourdomain.com @127.0.0.1
Sie sollten wieder einen A-Eintrag mit der IP-Adresse 2.3.4.5 erhalten, aber diesmal mit einem TTL-Wert von 2.000.000.000 (63,4 Jahre) und nach einer Verzögerung von 1,5 Sekunden:
Im obigen Beispiel haben wir das grundlegende Feature always verwendet (das immer etwas auflöst) und es mit dem Modifikator ttl kombiniert, um den TTL-Wert anzupassen, sowie mit dem Modifikator slp, um vor dem Senden der Antwort zu warten.
PolarDNS hat die folgenden Hauptfunktionalitäten:
Es gibt derzeit über 70 verschiedene Features und 19 Antwortmodifikatoren. Durch die Verwendung verschiedener Features und deren Kombination mit verschiedenen Antwortmodifikatoren ist es möglich, unzählige Varianten einer bestimmten Antwort zu erzeugen.
Siehe den beigefügten Katalog aller implementierten Features und Antwortmodifikatoren.
Dies gibt PolarDNS die Fähigkeit, hochgradig ungewöhnliche, abnormale und sogar fehlerhafte DNS-Antworten zu erzeugen, sodass der Betreiber sehen kann, wie die empfangende Seite mit solchen Situationen umgeht und ob die empfangende Seite technisch robust und ausgereift ist.
Einige Beispiele für DNS-Antworten, die PolarDNS erzeugen kann, umfassen:
Diese können zur Entdeckung verschiedener Schwachstellen führen, wie:
Siehe die BlackHat MEA 2023-Präsentationen (einschließlich BONUS-Folien) für weitere Details, viele weitere Beispiele und Anwendungsfälle.
Hier ist ein Überblick auf hoher Ebene, was Sie benötigen, um mit dem Testen rekursiver DNS-Server zu beginnen.
example123.com, über Ihren bevorzugten Domain-Registrar.polardns/polardns.toml auf jeder Instanz und ändern Sie Ihren Domainnamen und Ihre Nameserver-IP-Adressen entsprechend – gleiche Konfiguration auf beiden.Jetzt sollte Ihre Infrastruktur bereit sein, um jeden rekursiven DNS-Resolver Ihrer Wahl zu testen.
Um mit dem Testen eines Ziel-DNS-rekursiven Resolvers zu beginnen, müssen Sie Ihre Abfragen an den Ziel-DNS-Resolver richten, z. B.
dig always.example123.com @<TARGET-RESOLVER-IP>
Zum Beispiel, um den öffentlichen DNS von CloudFlare zu testen:
dig always.example123.com @1.1.1.1
Während der Auflösung kontaktiert der Ziel-DNS-Resolver Ihre autoritativen PolarDNS-Nameserver (die Ihre example123.com-Testdomain verwalten), um die Abfrage aufzulösen.
Einer Ihrer PolarDNS-Server wird dem Ziel-DNS-Resolver antworten. Der Resolver erhält, parst und verarbeitet die Antwort von PolarDNS. Anschließend gibt er die endgültige Antwort an Sie (den Client) zurück.
Hier ist eine visuelle Übersicht des Testprozesses:
Indem Sie den DNS-Resolver anweisen, verschiedene Subdomains unter Ihrer example123.com-Domain aufzulösen, können Sie effektiv das Verhalten des DNS-Resolvers testen und sehen, wie er mit verschiedenen unerwarteten Situationen (Antworten) umgeht.
Zum Beispiel: Wie geht er mit einer Situation um, wenn er eine fehlerhafte DNS-Antwort, eine Antwort mit einem injizierten Eintrag oder einen Eintrag mit illegalen Zeichen erhält, und welche Art von Antwort sendet er letztendlich an Sie, den Client?
PolarDNS kann mit einer Vielzahl von DNS-Resolvern integriert werden, um eine umfassende End-to-End (E2E) DNS-Server-Testsuite auszuführen.
Diese Integration wird durch GitHub Actions ermöglicht, mit Referenzvorlagen (Workflows), die derzeit für die folgenden sechs DNS-Resolver verfügbar sind:
Wenn eine GitHub Action ausgelöst wird (z. B. bei einem Commit oder manuell), führen die Workflows die folgenden Schritte aus:
Um Ihre eigenen E2E-Tests hinzuzufügen, platzieren Sie sie einfach im Verzeichnis test-e2e/.
Auf der Suche nach einer vollständigen E2E-Testsuite für DNS-Server? Kontaktieren Sie [email protected].
Das Hinzufügen neuer Features zu PolarDNS ist entscheidend, um wirklich neuartige DNS-Probleme zu entdecken. Und mit PolarDNS können Sie das relativ einfach tun.
PolarDNS ermöglicht es Ihnen, schnell ein neues Feature hinzuzufügen, Ihre Ideen auszuprobieren oder einen PoC zu entwickeln, ohne Ihren eigenen DNS-Server bauen zu müssen. Alles, was Sie brauchen, ist die Fähigkeit, Python-Code zu verstehen, und die Neugier, mit dem DNS-Protokoll zu experimentieren.
Es gibt eine detaillierte, Schritt-für-Schritt-Beitragsrichtlinie, um Ihnen den Einstieg zu erleichtern. Dort finden Sie nicht nur, wie Sie neue Features hinzufügen, sondern auch, wie Sie PolarDNS debuggen, Probleme melden, Ideen teilen und mehr.
Hier sind einige hervorragende Ressourcen, die nützlich sind, wenn Sie mit PolarDNS spielen.
DNS-Protokollbezogene Links:
DNS-Server:
Vielen Dank an alle, die zu PolarDNS beigetragen haben! ❤️