3 ## eap.conf -- Configuration for EAP types (PEAP, TTLS, etc.)
7 #######################################################################
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.
14 # EAP types NOT listed here may be supported via the "eap2" module.
15 # See experimental.conf for documentation.
18 # Invoke the default supported EAP type when
19 # EAP-Identity response is received.
21 # The incoming EAP messages DO NOT specify which EAP
22 # type they will be using, so it MUST be set here.
24 # For now, only one default EAP type may be used at a time.
26 # If the EAP-Type attribute is set by another module,
27 # then that EAP type takes precedence over the
28 # default type configured here.
30 default_eap_type = md5
32 # A list is maintained to correlate EAP-Response
33 # packets with EAP-Request packets. After a
34 # configurable length of time, entries in the list
35 # expire, and are deleted.
39 # There are many EAP types, but the server has support
40 # for only a limited subset. If the server receives
41 # a request for an EAP type it does not support, then
42 # it normally rejects the request. By setting this
43 # configuration to "yes", you can tell the server to
44 # instead keep processing the request. Another module
45 # MUST then be configured to proxy the request to
46 # another RADIUS server which supports that EAP type.
48 # If another module is NOT configured to handle the
49 # request, then the request will still end up being
51 ignore_unknown_eap_types = no
53 # Cisco AP1230B firmware 12.2(13)JA1 has a bug. When given
54 # a User-Name attribute in an Access-Accept, it copies one
55 # more byte than it should.
57 # We can work around it by configurably adding an extra
59 cisco_accounting_username_bug = no
62 # Help prevent DoS attacks by limiting the number of
63 # sessions that the server is tracking. For simplicity,
64 # this is taken from the "max_requests" directive in
66 max_sessions = ${max_requests}
71 # We do NOT recommend using EAP-MD5 authentication
72 # for wireless connections. It is insecure, and does
73 # not provide for dynamic WEP keys.
79 # EAP-pwd -- secure password-based authentication
85 # server_id = theserver@example.com
87 # This has the same meaning as for TLS.
88 # fragment_size = 1020
90 # The virtual server which determines the
91 # "known good" password for the user.
92 # Note that unlike TLS, only the "authorize"
93 # section is processed. EAP-PWD requests can be
94 # distinguished by having a User-Name, but
95 # no User-Password, CHAP-Password, EAP-Message, etc.
96 # virtual_server = "inner-tunnel"
101 # We do not recommend using LEAP in new deployments. See:
102 # http://www.securiteam.com/tools/5TP012ACKE.html
104 # Cisco LEAP uses the MS-CHAP algorithm (but not
105 # the MS-CHAP attributes) to perform it's authentication.
107 # As a result, LEAP *requires* access to the plain-text
108 # User-Password, or the NT-Password attributes.
109 # 'System' authentication is impossible with LEAP.
114 # Generic Token Card.
116 # Currently, this is only permitted inside of EAP-TTLS,
117 # or EAP-PEAP. The module "challenges" the user with
118 # text, and the response from the user is taken to be
121 # Proxying the tunneled EAP-GTC session is a bad idea,
122 # the users password will go over the wire in plain-text,
126 # The default challenge, which many clients
128 #challenge = "Password: "
130 # The plain-text response which comes back
131 # is put into a User-Password attribute,
132 # and passed to another module for
133 # authentication. This allows the EAP-GTC
134 # response to be checked against plain-text,
135 # or crypt'd passwords.
137 # If you say "Local" instead of "PAP", then
138 # the module will look for a User-Password
139 # configured for the request, and do the
140 # authentication itself.
145 ## Common TLS configuration for TLS-based EAP types
147 # See raddb/certs/README for additional comments
150 # If OpenSSL was not found at the time the server was
151 # built, the "tls", "ttls", and "peap" sections will
154 # If you do not currently have certificates signed by
155 # a trusted CA you may use the 'snakeoil' certificates.
156 # Included with the server in raddb/certs.
158 # If these certificates have not been auto-generated:
162 # These test certificates SHOULD NOT be used in a normal
163 # deployment. They are created only to make it easier
164 # to install the server, and to perform some simple
165 # tests with EAP-TLS, TTLS, or PEAP.
169 # http://www.dslreports.com/forum/remark,9286052~mode=flat
171 # Note that you should NOT use a globally known CA here!
172 # e.g. using a Verisign cert as a "known CA" means that
173 # ANYONE who has a certificate signed by them can
174 # authenticate via EAP-TLS! This is likely not what you want.
175 tls-config tls-common {
176 private_key_password = whatever
177 private_key_file = ${certdir}/server.pem
179 # If Private key & Certificate are located in
180 # the same file, then private_key_file &
181 # certificate_file must contain the same file
184 # If ca_file (below) is not used, then the
185 # certificate_file below MUST include not
186 # only the server certificate, but ALSO all
187 # of the CA certificates used to sign the
188 # server certificate.
189 certificate_file = ${certdir}/server.pem
191 # Trusted Root CA list
193 # ALL of the CA's in this list will be trusted
194 # to issue client certificates for authentication.
196 # In general, you should use self-signed
197 # certificates for 802.1x (EAP) authentication.
198 # In that case, this CA file should contain
199 # *one* CA certificate.
201 ca_file = ${cadir}/ca.pem
204 # If OpenSSL supports TLS-PSK, then we can use
205 # a PSK identity and (hex) password. When the
206 # following two configuration items are specified,
207 # then certificate-based configuration items are
210 # private_key_password
216 # For now, the identity is fixed, and must be the
217 # same on the client. The passphrase must be a hex
218 # value, and can be up to 256 hex digits.
220 # Future versions of the server may be able to
221 # look up the shared key (hexphrase) based on the
224 # psk_identity = "test"
225 # psk_hexphrase = "036363823"
228 # For DH cipher suites to work, you have to
229 # run OpenSSL to create the DH file first:
231 # openssl dhparam -out certs/dh 1024
233 dh_file = ${certdir}/dh
236 # If your system doesn't have /dev/urandom,
237 # you will need to create this file, and
238 # periodically change its contents.
240 # For security reasons, FreeRADIUS doesn't
241 # write to files in its configuration
244 # random_file = /dev/urandom
247 # This can never exceed the size of a RADIUS
248 # packet (4096 bytes), and is preferably half
249 # that, to accommodate other attributes in
250 # RADIUS packet. On most APs the MAX packet
251 # length is configured between 1500 - 1600
252 # In these cases, fragment size should be
255 # fragment_size = 1024
257 # include_length is a flag which is
258 # by default set to yes If set to
259 # yes, Total Length of the message is
260 # included in EVERY packet we send.
261 # If set to no, Total Length of the
262 # message is included ONLY in the
263 # First packet of a fragment series.
265 # include_length = yes
267 # Check the Certificate Revocation List
269 # 1) Copy CA certificates and CRLs to same directory.
270 # 2) Execute 'c_rehash <CA certs&CRLs Directory>'.
271 # 'c_rehash' is OpenSSL's command.
272 # 3) uncomment the line below.
278 # If check_cert_issuer is set, the value will
279 # be checked against the DN of the issuer in
280 # the client certificate. If the values do not
281 # match, the certificate verification will fail,
282 # rejecting the user.
284 # In 2.1.10 and later, this check can be done
285 # more generally by checking the value of the
286 # TLS-Client-Cert-Issuer attribute. This check
287 # can be done via any mechanism you choose.
289 # check_cert_issuer = "/C=GB/ST=Berkshire/L=Newbury/O=My Company Ltd"
292 # If check_cert_cn is set, the value will
293 # be xlat'ed and checked against the CN
294 # in the client certificate. If the values
295 # do not match, the certificate verification
296 # will fail rejecting the user.
298 # This check is done only if the previous
299 # "check_cert_issuer" is not set, or if
300 # the check succeeds.
302 # In 2.1.10 and later, this check can be done
303 # more generally by checking the value of the
304 # TLS-Client-Cert-CN attribute. This check
305 # can be done via any mechanism you choose.
307 # check_cert_cn = %{User-Name}
309 # Set this option to specify the allowed
310 # TLS cipher suites. The format is listed
311 # in "man 1 ciphers".
312 cipher_list = "DEFAULT"
317 # Elliptical cryptography configuration
319 # Only for OpenSSL >= 0.9.8.f
321 ecdh_curve = "prime256v1"
324 # Session resumption / fast reauthentication
327 # The cache contains the following information:
329 # session Id - unique identifier, managed by SSL
330 # User-Name - from the Access-Accept
331 # Stripped-User-Name - from the Access-Request
332 # Cached-Session-Policy - from the Access-Accept
334 # The "Cached-Session-Policy" is the name of a
335 # policy which should be applied to the cached
336 # session. This policy can be used to assign
337 # VLANs, IP addresses, etc. It serves as a useful
338 # way to re-apply the policy from the original
339 # Access-Accept to the subsequent Access-Accept
340 # for the cached session.
342 # On session resumption, these attributes are
343 # copied from the cache, and placed into the
346 # You probably also want "use_tunneled_reply = yes"
347 # when using fast session resumption.
351 # Enable it. The default is "no". Deleting the entire "cache"
352 # subsection also disables caching.
354 # You can disallow resumption for a particular user by adding the
355 # following attribute to the control item list:
357 # Allow-Session-Resumption = No
359 # If "enable = no" below, you CANNOT enable resumption for just one
360 # user by setting the above attribute to "yes".
365 # Internal "name" of the session cache. Used to distinguish which
366 # TLS context sessions belong to.
368 # The server will generate a random value if unset. This will change
369 # across server restart so you MUST set the "name" if you want to
370 # persist sessions (see below).
372 # name = "EAP module"
375 # Lifetime of the cached entries, in hours. The sessions will be
376 # deleted/invalidated after this time.
378 lifetime = 24 # hours
381 # The maximum number of entries in the
382 # cache. Set to "0" for "infinite".
384 # This could be set to the number of users
385 # who are logged in... which can be a LOT.
390 # Internal "name" of the session cache.
391 # Used to distinguish which TLS context
392 # sessions belong to.
394 # The server will generate a random value
395 # if unset. This will change across server
396 # restart so you MUST set the "name" if you
397 # want to persist sessions (see below).
402 # Simple directory-based storage of sessions.
403 # Two files per session will be written, the SSL
404 # state and the cached VPs. This will persist session
405 # across server restarts.
407 # The server will need write perms, and the directory
408 # should be secured from anyone else. You might want
409 # a script to remove old files from here periodically:
411 # find ${logdir}/tlscache -mtime +2 -exec rm -f {} \;
413 # This feature REQUIRES "name" option be set above.
415 #persist_dir = "${logdir}/tlscache"
419 # As of version 2.1.10, client certificates can be
420 # validated via an external command. This allows
421 # dynamic CRLs or OCSP to be used.
423 # This configuration is commented out in the
424 # default configuration. Uncomment it, and configure
425 # the correct paths below to enable it.
428 # A temporary directory where the client
429 # certificates are stored. This directory
430 # MUST be owned by the UID of the server,
431 # and MUST not be accessible by any other
432 # users. When the server starts, it will do
433 # "chmod go-rwx" on the directory, for
434 # security reasons. The directory MUST
435 # exist when the server starts.
437 # You should also delete all of the files
438 # in the directory when the server starts.
439 # tmpdir = /tmp/radiusd
441 # The command used to verify the client cert.
442 # We recommend using the OpenSSL command-line
445 # The ${..ca_path} text is a reference to
446 # the ca_path variable defined above.
448 # The %{TLS-Client-Cert-Filename} is the name
449 # of the temporary file containing the cert
450 # in PEM format. This file is automatically
451 # deleted by the server when the command
453 # client = "/path/to/openssl verify -CApath ${..ca_path} %{TLS-Client-Cert-Filename}"
458 # Certificates can be verified against an OCSP
459 # Responder. This makes it possible to immediately
460 # revoke certificates without the distribution of
461 # new Certificate Revocation Lists (CRLs).
465 # Enable it. The default is "no".
466 # Deleting the entire "ocsp" subsection
467 # also disables ocsp checking
472 # The OCSP Responder URL can be automatically
473 # extracted from the certificate in question.
474 # To override the OCSP Responder URL set
475 # "override_cert_url = yes".
477 override_cert_url = yes
480 # If the OCSP Responder address is not extracted from
481 # the certificate, the URL can be defined here.
483 url = "http://127.0.0.1/ocsp/"
486 # If the OCSP Responder can not cope with nonce
487 # in the request, then it can be disabled here.
489 # For security reasons, disabling this option
490 # is not recommended as nonce protects against
493 # Note that Microsoft AD Certificate Services OCSP
494 # Responder does not enable nonce by default. It is
495 # more secure to enable nonce on the responder than
496 # to disable it in the query here.
497 # See http://technet.microsoft.com/en-us/library/cc770413%28WS.10%29.aspx
502 # Number of seconds before giving up waiting
503 # for OCSP response. 0 uses system default.
508 # Normally an error in querying the OCSP
509 # responder (no response from server, server did
510 # not understand the request, etc) will result in
511 # a validation failure.
513 # To treat these errors as 'soft' failures and
514 # still accept the certificate, enable this
517 # Warning: this may enable clients with revoked
518 # certificates to connect if the OCSP responder
519 # is not available. Use with caution.
527 # As of Version 3.0, the TLS configuration for TLS-based
528 # EAP types is above in the "tls-config" section.
531 # Point to the common TLS configuration
535 # As part of checking a client certificate, the EAP-TLS
536 # sets some attributes such as TLS-Client-Cert-CN. This
537 # virtual server has access to these attributes, and can
538 # be used to accept or reject the request.
540 # virtual_server = check-eap-tls
546 # The TTLS module implements the EAP-TTLS protocol,
547 # which can be described as EAP inside of Diameter,
548 # inside of TLS, inside of EAP, inside of RADIUS...
550 # Surprisingly, it works quite well.
553 # Which tls-config section the TLS negotiation parameters
554 # are in - see EAP-TLS above for an explanation.
556 # In the case that an old configuration from FreeRADIUS
557 # v2.x is being used, all the options of the tls-config
558 # section may also appear instead in the 'tls' section
559 # above. If that is done, the tls= option here (and in
560 # tls above) MUST be commented out.
564 # The tunneled EAP session needs a default EAP type
565 # which is separate from the one for the non-tunneled
566 # EAP module. Inside of the TTLS tunnel, we recommend
567 # using EAP-MD5. If the request does not contain an
568 # EAP conversation, then this configuration entry is
571 default_eap_type = md5
573 # The tunneled authentication request does not usually
574 # contain useful attributes like 'Calling-Station-Id',
575 # etc. These attributes are outside of the tunnel,
576 # and normally unavailable to the tunneled
577 # authentication request.
579 # By setting this configuration entry to 'yes',
580 # any attribute which is NOT in the tunneled
581 # authentication request, but which IS available
582 # outside of the tunnel, is copied to the tunneled
585 # allowed values: {no, yes}
587 copy_request_to_tunnel = no
590 # As of version 3.0.5, this configuration item
591 # is deprecated. Instead, you should use
593 # update outer.session-state {
598 # This will cache attributes for the final Access-Accept.
600 # The reply attributes sent to the NAS are usually
601 # based on the name of the user 'outside' of the
602 # tunnel (usually 'anonymous'). If you want to send
603 # the reply attributes based on the user name inside
604 # of the tunnel, then set this configuration entry to
605 # 'yes', and the reply to the NAS will be taken from
606 # the reply to the tunneled request.
608 # allowed values: {no, yes}
610 use_tunneled_reply = no
613 # The inner tunneled request can be sent
614 # through a virtual server constructed
615 # specifically for this purpose.
617 # If this entry is commented out, the inner
618 # tunneled request will be sent through
619 # the virtual server that processed the
622 virtual_server = "inner-tunnel"
624 # This has the same meaning, and overwrites, the
625 # same field in the "tls" configuration, above.
626 # The default value here is "yes".
628 # include_length = yes
631 # Unlike EAP-TLS, EAP-TTLS does not require a client
632 # certificate. However, you can require one by setting the
633 # following option. You can also override this option by
636 # EAP-TLS-Require-Client-Cert = Yes
638 # in the control items for a request.
640 # require_client_cert = yes
647 ##################################################
649 # !!!!! WARNINGS for Windows compatibility !!!!!
651 ##################################################
653 # If you see the server send an Access-Challenge,
654 # and the client never sends another Access-Request,
659 # The server certificate has to have special OID's
660 # in it, or else the Microsoft clients will silently
661 # fail. See the "scripts/xpextensions" file for
662 # details, and the following page:
664 # http://support.microsoft.com/kb/814394/en-us
666 # For additional Windows XP SP2 issues, see:
668 # http://support.microsoft.com/kb/885453/en-us
671 # If is still doesn't work, and you're using Samba,
672 # you may be encountering a Samba bug. See:
674 # https://bugzilla.samba.org/show_bug.cgi?id=6563
676 # Note that we do not necessarily agree with their
677 # explanation... but the fix does appear to work.
679 ##################################################
682 # The tunneled EAP session needs a default EAP type
683 # which is separate from the one for the non-tunneled
684 # EAP module. Inside of the TLS/PEAP tunnel, we
685 # recommend using EAP-MS-CHAPv2.
688 # Which tls-config section the TLS negotiation parameters
689 # are in - see EAP-TLS above for an explanation.
691 # In the case that an old configuration from FreeRADIUS
692 # v2.x is being used, all the options of the tls-config
693 # section may also appear instead in the 'tls' section
694 # above. If that is done, the tls= option here (and in
695 # tls above) MUST be commented out.
699 # The tunneled EAP session needs a default
700 # EAP type which is separate from the one for
701 # the non-tunneled EAP module. Inside of the
702 # PEAP tunnel, we recommend using MS-CHAPv2,
703 # as that is the default type supported by
706 default_eap_type = mschapv2
708 # The PEAP module also has these configuration
709 # items, which are the same as for TTLS.
711 copy_request_to_tunnel = no
714 # As of version 3.0.5, this configuration item
715 # is deprecated. Instead, you should use
717 # update outer.session-state {
722 # This will cache attributes for the final Access-Accept.
724 use_tunneled_reply = no
726 # When the tunneled session is proxied, the
727 # home server may not understand EAP-MSCHAP-V2.
728 # Set this entry to "no" to proxy the tunneled
729 # EAP-MSCHAP-V2 as normal MSCHAPv2.
731 # proxy_tunneled_request_as_eap = yes
734 # The inner tunneled request can be sent
735 # through a virtual server constructed
736 # specifically for this purpose.
738 # If this entry is commented out, the inner
739 # tunneled request will be sent through
740 # the virtual server that processed the
743 virtual_server = "inner-tunnel"
745 # This option enables support for MS-SoH
746 # see doc/SoH.txt for more info.
747 # It is disabled by default.
752 # The SoH reply will be turned into a request which
753 # can be sent to a specific virtual server:
755 # soh_virtual_server = "soh-server"
758 # Unlike EAP-TLS, PEAP does not require a client certificate.
759 # However, you can require one by setting the following
760 # option. You can also override this option by setting
762 # EAP-TLS-Require-Client-Cert = Yes
764 # in the control items for a request.
766 # require_client_cert = yes
770 # This takes no configuration.
772 # Note that it is the EAP MS-CHAPv2 sub-module, not
773 # the main 'mschap' module.
775 # Note also that in order for this sub-module to work,
776 # the main 'mschap' module MUST ALSO be configured.
778 # This module is the *Microsoft* implementation of MS-CHAPv2
779 # in EAP. There is another (incompatible) implementation
780 # of MS-CHAPv2 in EAP by Cisco, which FreeRADIUS does not
784 # Prior to version 2.1.11, the module never
785 # sent the MS-CHAP-Error message to the
786 # client. This worked, but it had issues
787 # when the cached password was wrong. The
788 # server *should* send "E=691 R=0" to the
789 # client, which tells it to prompt the user
790 # for a new password.
792 # The default is to behave as in 2.1.10 and
793 # earlier, which is known to work. If you
794 # set "send_error = yes", then the error
795 # message will be sent back to the client.
796 # This *may* help some clients work better,
797 # but *may* also cause other clients to stop