1 files changed, 63 insertions, 0 deletions

diff --git a/iv/orodja/napad/README.md b/iv/orodja/napad/README.md
new file mode 100644
index 0000000..01fb06e
--- /dev/null
+++ b/iv/orodja/napad/README.md
@@ -0,0 +1,63 @@
+napad
+=====
+
+Preprosto rezervno orodje za napadanje na A/D tekmovanjih. To so navodila za uporabo.
+
+Sistem exploitov ne poganja na centralni lokaciji. Ločen je torej na dva dela, del na strežniku za oddajo zastavic (submission.py) in preprost webui monitoring (nadzor.py), in del, ki poganja exploit skript in oddaja strežniškemu delu zastavice in z njimi dodatne metapodatke (exploit.sh).
+
+Za administratorja ekipne infrastrukture
+----------------------------------------
+
+Na strežniku tečeta dva programa, submission.py in nadzor.py.
+
+### Konfiguracija
+
+Konfiguracijsko datoteko generiramo s skriptom genconfig.sh, njen stdout pošljemo v datoteko config. Celotna konfiguracija je v okolju procesa (environment), bodisi exploit.sh bodisi submission.py. S sourcanjem datoteke v lupini (source config) namestimo konfiguracijo.
+
+Generirano konfiguracijsko datoteko se nekam shrani in v .bashrc doda vrstico "source pot/do/config". Pošlje se jo tudi tekmovalcem. Ista je za strežniški in napadalni del.
+
+### submission.py
+
+Poženemo ./submission.py. Posluša na TCP vratih, kot je določeno v konfiguraciji. Če zanemarimo DoS vstavljanje flagov (kar je zoprno), je mišljeno, da preko tega TCP ne moremo krasti zastavic iz baze ali jih brisati.
+
+Skript za zaganjanje exploitov bo na ta TCP vrata pošiljal ukradene zastavice.
+
+Vse dobljene zastavice in metapodatke hrani v sqlite3 podatkovno zbirko.
+
+### nadzor.py
+
+Preprost spletni vmesnik. Omogoča prenos HTML datoteke (GET /) in izvajanje poljubnih SQL ukazov na zbriko (POST /sql). Kdor ima dostop do spletnega vmesnika, lahko briše zastavice in jih krade iz zbirke.
+
+Na vmesniku je dostopna neka read-only statistika, ki se sproti osvežuje (hiter pregled) in polje za izvajanje SQL ukazov.
+
+Za ostale tekmovalce v ekipi
+----------------------------
+
+### Namestitev
+
+Prenesite si konfiguracijsko datoteko config, ki vam jo generira administrator ter poskrbite, da se v vaši lupini samodejno "sourca", s čimer se nastavijo konfiguracijske spremenljivke v okolje.
+
+`wget -O ~/.config/napad.config http://k.4a.si/config`
+`echo source ~/.config/napad.conf >> ~/.bashrc`
+
+Nato prenesemo exploit.sh na neko mesto, ki je v PATHu.
+
+`wget -O ~/.local/bin/ http://k.4a.si/exploit.sh`
+`chmod +x ~/.local/bin/exploit.sh`
+
+Namestiti je treba še program `curl`, saj se uporablja za vleko flagidjev.
+
+### Pisanje exploitov
+
+
+Exploiti delujejo enako kot pri ataki, le brez docker containerjev. Primer exploita je v template.py. Exploit dobi target IP v okoljski spremenljivki `TARGET_IP` in flag ids v `TARGET_EXTRA` kot json objekt. Exploit naj flage zapiše v stdout, lahko pa seveda poleg flagov piše še kaj drugega, flagi pa bodo izluščeni iz njegovega izhoda.
+
+Dodatne opcije exploit.sh in seznam servicov dobimo z ukazom `exploit.sh` (brez argumentov).
+
+Exploit testiramo na eni ekipi na trenutni rundi z ukazom `exploit.sh once servicename ./naš_exploit.py 24`, kjer je 24 opcijski argument --- številka ekipe, ki jo želimo napasti, privzeto je to ekipa NOP.
+
+Ko smo zadovoljni z exploitom, ga poženemo v "loop" načinu, torej poganjamo ga v zanki do konca igre, enkrat na vsako rundo z ukazom `exploit.sh loop servicename ./naš_exploit.py`. Če se kaj zalomi (neuspela povezava na submission, exploit je crknil z neničelno kodo), dobimo sporočilo na terminal in **desktop obvestilo**.
+
+Če je le možno, inštalirajte program `parallel` (GNU parallel). Brez njega se bodo exploiti izvajali zaporedno, z njim pa sočasno! Poleg tega bo parallel še rdeče obarval izhod na terminal, ko se zgodi napaka.
+
+Za vsako rundo in za vsako ekipo program na terminal izpiše, koliko zastavic je pobral.