Modify ChangeLog.
[libradsec.git] / radsecproxy.conf-example
1 # Master config file, must be in /etc/radsecproxy or specified with -c option
2 #       All possible config options are listed below
3
4 # First you may define any global options, these are:
5 #
6 # You can optionally specify addresses and ports to listen on
7 # Multiple statements can be used for multiple ports/addresses
8 #ListenUDP              *:1814
9 #ListenUDP              localhost
10 #ListenTCP              [2001:700:1:7:215:f2ff:fe35:307d]:1812
11 #ListenTLS              10.10.10.10:2084
12 #ListenTLS              [2001:700:1:7:215:f2ff:fe35:307d]:2084
13 #ListenDTLS             [2001:700:1:7:215:f2ff:fe35:307d]:2084
14
15 # To specify a certain address/port for UDP/TLS requests you can use e.g.
16 #SourceUDP              127.0.0.1:33000
17 #SourceTCP              *:33000
18 #SourceTLS              *:33001
19 #SourceDTLS             *:33001
20
21 # Optional log level. 3 is default, 1 is less, 5 is more
22 #LogLevel               3
23 # Optional LogDestination, else stderr used for logging
24 # Logging to file
25 #LogDestination         file:///tmp/rp.log
26 # Or logging with Syslog. LOG_DAEMON used if facility not specified
27 # The supported facilities are LOG_DAEMON, LOG_MAIL, LOG_USER and
28 # LOG_LOCAL0, ..., LOG_LOCAL7
29 #LogDestination         x-syslog:///
30 #LogDestination         x-syslog:///log_local2
31
32 # For generating log entries conforming to the F-Ticks system, specify
33 # FTicksReporting with one of the following values.
34 #   None  -- Do not log in F-Ticks format.  This is the default.
35 #   Basic -- Do log in F-Ticks format but do not log VISINST.
36 #   Full  -- Do log in F-Ticks format and do log VISINST.
37 # Please note that in order to get F-Ticks logging for a given client,
38 # its matching client configuration block has to contain the
39 # fticksVISCOUNTRY option.
40
41 # You can optionally specify FTicksMAC in order to determine if and
42 # how Calling-Station-Id (users Ethernet MAC address) is being logged.
43 #   Static          -- Use a static string as a placeholder for
44 #                      Calling-Station-Id.
45 #   Original        -- Log Calling-Station-Id as-is.
46 #   VendorHashed    -- Keep first three segments as-is, hash the rest.
47 #   VendorKeyHashed -- Like VendorHashed but salt with F-Ticks-Key.    This
48 #                      is the default.
49 #   FullyHashed     -- Hash the entire string.
50 #   FullyKeyHashed  -- Like FullyHashed but salt with F-Ticks-Key.
51
52 # In order to use FTicksMAC with one of VendorKeyHashed or
53 # FullyKeyHashed, specify a key with FTicksKey.
54 # FTicksKey <key>
55
56 # Default F-Ticks configuration:
57 #FTicksReporting None
58 #FTicksMAC Static
59
60 # There is an option for doing some simple loop prevention.  Note that
61 # the LoopPrevention directive can be used in server blocks too,
62 # overriding what's set here in the basic settings.
63 #LoopPrevention         on
64 # Add TTL attribute with value 20 if not present (prevents endless loops)
65 #AddTTL 20
66
67 # If we have TLS clients or servers we must define at least one tls block.
68 # You can name them whatever you like and then reference them by name when
69 # specifying clients or servers later. There are however three special names
70 # "default", "defaultclient" and "defaultserver". If no name is defined for
71 # a client, the "defaultclient" block will be used if it exists, if not the
72 # "default" will be used. For a server, "defaultserver" followed by "default"
73 # will be checked.
74 #
75 # The simplest configuration you can do is:
76 tls default {
77     # You must specify at least one of CACertificateFile or CACertificatePath
78     # for TLS to work. We always verify peer certificate (client and server)
79     # CACertificateFile    /etc/cacerts/CA.pem
80     CACertificatePath   /etc/cacerts
81
82     # You must specify the below for TLS, we always present our certificate
83     CertificateFile     /etc/hostcertkey/host.example.com.pem
84     CertificateKeyFile  /etc/hostcertkey/host.example.com.key.pem
85     # Optionally specify password if key is encrypted (not very secure)
86     CertificateKeyPassword      "follow the white rabbit"
87     # Optionally enable CRL checking
88     # CRLCheck on
89     # Optionally specify how long CAs and CRLs are cached, default forever
90     # CacheExpiry 3600
91     # Optionally require that peer certs have one of the specified policyOIDs
92     # policyoid     1.2.3 # this option can be used multiple times
93     # policyoid     1.3.4
94 }
95
96 # If you want one cert for all clients and another for all servers, use
97 # defaultclient and defaultserver instead of default. If we wanted some
98 # particular server to use something else you could specify a block
99 # "tls myserver" and then reference that for that server. If you always
100 # name the tls block in the client/server config you don't need a default
101
102 # Now we configure clients, servers and realms. Note that these and
103 # also the lines above may be in any order, except that a realm
104 # can only be configured to use a server that is previously configured.
105
106 # A realm can be a literal domain name, * which matches all, or a
107 # regexp. A regexp is specified by the character prefix /
108 # For regexp we do case insensitive matching of the entire username string.
109 # The matching of realms is done in the order they are specified, using the
110 # first match found. Some examples are
111 # "@example\.com$", "\.com$", ".*" and "^[a-z].*@example\.com$".
112 # To treat local users separately you might try first specifying "@"
113 # and after that "*".
114
115 # Configure a rewrite block if you want to add/remove/modify attributes
116 # rewrite example {
117 #       # Remove NAS-Port.
118 #       removeAttribute 5
119 #       # Remove vendor attribute 100.
120 #       removeVendorAttribute 99:100
121 #       # Called-Station-Id = "123456"
122 #       addAttribute 30:123456
123 #       # Vendor-99-Attr-101 = 0x0f
124 #       addVendorAttribute 99:101:%0f
125 #       # Change users @local to @example.com.
126 #       modifyAttribute 1:/^(.*)@local$/\1@example.com/
127 # }
128
129 client 2001:db8::1 {
130         type    tls
131         secret  verysecret
132 # we could specify tls here, e.g.
133 #       tls myclient
134 # in order to use tls parameters named myclient. We don't, so we will
135 # use "tls defaultclient" if defined, or look for "tls default" as a
136 # last resort
137 }
138 client 127.0.0.1 {
139         type    udp
140         secret  secret
141 #       Might do rewriting of incoming messages using rewrite block example
142 #       rewriteIn example
143 #       Can also do rewriting of outgoing messages
144 #       rewriteOut example      
145 }
146 client 127.0.0.1 {
147         type    tcp
148         secret  secret
149 }
150 client radius.example.com {
151         type tls
152 # secret is optional for TLS
153 }
154 client radius.example.com {
155         type dtls
156 # secret is optional for DTLS
157 }
158
159 server 127.0.0.1 {
160         type    UDP
161         secret  secret
162 #       Might do rewriting of incoming messages using rewrite block example
163 #       rewriteIn example
164 #       Can also do rewriting of outgoing messages
165 #       rewriteOut example      
166 #       Might override loop prevention here too:
167 #       LoopPrevention off
168 }
169 realm   eduroam.cc {
170         server  127.0.0.1
171 # If also want to use this server for accounting, specify
172 #       accountingServer 127.0.0.1
173 }
174
175 server 2001:db8::1 {
176         type    TLS
177         port    2283
178 # secret is optional for TLS
179 # we could specify tls here, e.g.
180 #       tls myserver
181 # in order to use tls parameters named myserver. We don't, so we will
182 # use "tls defaultserver" if defined, or look for "tls default" as a
183 # last resort
184 }
185 server radius.example.com {
186         type    tls
187         secret  verysecret
188         StatusServer on
189 # statusserver is optional, can be on or off. Off is default
190 }
191 #server radius.example.com {
192 #       type    dtls
193 #       secret  verysecret
194 #       StatusServer on
195 ## statusserver is optional, can be on or off. Off is default
196 #}
197
198 # Equivalent to example.com
199 realm /@example\.com$ {
200         server 2001:db8::1
201 }
202 # One can define a realm without servers, the proxy will then reject
203 # and requests matching this. Optionally one can specify ReplyMessage
204 # attribute to be included in the reject message. One can also use
205 # AccountingResponse option to specify that the proxy should send such.
206 realm /\.com$ {
207 }
208 realm /^anonymous$ {
209         replymessage "No Access"
210 #       AccountingResponse On
211 }
212 # The realm below is equivalent to /.*
213 realm * {
214         server radius.example.com
215 }
216 # If you don't have a default server you probably want to
217 # reject all unknowns. Optionally you can also include a message
218 #realm * {
219 #        replymessage "User unknown"
220 #}