Add cipher_server_preference. Manual port of #1797
[freeradius.git] / raddb / mods-available / eap
1 # -*- text -*-
2 ##
3 ##  eap.conf -- Configuration for EAP types (PEAP, TTLS, etc.)
4 ##
5 ##      $Id$
6
7 #######################################################################
8 #
9 #  Whatever you do, do NOT set 'Auth-Type := EAP'.  The server
10 #  is smart enough to figure this out on its own.  The most
11 #  common side effect of setting 'Auth-Type := EAP' is that the
12 #  users then cannot use ANY other authentication method.
13 #
14 eap {
15         #  Invoke the default supported EAP type when
16         #  EAP-Identity response is received.
17         #
18         #  The incoming EAP messages DO NOT specify which EAP
19         #  type they will be using, so it MUST be set here.
20         #
21         #  For now, only one default EAP type may be used at a time.
22         #
23         #  If the EAP-Type attribute is set by another module,
24         #  then that EAP type takes precedence over the
25         #  default type configured here.
26         #
27         default_eap_type = md5
28
29         #  A list is maintained to correlate EAP-Response
30         #  packets with EAP-Request packets.  After a
31         #  configurable length of time, entries in the list
32         #  expire, and are deleted.
33         #
34         timer_expire     = 60
35
36         #  There are many EAP types, but the server has support
37         #  for only a limited subset.  If the server receives
38         #  a request for an EAP type it does not support, then
39         #  it normally rejects the request.  By setting this
40         #  configuration to "yes", you can tell the server to
41         #  instead keep processing the request.  Another module
42         #  MUST then be configured to proxy the request to
43         #  another RADIUS server which supports that EAP type.
44         #
45         #  If another module is NOT configured to handle the
46         #  request, then the request will still end up being
47         #  rejected.
48         ignore_unknown_eap_types = no
49
50         # Cisco AP1230B firmware 12.2(13)JA1 has a bug.  When given
51         # a User-Name attribute in an Access-Accept, it copies one
52         # more byte than it should.
53         #
54         # We can work around it by configurably adding an extra
55         # zero byte.
56         cisco_accounting_username_bug = no
57
58         #
59         #  Help prevent DoS attacks by limiting the number of
60         #  sessions that the server is tracking.  For simplicity,
61         #  this is taken from the "max_requests" directive in
62         #  radiusd.conf.
63         max_sessions = ${max_requests}
64
65         # Supported EAP-types
66
67         #
68         #  We do NOT recommend using EAP-MD5 authentication
69         #  for wireless connections.  It is insecure, and does
70         #  not provide for dynamic WEP keys.
71         #
72         md5 {
73         }
74
75         #
76         # EAP-pwd -- secure password-based authentication
77         #
78 #       pwd {
79 #               group = 19
80
81                 #
82 #               server_id = theserver@example.com
83
84                 #  This has the same meaning as for TLS.
85 #               fragment_size = 1020
86
87                 # The virtual server which determines the
88                 # "known good" password for the user.
89                 # Note that unlike TLS, only the "authorize"
90                 # section is processed.  EAP-PWD requests can be
91                 # distinguished by having a User-Name, but
92                 # no User-Password, CHAP-Password, EAP-Message, etc.
93 #               virtual_server = "inner-tunnel"
94 #       }
95
96         # Cisco LEAP
97         #
98         #  We do not recommend using LEAP in new deployments.  See:
99         #  http://www.securiteam.com/tools/5TP012ACKE.html
100         #
101         #  Cisco LEAP uses the MS-CHAP algorithm (but not
102         #  the MS-CHAP attributes) to perform it's authentication.
103         #
104         #  As a result, LEAP *requires* access to the plain-text
105         #  User-Password, or the NT-Password attributes.
106         #  'System' authentication is impossible with LEAP.
107         #
108         leap {
109         }
110
111         #  Generic Token Card.
112         #
113         #  Currently, this is only permitted inside of EAP-TTLS,
114         #  or EAP-PEAP.  The module "challenges" the user with
115         #  text, and the response from the user is taken to be
116         #  the User-Password.
117         #
118         #  Proxying the tunneled EAP-GTC session is a bad idea,
119         #  the users password will go over the wire in plain-text,
120         #  for anyone to see.
121         #
122         gtc {
123                 #  The default challenge, which many clients
124                 #  ignore..
125                 #challenge = "Password: "
126
127                 #  The plain-text response which comes back
128                 #  is put into a User-Password attribute,
129                 #  and passed to another module for
130                 #  authentication.  This allows the EAP-GTC
131                 #  response to be checked against plain-text,
132                 #  or crypt'd passwords.
133                 #
134                 #  If you say "Local" instead of "PAP", then
135                 #  the module will look for a User-Password
136                 #  configured for the request, and do the
137                 #  authentication itself.
138                 #
139                 auth_type = PAP
140         }
141
142         ## Common TLS configuration for TLS-based EAP types
143         #
144         #  See raddb/certs/README for additional comments
145         #  on certificates.
146         #
147         #  If OpenSSL was not found at the time the server was
148         #  built, the "tls", "ttls", and "peap" sections will
149         #  be ignored.
150         #
151         #  If you do not currently have certificates signed by
152         #  a trusted CA you may use the 'snakeoil' certificates.
153         #  Included with the server in raddb/certs.
154         #
155         #  If these certificates have not been auto-generated:
156         #    cd raddb/certs
157         #    make
158         #
159         #  These test certificates SHOULD NOT be used in a normal
160         #  deployment.  They are created only to make it easier
161         #  to install the server, and to perform some simple
162         #  tests with EAP-TLS, TTLS, or PEAP.
163         #
164         #  See also:
165         #
166         #  http://www.dslreports.com/forum/remark,9286052~mode=flat
167         #
168         #  Note that you should NOT use a globally known CA here!
169         #  e.g. using a Verisign cert as a "known CA" means that
170         #  ANYONE who has a certificate signed by them can
171         #  authenticate via EAP-TLS!  This is likely not what you want.
172         tls-config tls-common {
173                 private_key_password = whatever
174                 private_key_file = ${certdir}/server.pem
175
176                 #  If Private key & Certificate are located in
177                 #  the same file, then private_key_file &
178                 #  certificate_file must contain the same file
179                 #  name.
180                 #
181                 #  If ca_file (below) is not used, then the
182                 #  certificate_file below MUST include not
183                 #  only the server certificate, but ALSO all
184                 #  of the CA certificates used to sign the
185                 #  server certificate.
186                 certificate_file = ${certdir}/server.pem
187
188                 #  Trusted Root CA list
189                 #
190                 #  ALL of the CA's in this list will be trusted
191                 #  to issue client certificates for authentication.
192                 #
193                 #  In general, you should use self-signed
194                 #  certificates for 802.1x (EAP) authentication.
195                 #  In that case, this CA file should contain
196                 #  *one* CA certificate.
197                 #
198                 ca_file = ${cadir}/ca.pem
199
200                 #  OpenSSL will automatically create certificate chains,
201                 #  unless we tell it to not do that.  The problem is that
202                 #  it sometimes gets the chains right from a certificate
203                 #  signature view, but wrong from the clients view.
204                 #
205                 #  When setting "auto_chain = no", the server certificate
206                 #  file MUST include the full certificate chain.
207         #       auto_chain = yes
208
209                 #
210                 #  If OpenSSL supports TLS-PSK, then we can use
211                 #  a PSK identity and (hex) password.  When the
212                 #  following two configuration items are specified,
213                 #  then certificate-based configuration items are
214                 #  not allowed.  e.g.:
215                 #
216                 #       private_key_password
217                 #       private_key_file
218                 #       certificate_file
219                 #       ca_file
220                 #       ca_path
221                 #
222                 #  For now, the identity is fixed, and must be the
223                 #  same on the client.  The passphrase must be a hex
224                 #  value, and can be up to 256 hex digits.
225                 #
226                 #  Future versions of the server may be able to
227                 #  look up the shared key (hexphrase) based on the
228                 #  identity.
229                 #
230         #       psk_identity = "test"
231         #       psk_hexphrase = "036363823"
232
233                 #
234                 #  For DH cipher suites to work, you have to
235                 #  run OpenSSL to create the DH file first:
236                 #
237                 #       openssl dhparam -out certs/dh 2048
238                 #
239                 dh_file = ${certdir}/dh
240
241                 #
242                 #  If your system doesn't have /dev/urandom,
243                 #  you will need to create this file, and
244                 #  periodically change its contents.
245                 #
246                 #  For security reasons, FreeRADIUS doesn't
247                 #  write to files in its configuration
248                 #  directory.
249                 #
250         #       random_file = /dev/urandom
251
252                 #
253                 #  This can never exceed the size of a RADIUS
254                 #  packet (4096 bytes), and is preferably half
255                 #  that, to accommodate other attributes in
256                 #  RADIUS packet.  On most APs the MAX packet
257                 #  length is configured between 1500 - 1600
258                 #  In these cases, fragment size should be
259                 #  1024 or less.
260                 #
261         #       fragment_size = 1024
262
263                 #  include_length is a flag which is
264                 #  by default set to yes If set to
265                 #  yes, Total Length of the message is
266                 #  included in EVERY packet we send.
267                 #  If set to no, Total Length of the
268                 #  message is included ONLY in the
269                 #  First packet of a fragment series.
270                 #
271         #       include_length = yes
272
273
274                 #  Check the Certificate Revocation List
275                 #
276                 #  1) Copy CA certificates and CRLs to same directory.
277                 #  2) Execute 'c_rehash <CA certs&CRLs Directory>'.
278                 #    'c_rehash' is OpenSSL's command.
279                 #  3) uncomment the lines below.
280                 #  5) Restart radiusd
281         #       check_crl = yes
282
283                 # Check if intermediate CAs have been revoked.
284         #       check_all_crl = yes
285
286                 ca_path = ${cadir}
287
288                 #
289                 #  If check_cert_issuer is set, the value will
290                 #  be checked against the DN of the issuer in
291                 #  the client certificate.  If the values do not
292                 #  match, the certificate verification will fail,
293                 #  rejecting the user.
294                 #
295                 #  In 2.1.10 and later, this check can be done
296                 #  more generally by checking the value of the
297                 #  TLS-Client-Cert-Issuer attribute.  This check
298                 #  can be done via any mechanism you choose.
299                 #
300         #       check_cert_issuer = "/C=GB/ST=Berkshire/L=Newbury/O=My Company Ltd"
301
302                 #
303                 #  If check_cert_cn is set, the value will
304                 #  be xlat'ed and checked against the CN
305                 #  in the client certificate.  If the values
306                 #  do not match, the certificate verification
307                 #  will fail rejecting the user.
308                 #
309                 #  This check is done only if the previous
310                 #  "check_cert_issuer" is not set, or if
311                 #  the check succeeds.
312                 #
313                 #  In 2.1.10 and later, this check can be done
314                 #  more generally by checking the value of the
315                 #  TLS-Client-Cert-CN attribute.  This check
316                 #  can be done via any mechanism you choose.
317                 #
318         #       check_cert_cn = %{User-Name}
319                 #
320                 # Set this option to specify the allowed
321                 # TLS cipher suites.  The format is listed
322                 # in "man 1 ciphers".
323                 #
324                 # For EAP-FAST, use "ALL:!EXPORT:!eNULL:!SSLv2"
325                 #
326                 cipher_list = "DEFAULT"
327
328                 # If enabled, OpenSSL will use server cipher list
329                 # (possibly defined by cipher_list option above)
330                 # for choosing right cipher suite rather than
331                 # using client-specified list which is OpenSSl default
332                 # behavior. Having it set to yes is a current best practice
333                 # for TLS
334                 cipher_server_preference = no
335
336                 # Work-arounds for OpenSSL nonsense
337                 # OpenSSL 1.0.1f and 1.0.1g do not calculate
338                 # the EAP keys correctly.  The fix is to upgrade
339                 # OpenSSL, or disable TLS 1.2 here. 
340                 #
341                 #  For EAP-FAST, this MUST be set to "yes".
342                 #
343 #               disable_tlsv1_2 = no
344
345                 #
346
347                 #
348                 #  Elliptical cryptography configuration
349                 #
350                 #  Only for OpenSSL >= 0.9.8.f
351                 #
352                 ecdh_curve = "prime256v1"
353
354                 #
355                 #  Session resumption / fast reauthentication
356                 #  cache.
357                 #
358                 #  The cache contains the following information:
359                 #
360                 #  session Id - unique identifier, managed by SSL
361                 #  User-Name  - from the Access-Accept
362                 #  Stripped-User-Name - from the Access-Request
363                 #  Cached-Session-Policy - from the Access-Accept
364                 #
365                 #  The "Cached-Session-Policy" is the name of a
366                 #  policy which should be applied to the cached
367                 #  session.  This policy can be used to assign
368                 #  VLANs, IP addresses, etc.  It serves as a useful
369                 #  way to re-apply the policy from the original
370                 #  Access-Accept to the subsequent Access-Accept
371                 #  for the cached session.
372                 #
373                 #  On session resumption, these attributes are
374                 #  copied from the cache, and placed into the
375                 #  reply list.
376                 #
377                 #  You probably also want "use_tunneled_reply = yes"
378                 #  when using fast session resumption.
379                 #
380                 cache {
381                         #
382                         #  Enable it.  The default is "no". Deleting the entire "cache"
383                         #  subsection also disables caching.
384                         #
385                         #  You can disallow resumption for a particular user by adding the
386                         #  following attribute to the control item list:
387                         #
388                         #    Allow-Session-Resumption = No
389                         #
390                         #  If "enable = no" below, you CANNOT enable resumption for just one
391                         #  user by setting the above attribute to "yes".
392                         #
393                         enable = yes
394
395                         #
396                         #  Lifetime of the cached entries, in hours. The sessions will be
397                         #  deleted/invalidated after this time.
398                         #
399                         lifetime = 24 # hours
400
401                         #
402                         #  The maximum number of entries in the
403                         #  cache.  Set to "0" for "infinite".
404                         #
405                         #  This could be set to the number of users
406                         #  who are logged in... which can be a LOT.
407                         #
408                         max_entries = 255
409
410                         #
411                         #  Internal "name" of the session cache. Used to
412                         #  distinguish which TLS context sessions belong to.
413                         #
414                         #  The server will generate a random value if unset.
415                         #  This will change across server restart so you MUST
416                         #  set the "name" if you want to persist sessions (see
417                         #  below).
418                         #
419                         #name = "EAP module"
420
421                         #
422                         #  Simple directory-based storage of sessions.
423                         #  Two files per session will be written, the SSL
424                         #  state and the cached VPs. This will persist session
425                         #  across server restarts.
426                         #
427                         #  The server will need write perms, and the directory
428                         #  should be secured from anyone else. You might want
429                         #  a script to remove old files from here periodically:
430                         #
431                         #    find ${logdir}/tlscache -mtime +2 -exec rm -f {} \;
432                         #
433                         #  This feature REQUIRES "name" option be set above.
434                         #
435                         #persist_dir = "${logdir}/tlscache"
436                 }
437
438                 #
439                 #  As of version 2.1.10, client certificates can be
440                 #  validated via an external command.  This allows
441                 #  dynamic CRLs or OCSP to be used.
442                 #
443                 #  This configuration is commented out in the
444                 #  default configuration.  Uncomment it, and configure
445                 #  the correct paths below to enable it.
446                 #
447                 #  If OCSP checking is enabled, and the OCSP checks fail,
448                 #  the verify section is not run.
449                 #
450                 #  If OCSP checking is disabled, the verify section is
451                 #  run on successful certificate validation.
452                 #
453                 verify {
454                         #  If the OCSP checks succeed, the verify section
455                         #  is run to allow additional checks.
456                         #
457                         #  If you want to skip verify on OCSP success,
458                         #  uncomment this configuration item, and set it
459                         #  to "yes".
460         #               skip_if_ocsp_ok = no
461
462                         #  A temporary directory where the client
463                         #  certificates are stored.  This directory
464                         #  MUST be owned by the UID of the server,
465                         #  and MUST not be accessible by any other
466                         #  users.  When the server starts, it will do
467                         #  "chmod go-rwx" on the directory, for
468                         #  security reasons.  The directory MUST
469                         #  exist when the server starts.
470                         #
471                         #  You should also delete all of the files
472                         #  in the directory when the server starts.
473         #               tmpdir = /tmp/radiusd
474
475                         #  The command used to verify the client cert.
476                         #  We recommend using the OpenSSL command-line
477                         #  tool.
478                         #
479                         #  The ${..ca_path} text is a reference to
480                         #  the ca_path variable defined above.
481                         #
482                         #  The %{TLS-Client-Cert-Filename} is the name
483                         #  of the temporary file containing the cert
484                         #  in PEM format.  This file is automatically
485                         #  deleted by the server when the command
486                         #  returns.
487         #               client = "/path/to/openssl verify -CApath ${..ca_path} %{TLS-Client-Cert-Filename}"
488                 }
489
490                 #
491                 #  OCSP Configuration
492                 #  Certificates can be verified against an OCSP
493                 #  Responder. This makes it possible to immediately
494                 #  revoke certificates without the distribution of
495                 #  new Certificate Revocation Lists (CRLs).
496                 #
497                 ocsp {
498                         #
499                         #  Enable it.  The default is "no".
500                         #  Deleting the entire "ocsp" subsection
501                         #  also disables ocsp checking
502                         #
503                         enable = no
504
505                         #
506                         #  The OCSP Responder URL can be automatically
507                         #  extracted from the certificate in question.
508                         #  To override the OCSP Responder URL set
509                         #  "override_cert_url = yes".
510                         #
511                         override_cert_url = yes
512
513                         #
514                         #  If the OCSP Responder address is not extracted from
515                         #  the certificate, the URL can be defined here.
516                         #
517                         url = "http://127.0.0.1/ocsp/"
518
519                         #
520                         # If the OCSP Responder can not cope with nonce
521                         # in the request, then it can be disabled here.
522                         #
523                         # For security reasons, disabling this option
524                         # is not recommended as nonce protects against
525                         # replay attacks.
526                         #
527                         # Note that Microsoft AD Certificate Services OCSP
528                         # Responder does not enable nonce by default. It is
529                         # more secure to enable nonce on the responder than
530                         # to disable it in the query here.
531                         # See http://technet.microsoft.com/en-us/library/cc770413%28WS.10%29.aspx
532                         #
533                         # use_nonce = yes
534
535                         #
536                         # Number of seconds before giving up waiting
537                         # for OCSP response. 0 uses system default.
538                         #
539                         # timeout = 0
540
541                         #
542                         # Normally an error in querying the OCSP
543                         # responder (no response from server, server did
544                         # not understand the request, etc) will result in
545                         # a validation failure.
546                         #
547                         # To treat these errors as 'soft' failures and
548                         # still accept the certificate, enable this
549                         # option.
550                         #
551                         # Warning: this may enable clients with revoked
552                         # certificates to connect if the OCSP responder
553                         # is not available. Use with caution.
554                         #
555                         # softfail = no
556                 }
557         }
558
559         ## EAP-TLS
560         #
561         #  As of Version 3.0, the TLS configuration for TLS-based
562         #  EAP types is above in the "tls-config" section.
563         #
564         tls {
565                 # Point to the common TLS configuration
566                 tls = tls-common
567
568                 #
569                 # As part of checking a client certificate, the EAP-TLS
570                 # sets some attributes such as TLS-Client-Cert-CN. This
571                 # virtual server has access to these attributes, and can
572                 # be used to accept or reject the request.
573                 #
574         #       virtual_server = check-eap-tls
575         }
576
577
578         ## EAP-TTLS
579         #
580         #  The TTLS module implements the EAP-TTLS protocol,
581         #  which can be described as EAP inside of Diameter,
582         #  inside of TLS, inside of EAP, inside of RADIUS...
583         #
584         #  Surprisingly, it works quite well.
585         #
586         ttls {
587                 #  Which tls-config section the TLS negotiation parameters
588                 #  are in - see EAP-TLS above for an explanation.
589                 #
590                 #  In the case that an old configuration from FreeRADIUS
591                 #  v2.x is being used, all the options of the tls-config
592                 #  section may also appear instead in the 'tls' section
593                 #  above. If that is done, the tls= option here (and in
594                 #  tls above) MUST be commented out.
595                 #
596                 tls = tls-common
597
598                 #  The tunneled EAP session needs a default EAP type
599                 #  which is separate from the one for the non-tunneled
600                 #  EAP module.  Inside of the TTLS tunnel, we recommend
601                 #  using EAP-MD5.  If the request does not contain an
602                 #  EAP conversation, then this configuration entry is
603                 #  ignored.
604                 #
605                 default_eap_type = md5
606
607                 #  The tunneled authentication request does not usually
608                 #  contain useful attributes like 'Calling-Station-Id',
609                 #  etc.  These attributes are outside of the tunnel,
610                 #  and normally unavailable to the tunneled
611                 #  authentication request.
612                 #
613                 #  By setting this configuration entry to 'yes',
614                 #  any attribute which is NOT in the tunneled
615                 #  authentication request, but which IS available
616                 #  outside of the tunnel, is copied to the tunneled
617                 #  request.
618                 #
619                 #  allowed values: {no, yes}
620                 #
621                 copy_request_to_tunnel = no
622
623                 #
624                 #  As of version 3.0.5, this configuration item
625                 #  is deprecated.  Instead, you should use
626                 #
627                 #       update outer.session-state {
628                 #               ...
629                 #
630                 #       }
631                 #
632                 #  This will cache attributes for the final Access-Accept.
633                 #
634                 #  The reply attributes sent to the NAS are usually
635                 #  based on the name of the user 'outside' of the
636                 #  tunnel (usually 'anonymous').  If you want to send
637                 #  the reply attributes based on the user name inside
638                 #  of the tunnel, then set this configuration entry to
639                 #  'yes', and the reply to the NAS will be taken from
640                 #  the reply to the tunneled request.
641                 #
642                 #  allowed values: {no, yes}
643                 #
644                 use_tunneled_reply = no
645
646                 #
647                 #  The inner tunneled request can be sent
648                 #  through a virtual server constructed
649                 #  specifically for this purpose.
650                 #
651                 #  If this entry is commented out, the inner
652                 #  tunneled request will be sent through
653                 #  the virtual server that processed the
654                 #  outer requests.
655                 #
656                 virtual_server = "inner-tunnel"
657
658                 #  This has the same meaning, and overwrites, the
659                 #  same field in the "tls" configuration, above.
660                 #  The default value here is "yes".
661                 #
662         #       include_length = yes
663
664                 #
665                 # Unlike EAP-TLS, EAP-TTLS does not require a client
666                 # certificate. However, you can require one by setting the
667                 # following option. You can also override this option by
668                 # setting
669                 #
670                 #       EAP-TLS-Require-Client-Cert = Yes
671                 #
672                 # in the control items for a request.
673                 #
674         #       require_client_cert = yes
675         }
676
677
678         ## EAP-PEAP
679         #
680
681         ##################################################
682         #
683         #  !!!!! WARNINGS for Windows compatibility  !!!!!
684         #
685         ##################################################
686         #
687         #  If you see the server send an Access-Challenge,
688         #  and the client never sends another Access-Request,
689         #  then
690         #
691         #               STOP!
692         #
693         #  The server certificate has to have special OID's
694         #  in it, or else the Microsoft clients will silently
695         #  fail.  See the "scripts/xpextensions" file for
696         #  details, and the following page:
697         #
698         #       http://support.microsoft.com/kb/814394/en-us
699         #
700         #  For additional Windows XP SP2 issues, see:
701         #
702         #       http://support.microsoft.com/kb/885453/en-us
703         #
704         #
705         #  If is still doesn't work, and you're using Samba,
706         #  you may be encountering a Samba bug.  See:
707         #
708         #       https://bugzilla.samba.org/show_bug.cgi?id=6563
709         #
710         #  Note that we do not necessarily agree with their
711         #  explanation... but the fix does appear to work.
712         #
713         ##################################################
714
715         #
716         #  The tunneled EAP session needs a default EAP type
717         #  which is separate from the one for the non-tunneled
718         #  EAP module.  Inside of the TLS/PEAP tunnel, we
719         #  recommend using EAP-MS-CHAPv2.
720         #
721         peap {
722                 #  Which tls-config section the TLS negotiation parameters
723                 #  are in - see EAP-TLS above for an explanation.
724                 #
725                 #  In the case that an old configuration from FreeRADIUS
726                 #  v2.x is being used, all the options of the tls-config
727                 #  section may also appear instead in the 'tls' section
728                 #  above. If that is done, the tls= option here (and in
729                 #  tls above) MUST be commented out.
730                 #
731                 tls = tls-common
732
733                 #  The tunneled EAP session needs a default
734                 #  EAP type which is separate from the one for
735                 #  the non-tunneled EAP module.  Inside of the
736                 #  PEAP tunnel, we recommend using MS-CHAPv2,
737                 #  as that is the default type supported by
738                 #  Windows clients.
739                 #
740                 default_eap_type = mschapv2
741
742                 #  The PEAP module also has these configuration
743                 #  items, which are the same as for TTLS.
744                 #
745                 copy_request_to_tunnel = no
746
747                 #
748                 #  As of version 3.0.5, this configuration item
749                 #  is deprecated.  Instead, you should use
750                 #
751                 #       update outer.session-state {
752                 #               ...
753                 #
754                 #       }
755                 #
756                 #  This will cache attributes for the final Access-Accept.
757                 #
758                 use_tunneled_reply = no
759
760                 #  When the tunneled session is proxied, the
761                 #  home server may not understand EAP-MSCHAP-V2.
762                 #  Set this entry to "no" to proxy the tunneled
763                 #  EAP-MSCHAP-V2 as normal MSCHAPv2.
764                 #
765         #       proxy_tunneled_request_as_eap = yes
766
767                 #
768                 #  The inner tunneled request can be sent
769                 #  through a virtual server constructed
770                 #  specifically for this purpose.
771                 #
772                 #  If this entry is commented out, the inner
773                 #  tunneled request will be sent through
774                 #  the virtual server that processed the
775                 #  outer requests.
776                 #
777                 virtual_server = "inner-tunnel"
778
779                 # This option enables support for MS-SoH
780                 # see doc/SoH.txt for more info.
781                 # It is disabled by default.
782                 #
783         #       soh = yes
784
785                 #
786                 # The SoH reply will be turned into a request which
787                 # can be sent to a specific virtual server:
788                 #
789         #       soh_virtual_server = "soh-server"
790
791                 #
792                 # Unlike EAP-TLS, PEAP does not require a client certificate.
793                 # However, you can require one by setting the following
794                 # option. You can also override this option by setting
795                 #
796                 #       EAP-TLS-Require-Client-Cert = Yes
797                 #
798                 # in the control items for a request.
799                 #
800         #       require_client_cert = yes
801         }
802
803         #
804         #  This takes no configuration.
805         #
806         #  Note that it is the EAP MS-CHAPv2 sub-module, not
807         #  the main 'mschap' module.
808         #
809         #  Note also that in order for this sub-module to work,
810         #  the main 'mschap' module MUST ALSO be configured.
811         #
812         #  This module is the *Microsoft* implementation of MS-CHAPv2
813         #  in EAP.  There is another (incompatible) implementation
814         #  of MS-CHAPv2 in EAP by Cisco, which FreeRADIUS does not
815         #  currently support.
816         #
817         mschapv2 {
818                 #  Prior to version 2.1.11, the module never
819                 #  sent the MS-CHAP-Error message to the
820                 #  client.  This worked, but it had issues
821                 #  when the cached password was wrong.  The
822                 #  server *should* send "E=691 R=0" to the
823                 #  client, which tells it to prompt the user
824                 #  for a new password.
825                 #
826                 #  The default is to behave as in 2.1.10 and
827                 #  earlier, which is known to work.  If you
828                 #  set "send_error = yes", then the error
829                 #  message will be sent back to the client.
830                 #  This *may* help some clients work better,
831                 #  but *may* also cause other clients to stop
832                 #  working.
833                 #
834 #               send_error = no
835
836                 #  Server identifier to send back in the challenge.
837                 #  This should generally be the host name of the
838                 #  RADIUS server.  Or, some information to uniquely
839                 #  identify it.
840 #               identity = "FreeRADIUS"
841         }
842
843         ## EAP-FAST
844         #
845         #  The FAST module implements the EAP-FAST protocol
846         #
847 #       fast {
848                 # Point to the common TLS configuration
849                 #
850                 # cipher_list though must include "ADH" for anonymous provisioning.
851                 # This is not as straight forward as appending "ADH" alongside
852                 # "DEFAULT" as "DEFAULT" contains "!aNULL" so instead it is
853                 # recommended "ALL:!EXPORT:!eNULL:!SSLv2" is used
854                 #
855 #               tls = tls-common
856
857                 # PAC lifetime in seconds (default: seven days)
858                 #
859 #               pac_lifetime = 604800
860
861                 # Authority ID of the server
862                 #
863                 # if you are running a cluster of RADIUS servers, you should make
864                 # the value chosen here (and for "pac_opaque_key") the same on all
865                 # your RADIUS servers.  This value should be unique to your
866                 # installation.  We suggest using a domain name.
867                 #
868 #               authority_identity = "1234"
869
870                 # PAC Opaque encryption key (must be exactly 32 bytes in size)
871                 #
872                 # This value MUST be secret, and MUST be generated using
873                 # a secure method, such as via 'openssl rand -hex 32'
874                 #
875 #               pac_opaque_key = "0123456789abcdef0123456789ABCDEF"
876
877                 # Same as for TTLS, PEAP, etc.
878                 #
879 #               virtual_server = inner-tunnel
880 #       }
881 }