|
1
|
1 |
|
from time import strftime, localtime |
|
2
|
|
|
|
|
3
|
1 |
|
from spike.model import db |
|
4
|
1 |
|
from shlex import shlex |
|
5
|
|
|
|
|
6
|
|
|
|
|
7
|
1 |
|
class NaxsiRules(db.Model): |
|
8
|
1 |
|
__bind_key__ = 'rules' |
|
9
|
1 |
|
__tablename__ = 'naxsi_rules' |
|
10
|
|
|
|
|
11
|
1 |
|
id = db.Column(db.Integer, primary_key=True) |
|
12
|
1 |
|
msg = db.Column(db.String(), nullable=False) |
|
13
|
1 |
|
detection = db.Column(db.String(1024), nullable=False) |
|
14
|
1 |
|
mz = db.Column(db.String(1024), nullable=False) |
|
15
|
1 |
|
score = db.Column(db.String(1024), nullable=False) |
|
16
|
1 |
|
sid = db.Column(db.Integer, nullable=False, unique=True) |
|
17
|
1 |
|
ruleset = db.Column(db.String(1024), nullable=False) |
|
18
|
1 |
|
rmks = db.Column(db.Text, nullable=True, server_default="") |
|
19
|
1 |
|
active = db.Column(db.Integer, nullable=False, server_default="1") |
|
20
|
1 |
|
negative = db.Column(db.Integer, nullable=False, server_default='0') |
|
21
|
1 |
|
timestamp = db.Column(db.Integer, nullable=False) |
|
22
|
|
|
|
|
23
|
1 |
|
mr_kw = ["MainRule", "BasicRule", "main_rule", "basic_rule"] |
|
24
|
1 |
|
static_mz = {"$ARGS_VAR", "$BODY_VAR", "$URL", "$HEADERS_VAR"} |
|
25
|
1 |
|
full_zones = {"ARGS", "BODY", "URL", "HEADERS", "FILE_EXT", "RAW_BODY"} |
|
26
|
1 |
|
rx_mz = {"$ARGS_VAR_X", "$BODY_VAR_X", "$URL_X", "$HEADERS_VAR_X"} |
|
27
|
1 |
|
sub_mz = list(static_mz) + list(full_zones) + list(rx_mz) |
|
28
|
|
|
|
|
29
|
1 |
|
def __init__(self, msg="", detection="str:a", mz="ARGS", score="$None:0", sid='42000', ruleset="", rmks="", |
|
30
|
|
|
active=0, negative=False, timestamp=0): |
|
31
|
1 |
|
self.msg = msg |
|
32
|
1 |
|
self.detection = detection |
|
33
|
1 |
|
self.mz = mz |
|
34
|
1 |
|
self.score = score |
|
35
|
1 |
|
self.sid = sid |
|
36
|
1 |
|
self.ruleset = ruleset |
|
37
|
1 |
|
self.rmks = rmks |
|
38
|
1 |
|
self.active = active |
|
39
|
1 |
|
self.negative = negative |
|
40
|
1 |
|
self.timestamp = timestamp |
|
41
|
1 |
|
self.warnings = [] |
|
42
|
1 |
|
self.error = [] |
|
43
|
|
|
|
|
44
|
1 |
|
def fullstr(self): |
|
45
|
1 |
|
rdate = strftime("%F - %H:%M", localtime(float(str(self.timestamp)))) |
|
46
|
1 |
|
rmks = "# ".join(self.rmks.strip().split("\n")) |
|
47
|
1 |
|
return "#\n# sid: {0} | date: {1}\n#\n# {2}\n#\n{3}".format(self.sid, rdate, rmks, self.__str__()) |
|
48
|
|
|
|
|
49
|
1 |
|
def __str__(self): |
|
50
|
1 |
|
return 'MainRule {} "{}" "msg:{}" "mz:{}" "s:{}" id:{} ;'.format( |
|
51
|
|
|
'negative' if self.negative else '', self.detection, self.msg, self.mz, self.score, self.sid) |
|
52
|
|
|
|
|
53
|
1 |
|
def explain(self): |
|
54
|
|
|
""" Return a string explaining the rule |
|
55
|
|
|
|
|
56
|
|
|
:return str: A textual explanation of the rule |
|
57
|
|
|
""" |
|
58
|
1 |
|
translation = {'ARGS': 'argument', 'BODY': 'body', 'URL': 'url', 'HEADER': 'header', |
|
59
|
|
|
'HEADER:Cookie': 'cookies'} |
|
60
|
1 |
|
explanation = 'The rule number <strong>{0}</strong> is '.format(self.sid) |
|
61
|
1 |
|
if self.negative: |
|
62
|
1 |
|
explanation += '<strong>not</strong> ' |
|
63
|
1 |
|
explanation += 'setting the ' |
|
64
|
|
|
|
|
65
|
1 |
|
scores = [] |
|
66
|
1 |
|
for score in self.score.split(','): |
|
67
|
1 |
|
scores.append('<strong>{0}</strong> score to <strong>{1}</strong> '.format(*score.split(':', 1))) |
|
68
|
1 |
|
explanation += ', '.join(scores) + 'when it ' |
|
69
|
1 |
|
if self.detection.startswith('str:'): |
|
70
|
1 |
|
explanation += 'finds the string <strong>{}</strong> '.format(self.detection[4:]) |
|
71
|
|
|
else: |
|
72
|
1 |
|
explanation += 'matches the regexp <strong>{}</strong> in '.format(self.detection[3:]) |
|
73
|
|
|
|
|
74
|
1 |
|
zones = [] |
|
75
|
1 |
|
for mz in self.mz.split('|'): |
|
76
|
1 |
|
if mz.startswith('$'): |
|
77
|
1 |
|
current_zone, arg = mz.split(":", 1) |
|
78
|
1 |
|
zone_name = "?" |
|
79
|
|
|
|
|
80
|
1 |
|
for translated_name in translation: # translate zone names |
|
81
|
1 |
|
if translated_name in current_zone: |
|
82
|
1 |
|
zone_name = translation[translated_name] |
|
83
|
|
|
|
|
84
|
1 |
|
if "$URL" in current_zone: |
|
85
|
|
|
regexp = "matching regex" if current_zone == "$URL_X" else "" |
|
86
|
|
|
zones.append("on the URL {} '{}' ".format(regexp, arg)) |
|
87
|
|
|
else: |
|
88
|
1 |
|
regexp = "matching regex" if current_zone.endswith("_X") else "" |
|
89
|
1 |
|
if zone_name == 'header' and arg.lower() == 'cookie': |
|
90
|
1 |
|
zones.append('in the <strong>cookies</strong>') |
|
91
|
|
|
else: |
|
92
|
|
|
zones.append("in the var with name {} '{}' of {} ".format(regexp, arg, zone_name)) |
|
93
|
|
|
else: |
|
94
|
1 |
|
zones.append('the <strong>{0}</strong>'.format(translation[mz])) |
|
95
|
1 |
|
return explanation + ' ' + ', '.join(zones) + '.' |
|
96
|
|
|
|
|
97
|
1 |
|
def validate(self): |
|
98
|
1 |
|
self.warnings = list() |
|
99
|
1 |
|
self.error = list() |
|
100
|
|
|
|
|
101
|
1 |
|
self.__validate_matchzone(self.mz) |
|
102
|
1 |
|
self.__validate_id(self.sid) |
|
103
|
1 |
|
self.__validate_score(self.score) |
|
104
|
|
|
|
|
105
|
1 |
|
if self.detection.startswith('rx:'): |
|
106
|
1 |
|
self.__validate_detection_rx(self.detection) |
|
107
|
1 |
|
elif self.detection.startswith('str:'): |
|
108
|
1 |
|
self.__validate_detection_str(self.detection) |
|
109
|
|
|
else: |
|
110
|
1 |
|
self.error.append("Your 'detection' string must start with str: or rx:") |
|
111
|
|
|
|
|
112
|
1 |
|
if not self.msg: |
|
113
|
|
|
self.warnings.append("Rule has no 'msg:'.") |
|
114
|
1 |
|
if not self.score: |
|
115
|
|
|
self.error.append("Rule has no score.") |
|
116
|
1 |
|
if not self.mz: |
|
117
|
|
|
self.error.append("Rule has no match zone.") |
|
118
|
|
|
|
|
119
|
1 |
|
def __fail(self, msg): |
|
120
|
1 |
|
self.error.append(msg) |
|
121
|
1 |
|
return False |
|
122
|
|
|
|
|
123
|
|
|
# Bellow are parsers for specific parts of a rule |
|
124
|
|
|
|
|
125
|
1 |
|
def __validate_detection_str(self, p_str, assign=False): |
|
126
|
1 |
|
if assign is True: |
|
127
|
|
|
self.detection = p_str |
|
128
|
1 |
|
return True |
|
129
|
|
|
|
|
130
|
1 |
|
def __validate_detection_rx(self, p_str, assign=False): |
|
131
|
1 |
|
if not p_str.islower(): |
|
132
|
1 |
|
self.warnings.append("detection {} is not lower-case. naxsi is case-insensitive".format(p_str)) |
|
133
|
|
|
|
|
134
|
1 |
|
try: # try to validate the regex with PCRE's python bindings |
|
135
|
1 |
|
import pcre |
|
136
|
|
|
try: # if we can't compile the regex, it's likely invalid |
|
137
|
|
|
pcre.compile(p_str[3:]) |
|
138
|
|
|
except pcre.PCREError: |
|
139
|
|
|
return self.__fail("{} is not a valid regex:".format(p_str)) |
|
140
|
1 |
|
except ImportError: # python-pcre is an optional dependency |
|
|
|
|
|
|
141
|
1 |
|
pass |
|
142
|
|
|
|
|
143
|
1 |
|
if assign is True: |
|
144
|
1 |
|
self.detection = p_str |
|
145
|
1 |
|
return True |
|
146
|
|
|
|
|
147
|
1 |
|
def __validate_score(self, p_str, assign=False): |
|
148
|
1 |
|
for score in p_str.split(','): |
|
149
|
1 |
|
if ':' not in score: |
|
150
|
|
|
self.__fail("You score '{}' has no value or name.".format(score)) |
|
151
|
1 |
|
name, value = score.split(':') |
|
152
|
1 |
|
if not value.isdigit(): |
|
153
|
|
|
self.__fail("Your value '{}' for your score '{}' is not numeric.".format(value, score)) |
|
154
|
1 |
|
elif not name.startswith('$'): |
|
155
|
|
|
self.__fail("Your name '{}' for your score '{}' does not start with a '$'.".format(name, score)) |
|
156
|
1 |
|
if assign: |
|
157
|
1 |
|
self.score = p_str |
|
158
|
1 |
|
return True |
|
159
|
|
|
|
|
160
|
1 |
|
def __validate_matchzone(self, p_str, assign=False): |
|
161
|
1 |
|
has_zone = False |
|
162
|
1 |
|
mz_state = set() |
|
163
|
1 |
|
for loc in p_str.split('|'): |
|
164
|
1 |
|
keyword, arg = loc, None |
|
165
|
1 |
|
if loc.startswith("$"): |
|
166
|
1 |
|
if loc.find(":") == -1: |
|
167
|
|
|
return self.__fail("Missing 2nd part after ':' in {0}".format(loc)) |
|
168
|
1 |
|
keyword, arg = loc.split(":") |
|
169
|
|
|
|
|
170
|
1 |
|
if keyword not in self.sub_mz: # check if `keyword` is a valid keyword |
|
171
|
1 |
|
return self.__fail("'{0}' is not a known sub-part of mz : {1}".format(keyword, self.sub_mz)) |
|
172
|
|
|
|
|
173
|
1 |
|
mz_state.add(keyword) |
|
174
|
|
|
|
|
175
|
|
|
# verify that the rule doesn't attempt to target REGEX and STATIC _VAR/URL at the same time |
|
176
|
1 |
|
if len(self.rx_mz & mz_state) and len(self.static_mz & mz_state): |
|
177
|
1 |
|
return self.__fail("You can't mix static $* with regex $*_X ({})".format(', '.join(mz_state))) |
|
178
|
|
|
|
|
179
|
1 |
|
if arg and not arg.islower(): # just a gentle reminder |
|
180
|
1 |
|
self.warnings.append("{0} in {1} is not lowercase. naxsi is case-insensitive".format(arg, loc)) |
|
181
|
|
|
|
|
182
|
|
|
# the rule targets an actual zone |
|
183
|
1 |
|
if keyword not in ["$URL", "$URL_X"] and keyword in (self.rx_mz | self.full_zones | self.static_mz): |
|
|
|
|
|
|
184
|
1 |
|
has_zone = True |
|
185
|
|
|
|
|
186
|
1 |
|
if has_zone is False: |
|
187
|
|
|
return self.__fail("The rule/whitelist doesn't target any zone.") |
|
188
|
|
|
|
|
189
|
1 |
|
if assign is True: |
|
190
|
1 |
|
self.mz = p_str |
|
191
|
|
|
|
|
192
|
1 |
|
return True |
|
193
|
|
|
|
|
194
|
1 |
|
def __validate_id(self, p_str, assign=False): |
|
195
|
1 |
|
try: |
|
196
|
1 |
|
num = int(p_str) |
|
197
|
1 |
|
if num < 10000: |
|
198
|
1 |
|
self.warnings.append("rule IDs below 10k are reserved ({0})".format(num)) |
|
199
|
1 |
|
except ValueError: |
|
200
|
1 |
|
self.error.append("id:{0} is not numeric".format(p_str)) |
|
201
|
1 |
|
return False |
|
202
|
1 |
|
if assign is True: |
|
203
|
1 |
|
self.sid = num |
|
204
|
1 |
|
return True |
|
205
|
|
|
|
|
206
|
1 |
|
@staticmethod |
|
207
|
|
|
def splitter(full_str): |
|
208
|
1 |
|
lexer = shlex(full_str) |
|
209
|
1 |
|
lexer.whitespace_split = True |
|
210
|
1 |
|
return list(iter(lexer.get_token, '')) |
|
211
|
|
|
|
|
212
|
1 |
|
def parse_rule(self, full_str): |
|
213
|
|
|
""" |
|
214
|
|
|
Parse and validate a full naxsi rule |
|
215
|
|
|
:param full_str: raw rule |
|
216
|
|
|
:return: [True|False, dict] |
|
217
|
|
|
""" |
|
218
|
1 |
|
self.warnings = list() |
|
219
|
1 |
|
self.error = list() |
|
220
|
|
|
|
|
221
|
1 |
|
func_map = {"id:": self.__validate_id, "str:": self.__validate_detection_str, |
|
222
|
|
|
"rx:": self.__validate_detection_rx, "msg:": lambda p_str, assign=False: True, |
|
223
|
|
|
"mz:": self.__validate_matchzone, "negative": lambda p_str, assign=False: p_str == 'checked', |
|
224
|
|
|
"s:": self.__validate_score} |
|
225
|
|
|
|
|
226
|
1 |
|
split = self.splitter(full_str) # parse string |
|
227
|
1 |
|
intersection = set(split).intersection(set(self.mr_kw)) |
|
228
|
|
|
|
|
229
|
1 |
|
if not intersection: |
|
230
|
1 |
|
return self.__fail("No mainrule/basicrule keyword.") |
|
231
|
1 |
|
elif len(intersection) > 1: |
|
232
|
1 |
|
return self.__fail("Multiple mainrule/basicrule keywords.") |
|
233
|
|
|
|
|
234
|
1 |
|
split.remove(intersection.pop()) # remove the mainrule/basicrule keyword |
|
235
|
|
|
|
|
236
|
1 |
|
if ";" in split: |
|
237
|
1 |
|
split.remove(";") |
|
238
|
|
|
|
|
239
|
1 |
|
for keyword in split: |
|
240
|
1 |
|
keyword = keyword.strip() |
|
241
|
|
|
|
|
242
|
1 |
|
if keyword.endswith(";"): # remove semi-colons |
|
243
|
1 |
|
keyword = keyword[:-1] |
|
244
|
1 |
|
if keyword.startswith(('"', "'")) and (keyword[0] == keyword[-1]): # remove (double-)quotes |
|
245
|
1 |
|
keyword = keyword[1:-1] |
|
246
|
|
|
|
|
247
|
1 |
|
parsed = False |
|
248
|
1 |
|
for frag_kw in func_map: |
|
249
|
1 |
|
if keyword.startswith(frag_kw): # use the right parser |
|
250
|
1 |
|
if frag_kw in ('rx:', 'str:'): # don't remove the leading "str:" or "rx:" |
|
251
|
1 |
|
payload = keyword |
|
252
|
|
|
else: |
|
253
|
1 |
|
payload = keyword[len(frag_kw):] |
|
254
|
|
|
|
|
255
|
1 |
|
function = func_map[frag_kw] # we're using an array of functions, C style! |
|
256
|
1 |
|
if function(payload, assign=True) is True: |
|
257
|
1 |
|
parsed = True |
|
258
|
1 |
|
break |
|
259
|
1 |
|
return self.__fail("parsing of element '{0}' failed.".format(keyword)) |
|
260
|
|
|
|
|
261
|
1 |
|
if parsed is False: # we have an item that wasn't successfully parsed |
|
262
|
1 |
|
return self.__fail("'{}' is an invalid element and thus can not be parsed.".format(keyword)) |
|
263
|
|
|
return True |
|
264
|
|
|
|
nbs-system /
spike
Loading history...
Except handlers which only contain
passand do not have anelseclause can usually simply be removed: