RBLDNS DNS-based blocklists management felhasználói kézikönyv (INTEGRITY Kft. 2013. 12. 9.)
Bevezető ismertetés Az RBLDNS rendszer a hagyományos DNS protokollra épülő rendszer, melyet elsősorban black és whitelisták kezelésére használnak. A spam elleni küzdelem kiemelt eszközének tekinthető, számos szolgáltató használja web- és levelezőszervereinek védelmére. A klasszikus DNS szoftverekhez képest, ahol közvetlenül a zónák (illetve alzónák) alá vehetünk fel rekordokat, egy új koncepciót vezet be, a dataseteket. A datasetek nem mások, mint olyan A rekordok gyűjteménye, amely rekordokban a név vagy egy IP cím, IP tartomány vagy egy hostnév, a rekordhoz tartozó DNS értelmezésben vett IP cím pedig egy tetszőleges, a dataset szintén megadott, jellemzően 127.X.X.X érték. Az, hogy egy adott datasetnél a válasz IP-nek mit állítunk be, egyedi elhatározás kérdése, maga a RBLDNS nem foglalkozik ennek tartalmával. Az ilyen módon használható A rekordok mellett TXT rekordokat is tudunk definiálni, ez szintén a dataset szintjén adható meg, és hasonló módon tetszőleges (akár dinamikus) értéket tartalmazhat. Ezt elsősorban arra tudjuk felhasználni, hogy szöveges információval tájékoztassuk a lekérdezőt, hogy egy adott bejegyzés miért szerepel a nyilvántartásunkban, illetve a dinamikus működésnek köszönhetően akár URL-eket is elhelyezhetünk így, az eredeti lekérdezés adatait is felhasználva. RBLDNS Webes kezelőfelülete Az INTEGRITY által működtetett RBLDNS rendszer webes felületét a spamdns.eu/rbl/ címen keresztül lehet elérni. Itt a bejelentkezést követően egy zónát (hosztnév) tud karbantartani a felhasználó. Az oldal fejlécében jól látható, hogy melyik zónát tudja karbantartani a felhasználó. Ez a zóna a felhasználó létrehozásakor meghatározásra kerül és a későbbiek folyamán nincs mód ennek a megváltoztatására. A zóna utolsó frissítésének dátumáról a fejlécben található információ.
Alzóna A főképernyő bal szélén találhatóak az alzónák (aldomain), ebből több is tartozhat egy zónához. Minden alzóna egy vagy több adathalmazhoz (dataset) van hozzárendelve, így az ezekből álló DNS rekordok összességét jelenti. A zónában minimum egy alzónának szerepelnie kell. Alzóna műveletek: Létrehozás, szerkesztés: Alzónát az Alzóna műveletek menü alatt megjelenő oldalon az Új alzóna hozzáadása menüpont megnyomásával lehet létrehozni, illetve az Alzóna szerkesztése menüpontból szerkeszteni. Kötelező megadni egy nevet, ami egy érvényes hostnév, ez lesz az alzóna neve, amely egyben egyedi azonosításra is szolgál. Ezt a Név mezőbe kell beírni. Üres alzónát, aminek az adatai közvetlenül a zóna alá tartoznak a @ névvel létrehozott alzóna valósítja meg. A név az angol ABC betűit, számjegyeket és kötőjelet tartalmazhat, teljes hossza maximálisan 63 karakter lehet. Az alzónához tartozó dataseteket a Hozzárendelt datasetek -nél lehet kiválasztani, az első oszlopban lévő checkboxok segítségével. Az alzónát a név megadása, és a datasetek hozzárendelése után a Mentés gomb segítségével lehet létrehozni vagy módosítani, a Mégse gomb segítségével pedig a folyamatot meg lehet szakítani.
Törlés: A kiválasztott alzóna törléséhez válassza az Alzóna műveletek menüből az Alzóna törlése menüpontot. Törlés előtt jóváhagyás szükséges.
Dataset A dataset (adathalmaz) a DNS rekordok gyűjteménye amelyek IP címet (tartományt) vagy hosztneve(ke)t tartalmaz. Egy adathalmazon belül csak hosztnév vagy csak IP típus lehetséges, egyszerre a kettő nem. Egy adathalmaz több alzónához is tartozhat. Az RBLDNS alkalmazás lehetővé teszi azon adathalmazok felhasználást is, amelyeket más felhasználók hoztak létre, és azokat publikusnak jelölték. Az ilyen adathalmazok csak a saját tulajdonosuk által szerkeszthetőek, de tartalmuk szabadon megtekinthető Az adathalmazokat a főképernyő jobb szélén található Datasetek felirat alatt lehet kezelni. Itt egy összefoglaló táblázatban lehet áttekinteni a létrehozott, illetve a többi felhasználó publikus adathalmazait, azok fontosabb adataival együtt mint: Név (tulajdonosonként egyedi azonosító) Típus (az adathalmaz típusa) Tulajdonos (az adathalmaz tulajdonosa) Publikus (publikusan felhasználható-e az adathalmaz) Leírás (részletes tájékoztató, hogy a tulajdonos mit tárol, mire használja az adathalmazt) Dataset műveletek: Létrehozás, szerkesztés: Adathalmazt a Dataset műveletek lenyíló menü alatt megjelenő, Új dataset hozzáadása menüpont megnyomásával lehet létrehozni, illetve a Dataset szerkesztése menüpontból szerkeszteni.
Kötelező megadni egy nevet a Név mezőben, ez lesz a dataset neve ami egyben egyedi azonosításra is szolgál egy zónán belül. A név az angol ABC betűit, számjegyeket és kötőjelet tartalmazhat, teljes hossza maximálisan 63 karakter lehet. Kötelező kiválasztani a dataset típusát. A Típus mezőben ezt egy lenyíló lista segítségével tehetjük meg. A típus lehet ip4set, ha IP címe(ke)t vagy tartomány(oka)t fog tartalmazni a hozzárendelt rekord(ok) vagy dnset, ha hosztneve(ke)t. Meglevő dataset esetében a típus nem szerkeszthető. Kötelező megadni a dataset lejárati idejét. A Lejárat(sec) mezőben másodpercben kell megadni azt, hogy mennyi idő múlva kerüljenek törlésre az adathalmazhoz hozzárendelt rekordok. Nulla esetén nem lesz lejárati idő definiálva, a maximálisan megadható értéke 2 147 483 647 (előjeles 32 bites integer). Ez a dataseteket tartalmazó táblázatban már dátumként fog megjelenni a könnyebb emberi értelmezhetőség érdekében. Kötelező megadni az adathalmaz válasz üzenetét a Válaszkód mezőbe. Ennek értéke IP cím és egy nem kötelező szöveg. Ezek együttes hossza nem haladhatja meg a 255 karaktert. Támogatott formátumok a következőek: :127.0.0.2: :127.0.0.2:Blacklisted: http://example.com/bl?$ A $ jel használható a DNS lekérdezésben megadott érték helyettesítésére. Kötelező megadni az adathalmazhoz hozzárendelt alzónákat. Ezt az Alzónák kiválasztó mező segítségével lehet megadni. A bal oldali dobozban találhatóak a rendelkezésre álló alzónák a nyilak segítségével könnyen át lehet helyezni a kívánt alzónákat a jobb oldali dobozban (az ellentétes nyilakkal könnyen elvégezhető a művelet visszafele is). A jobb oldali doboz tartalma fog hozzárendelődni az adathalmazhoz. Egy alzóna kiválasztása kötelező. A publikus jelölőnégyzet mondja meg, hogy az adott dataset látható-e a többi felhasználó számára. A publikus datasetek tartalmát a többi felhasználó megtekintheti, saját alzónájában a datasetet felhasználhatja, de rekordokat törölni vagy hozzáadni nem tud. Az adathalmazt a kötelező mezők kitöltése után a Mentés gomb segítségével lehet létrehozni, a Mégse gomb segítségével pedig a létrehozó folyamatot lehet megszakítani. Rekordok: A saját tulajdonú adathalmazokhoz rekordokat adhatunk hozzá és törölhetünk ki. A rekordok jelöljük ki a kívánt adathalmazt, majd a karbantartásához a Dataset műveletek menüből válaszok a Rekordok kezelése menüpontot. Ha más felhasználó adathalmazát nyitjuk meg, úgy a Rekord műveletek lenyíló menü nem lesz látható.
Létrehozás: Itt van lehetőség új rekordot létrehozni a Új rekord hozzáadása menüponttal megnyomásával Rekord műveletek menüből. Kötelező megadni a rekord értékét, ezt az Érték mezőben lehet megtenni. Az érték csak ASCII 32-126 közötti karaktereket tartalmazhat. Az érték mező tartalmának összhangban kell lennie az adathalmaz típusával a következő módon: ip4set esetén: IP cím pl.: 127.0.0.1 IP tartomány pl.: 127.16.0.0-127.31.255.255 IP tartomány CIDR formátumban pl.: 127.0.0.0/24 dnset esetén: example.com (csak az example.com) *.example.com (az example.com összes aldomainje).examle.com (az example.com összes aldomainje és az examle.com együttesen) Nem kötelező megadni a rekord lejárati idejét. Csak akkor kell kitölteni ha Lejárat(sec) mezőt ha eltár a dataset lejárati idejétől. Megadásakor ugyan azok a szabályok vonatkoznak rá, mint az adathalmaznál való megadásra. Amennyiben meg lett adva érték, akkor a megadott időben a rekord törlődni fog az adott adathalmazból. Nem kötelező a Megjegyzés mező kitöltése sem, ez a könnyebb azonosítást teszi lehetővé. Csak ASCII 32-127 karaktereket tartalmazhat. A rekordot a kötelező mezők kitöltése után a Mentés gomb segítségével lehet létrehozni, a Mégse gomb segítségével pedig a létrehozó folyamatot lehet megszakítani.
Tömeges hozzáadása: A Tömeges hozzáadása gombra való kattintással tömegesen lehet rekordokat felvenni. Kötelező megadni a Rekordok mező tartalmát. Itt a megfelelő értékeket lehet megadni, soronként egyet. Az értékekre vonatkozó szabályok megegyeznek az egyenként való rekordmegadáséval.
Törlés: A Kijelölt rekordok törlése menüpont segítségével van mód a rekordok törlésére. Kijelölni a rekordokat a táblázat első oszlopában található négyzetre kattintva lehet. Az összes rekord kijelöléséhez az oszlop fejlécében kell az első oszlopban szereplő négyzetre kattintani, ezt követően az összes rekord ki lesz jelölve. Törlés előtt a rendszer rákérdez a műveletre a véletlen törlés elkerülése végett. A törlést véglegesíteni a felugró ablakban a Törlés gomb megnyomásával lehetséges, a műveletet a Mégse gomb megnyomásával lehet megszakítani. A rekordok listáját tartalmazó ablakot az Ok gomb lenyomásával lehet bezárni.
Törlés: A felvett adathalmazokat törölni is lehet, ehhez ki kell jelölni a dataseteket tartalmazó táblázat első oszlopában található négyzet segítségével. Törölni csak a saját tulajdonú adathalmazokat lehetséges. Ekkor a rendszer rákérdez a műveletre a véletlen törlés elkerülése végett. A törlést véglegesíteni a felugró ablakban a Törlés gomb megnyomásával lehetséges, a műveletet a Mégse gomb megnyomásával lehet megszakítani.
Nyelvválasztás A kezelőfelület nyelvét a fejlécben található zászlók segítségével lehet megváltoztatni. A magyar nyelv az alapértelmezett (magyar zászló), az oldal elérhető angol verzióban (angol zászló) és orosz verzióban is (orosz zászló). Kijelentkezés Az oldalt elhagyni a fejlécben található KILÉPÉS gomb megnyomásával lehetséges.
RBLDNS REST API-n keresztüli kezelése A REST API segítségével a webes felület kiiktatásával lehet adatokat felvenni, törölni és módosítani az RBLDNS rendszerben. A REST API a http://spamdns.eu/rbl/rs/root útvonalon érhető el. Autentikáció Az API csak autentikált felhasználó számára érhető el, ugyan úgy, mint a webes felület. Az alap autentikációs paramétereket a HTTP headerben kell Base64-ben kódolva elküldeni minden API hívás során. Műveletek A REST API-n keresztül az alábbi műveletek hajthatók végre: Alzóna adott zónához tartozó alzónák listázása (GET): /subzones/{zone} adott alzóna részletező (GET): /subzones/{zone}/{id} alzóna létrehozása (POST): /subzones/{zone} alzóna módosítása (PUT): /subzones/{zone} alzóna törlése (DELETE): /subzones/{zone} Dataset Rekord adott alzónához tartozó datasetek listája (GET): /datasets/{zone} adott dataset részletező (GET): /datasets/{zone}/{id} adott dataset-hez tartozó rekordok listázója (GET): /datasets/record/{zone}/{id} dataset létrehozása (POST): /datasets/{zone} dataset módosítása (PUT): /datasets/{zone} dataset törlése (DELETE): /datasets/{zone} rekord létrehozása (POST): /datasets/record/{zone} több rekord egyidejű felvétele (POST): /datasets/records/{zone} adott zóna rekordjainak listázója (GET): /records/{zone} adott rekord részletező (GET): /records/{zone}/{id} rekordok törlése (DELETE): /records/{zone} Adatstruktúra A kért adatokat JSON formátumban kell beküldeni és ugyanilyen formátumban kapja vissza a kliens is. Pl. alzóna listázó esetén a kliens csak az url paramétereket állítja be, válaszként meg az alábbi
struktúrát kapja: [ ] { }, { } "id": 2, "name": "mysubzone-1", "datasets": 1, "creationtime": "2013-06-17T15:04:19.107" "id": 3, "name": "mysubzone-2", "datasets": 2, "creationtime": "2013-06-17T15:04:19.107" A timestamp értékeket (dátumok) a kliens nem küldhet be, ezek szerver oldalon keletkeznek. Új alzóna esetén a request paraméter a következő: {"name":"subzonename-a"} Több rekord egyidejű létrehozásához az alábbi struktúrát kell beküldeni: [ ] { }, { } "value": "128.0.0.35", "expiration": 1000, "remark": "test remark", "datasetid": 4 "value": "128.0.0.36", "expiration": 1000, "remark": "test remark", "datasetid": 4