4
# written by Renaud Deraison <deraison@cvs.nessus.org>
7
# 19/04/01 : added types 'password' and 'file'
8
# 03/01/99 : clearly stated that a client may
9
# not take these preferences in account
10
# 09/03/98 : first public release
14
A client MAY not take this paper in consideration and may silently
15
ignore this specification, but I don't recommand it -- try to have
16
as many features as possible.
19
The plugins preferences idea comes from Thomas B. Bigalke <bigalke@bigfoot.de>
22
Some 'advanced' plugins will need their own preferences (ie : BruteForce
23
attack plugins will need the path to a wordlist).
25
This paper assumes that you are familiar with the NTP/1.0 and NTP/1.1 protocols.
28
The preferences of the plugins are sent by the server in the
29
PREFERENCES message, among the preferences of the server, and have the
32
Plugin Name[preference_type]:name <|> default value
37
o 'Plugin name' is the name of the plugin which needs the preferences
38
o 'preference_type' is the type of the widget used by the preference
39
o 'name' is the name of the preference
40
o 'default_value' is the default value of the preference.
45
preference_type is one of the following string :
46
"checkbox" : means that the plugin will have two values : 'yes'
47
or no. The client should show this preference by
50
"entry" : means that the preference will have an infinity of values,
51
since it will be shown by the client as a text entry.
53
"password" : same as entry, but instructs the client to _not_ show
54
the text typed by the user (and eventually to cipher it
55
if storing it on disk)
57
"radio" : means that the preference will have a restricted set of
58
values, shown by the client as a set of radio buttons.
59
If selected, the 'default_value' string will have the
60
following format : 'value1;value2;value3...;valueN', and
61
the client will select the first value by default
64
"file" : means that there is an attached file in the rest of the
65
message. The value returned by the client must be the
66
name of a file, as described the in the ATTACHED_FILE
72
Depends on the value of 'preference_type' :
75
--------------------++----------------------
76
preference_type || default_value
77
====================||======================
79
checkbox || 'yes' or 'no'
80
____________________||______________________
82
entry|password || anything
83
____________________||______________________
85
radio || value1;value2;....
87
--------------------||----------------------
90
____________________||______________________
94
comments : mailto:deraison@cvs.nessus.org
added
removed
doc/ntp/plugin_prefs.txt
