/*---About-----------------------------------------------------------*/ Dokumentation zur opencrack API. Author: hashkiller Datum: 2008.08.27 Letzte Änderung: 2008.09.19 A english translation is available with Google-Translate: http://translate.google.de/translate?u=http%3A%2F%2Fhashkiller.com%2Fapi%2Fopencrack.txt&sl=de&sl=en&tl=en /*---Vorwort---------------------------------------------------------*/ Die API ist per HTTP zu erreichen unter: http://hashkiller.com/api/opencrack.php Rückgabewerte sind XML Daten oder, falls angefordert, eine reine MD5 Liste. /*---Aktionen--------------------------------------------------------*/ - Aktionen GET action Es gibt 2 Aktionen: download und upload. Wenn keine Aktion angegeben kommt der Fehler: "Action is invalid" /*---Aktionen-Download-----------------------------------------------*/ Wenn keine Fehler auftreten wird eine MD5-Liste als Text gesendet. Die MD5 sind per Zeilenumbruch (\n) getrennt. Ohne weitere Paramater werden alle MD5 des aktuellen Tages ausgegeben. Bei der Aktion download gibt es folgende optionale Paramater: GET date=20080102 Mit dem date Paramater lässt sich der Tag bestimmen von dem die MD5-liste stammen soll. Wenn nicht angegeben, wird der aktuelle Tag gewählt. Das Datum muss in folgendem Format sein YYYYMMDD anderenfalls kommt der Fehler: "Date is invalid" Wenn keine MD5 für den Tag in der Datenbank sind, kommt folgender Fehler: "No MD5 available" GET tstart=1219827600 tstart = Timestamp Start Hier lässt sich die Startzeit (Unix Timestamp) definieren ab der die MD5 in die Liste sollen. Es lässt sich nur die Startzeit des aktuellen Tages beeinflussen. Mit tstart und tend lässt sich NICHT über mehrere Tage eine Liste bilden. Wenn der Timestamp fehlerhaft ist kommt dieser Fehler: "Timestamp start is invalid / too small" GET tend=1219831200 tend = Timestamp End Siehe tstart nur als Endzeit. GET hstart=12 hstart = Hour Start Diese vereinfachte Angabe lässt die Liste ab 12:00:00 Uhr beginnen und überschreibt den Wert von tstart! Der Wert kann zwischen 0 bis 23 liegen. Dieser Paramater erzeugt keine Fehlermeldung. GET hend=13 hend = Hour End Diese vereinfachte Angabe lässt die Liste mit 13:59:59 Uhr beginnen und überschreibt den Wert von tend! Der Wert kann zwischen 0 bis 23 liegen. Dieser Paramater erzeugt keine Fehlermeldung. GET mode=john Dieser Modus ist optional. Da John the Ripper eine USER:MD5 Liste erwartet gibt dieser Modus die MD5 mit einer fortlaufenden Zahl als Username ausgehend vom aktuellen Timestamp zurück. /*---Aktionen-Upload-------------------------------------------------*/ Mit dieser Aktion lassen sich die gecrackten MD5 wieder hochladen. Sie ist nicht an Datum, Uhrzeit oder Timestamps gebunden, es wird ganz simpel jeder Eintrag der Liste mit der OpenCrack Liste abgeglichen. Bei der Aktion upload gibt es folgende Paramater: POST list Dieser Paramater ist NICHT optional. Mit ihm lässt sich eine MD5:PASS Liste hochladen und mit der OpenCrack Warteschlange abgleichen. Es wird per default eine MD5:PASS Liste erwartet. Zeilenumbruch kann sowohl \n als auch \r\n sein. Als Rückgabewerte gibt es: total = Anzahl der MD5 welcher in der Liste gefunden wurden. success = Anzahl der MD5 welche erfolgreich beim Abgleichen mit der Liste gefunden wurden. Beispiel: total = 10 ; success = 3 Es wurden in der Liste 10 MD5:PASS Paare gefunden von denen 3 noch nicht in der OpenCrack Liste gecrackt wurden. Fehlermeldung: "List is empty" GET type Dieser Paramater ist optional, default ist: "md5:pass" Folgende Werte sind erlaubt: "md5:pass" und "pass". Dieser Paramater bestimmt die Form der hochgeladenen Liste. Neu ist "cain", bei diesem Typ kann man die Liste in folgenden Formaten hochladen: Cain direct output: "Plaintext of MD5 is PLAIN". Cain MD5.LST old version: "MD5;PLAIN;". Cain MD5.LST new version: "MD5 PLAIN" (the space is 2xTAB). GET userhash Dieser Paramater ist optional. Er bestimmt wer als Cracker des MD5 bestimmt wird. Deinen persöhnlichen Userhash kannst du unter Profil->Benutzerkonto einsehen und ändern. Ein Userhash besteht aus 30 Zeichen 0-9a-z. Wenn kein Userhash angegeben wird, wird als Cracker "Anonymous" eingetragen. GET single Dieser Paramater ist optional. Er überschreibt den Wert von POST list! Er hat die gleichen Rückgabewerte und Fehlermeldungen wie POST list. Dieser Paramater ist zum abgleichen EINZENER MD5 gedacht. Performancetechnisch sollte immer der POST list Paramater bevorzugt werden. /*---Ende------------------------------------------------------------*/ Ende der Dokumentation von OpenCrack