Mercurial > hg > freeDiameter

annotate doc/freediameter.conf.sample @ 1181:22de21feec64

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Preparing for DTLS support
author Sebastien Decugis <sdecugis@freediameter.net>
date Wed, 05 Jun 2013 19:22:26 +0800
parents 773498f59520
children 436e4342ecd0
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
1 # This is a sample configuration file for freeDiameter daemon.
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
2
1165
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
3 # Most of the options can be omitted, as they default to reasonable values.
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
4 # Only TLS-related options must be configured properly in usual setups.
20
277ec00d793e Backup before typhoon... Progress on server side
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 18
diff changeset
5
925
e5a09fab5ef3 Add support for 'include' in freeDiameter configuration file
Sebastien Decugis <sdecugis@freediameter.net>
parents: 873
diff changeset
6 # It is possible to use "include" keyword to import additional files
e5a09fab5ef3 Add support for 'include' in freeDiameter configuration file
Sebastien Decugis <sdecugis@freediameter.net>
parents: 873
diff changeset
7 # e.g.: include "/etc/freeDiameter.d/*.conf"
1165
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
8 # This is exactly equivalent as copy & paste the content of the included file(s)
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
9 # where the "include" keyword is found.
925
e5a09fab5ef3 Add support for 'include' in freeDiameter configuration file
Sebastien Decugis <sdecugis@freediameter.net>
parents: 873
diff changeset
10
e5a09fab5ef3 Add support for 'include' in freeDiameter configuration file
Sebastien Decugis <sdecugis@freediameter.net>
parents: 873
diff changeset
11
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
12 ##############################################################
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
13 ## Peer identity and realm
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
14
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
15 # The Diameter Identity of this daemon.
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
16 # This must be a valid FQDN that resolves to the local host.
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
17 # Default: hostname's FQDN
335
603791d2dcc4 Updated website information
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 303
diff changeset
18 #Identity = "aaa.koganei.freediameter.net";
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
19
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
20 # The Diameter Realm of this daemon.
513
662b1f9258c3 Improve documentation as suggested by ????? ????????? (thank you)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 337
diff changeset
21 # Default: the domain part of Identity (after the first dot).
337
660208ca0e54 Changed confusing example value
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 335
diff changeset
22 #Realm = "koganei.freediameter.net";
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
23
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
24 ##############################################################
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
25 ## Transport protocol configuration
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
26
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
27 # The port this peer is listening on for incoming connections (TCP and SCTP).
1165
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
28 # Default: 3868. Use 0 to disable.
12
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
29 #Port = 3868;
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
30
1165
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
31 # The port this peer is listening on for incoming TLS-protected connections (TCP and SCTP).
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
32 # See TLS_old_method for more information about TLS flavours.
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
33 # Default: 5658. Use 0 to disable.
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
34 #SecPort = 5658;
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
35
1180
773498f59520 Preparing for future DTLS/SCTP support
Sebastien Decugis <sdecugis@freediameter.net>
parents: 1165
diff changeset
36 # freeDiameter 1.2.0 introduces the support of DTLS over SCTP (RFC6083) instead of TLS over SCTP (RFC3436),
773498f59520 Preparing for future DTLS/SCTP support
Sebastien Decugis <sdecugis@freediameter.net>
parents: 1165
diff changeset
37 # as specified in RFC6733. If you need compatibility with older implementation that use TLS over SCTP, you
1181
22de21feec64 Preparing for DTLS support
Sebastien Decugis <sdecugis@freediameter.net>
parents: 1180
diff changeset
38 # can open an additional SCTP server port using TLS/SCTP by specifying the following parameter.
22de21feec64 Preparing for DTLS support
Sebastien Decugis <sdecugis@freediameter.net>
parents: 1180
diff changeset
39 # Note that no TCP server is started on the following port.
1180
773498f59520 Preparing for future DTLS/SCTP support
Sebastien Decugis <sdecugis@freediameter.net>
parents: 1165
diff changeset
40 # Default: 0 (disabled). Use 3869 for compatibility with freeDiameter < 1.2.0.
773498f59520 Preparing for future DTLS/SCTP support
Sebastien Decugis <sdecugis@freediameter.net>
parents: 1165
diff changeset
41 #SctpSec3436 = 0;
773498f59520 Preparing for future DTLS/SCTP support
Sebastien Decugis <sdecugis@freediameter.net>
parents: 1165
diff changeset
42
1165
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
43 # Use RFC3588 method for TLS protection, where TLS is negociated after CER/CEA exchange is completed
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
44 # on the unsecure connection. The alternative is RFC6733 mechanism, where TLS protects also the
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
45 # CER/CEA exchange on a dedicated secure port.
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
46 # This parameter only affects outgoing connections.
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
47 # The setting can be also defined per-peer (see Peers configuration section).
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
48 # Default: use RFC6733 method with separate port for TLS.
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
49 #TLS_old_method;
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
50
1165
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
51 # Disable use of TCP protocol (only listen and connect over SCTP)
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
52 # Default : TCP enabled
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
53 #No_TCP;
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
54
1165
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
55 # Disable use of SCTP protocol (only listen and connect over TCP)
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
56 # Default : SCTP enabled
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
57 #No_SCTP;
1165
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
58 # This option is ignored if freeDiameter is compiled with DISABLE_SCTP option.
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
59
1165
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
60 # Prefer TCP instead of SCTP for establishing new connections.
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
61 # This setting may be overwritten per peer in peer configuration blocs.
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
62 # Default : SCTP is attempted first.
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
63 #Prefer_TCP;
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
64
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
65 # Default number of streams per SCTP associations.
1165
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
66 # This setting may be overwritten per peer basis.
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
67 # Default : 30 streams
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
68 #SCTP_streams = 30;
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
69
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
70 ##############################################################
1165
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
71 ## Endpoint configuration
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
72
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
73 # Disable use of IP addresses (only IPv6)
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
74 # Default : IP enabled
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
75 #No_IP;
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
76
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
77 # Disable use of IPv6 addresses (only IP)
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
78 # Default : IPv6 enabled
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
79 #No_IPv6;
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
80
1165
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
81 # Specify local addresses the server must bind to
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
82 # Default : listen on all addresses available.
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
83 #ListenOn = "202.249.37.5";
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
84 #ListenOn = "2001:200:903:2::202:1";
23
db6c40b8b307 Added some code in cnxctx.c mainly
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 22
diff changeset
85 #ListenOn = "fe80::21c:5ff:fe98:7d62%eth0";
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
86
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
87 ##############################################################
18
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
88 ## TLS Configuration
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
89
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
90 # TLS is managed by the GNUTLS library in the freeDiameter daemon.
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
91 # You may find more information about parameters and special behaviors
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
92 # in the relevant documentation.
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
93 # http://www.gnu.org/software/gnutls/manual/
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
94
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
95 # Credentials of the local peer
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
96 # The X509 certificate and private key file to use for the local peer.
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
97 # The files must contain PKCS-1 encoded RSA key, in PEM format.
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
98 # (These parameters are passed to gnutls_certificate_set_x509_key_file function)
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
99 # Default : NO DEFAULT
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
100 #TLS_Cred = "<x509 certif file.PEM>" , "<x509 private key file.PEM>";
303
32ba9cf7ba87 Add a reasonable default path for certificates
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 253
diff changeset
101 TLS_Cred = "/etc/ssl/certs/freeDiameter.pem", "/etc/ssl/private/freeDiameter.key";
18
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
102
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
103 # Certificate authority / trust anchors
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
104 # The file containing the list of trusted Certificate Authorities (PEM list)
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
105 # (This parameter is passed to gnutls_certificate_set_x509_trust_file function)
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
106 # The directive can appear several times to specify several files.
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
107 # Default : GNUTLS default behavior
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
108 #TLS_CA = "<file.PEM>";
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
109
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
110 # Certificate Revocation List file
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
111 # The information about revoked certificates.
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
112 # The file contains a list of trusted CRLs in PEM format. They should have been verified before.
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
113 # (This parameter is passed to gnutls_certificate_set_x509_crl_file function)
1165
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
114 # Note: openssl CRL format might have interoperability issue with GNUTLS format.
18
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
115 # Default : GNUTLS default behavior
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
116 #TLS_CRL = "<file.PEM>";
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
117
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
118 # GNU TLS Priority string
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
119 # This string allows to configure the behavior of GNUTLS key exchanges
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
120 # algorithms. See gnutls_priority_init function documentation for information.
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
121 # You should also refer to the Diameter required TLS support here:
1165
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
122 # http://tools.ietf.org/html/rfc6733#section-13.1
18
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
123 # Default : "NORMAL"
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
124 # Example: TLS_Prio = "NONE:+VERS-TLS1.1:+AES-128-CBC:+RSA:+SHA1:+COMP-NULL";
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
125 #TLS_Prio = "NORMAL";
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
126
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
127 # Diffie-Hellman parameters size
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
128 # Set the number of bits for generated DH parameters
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
129 # Valid value should be 768, 1024, 2048, 3072 or 4096.
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
130 # (This parameter is passed to gnutls_dh_params_generate2 function,
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
131 # it usually should match RSA key size)
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
132 # Default : 1024
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
133 #TLS_DH_Bits = 1024;
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
134
578
7c9a00bfd115 Allow TLS Diffie-Hellmann parameters to be loaded from a file (ticket #17)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 513
diff changeset
135 # Alternatively, you can specify a file to load the PKCS#3 encoded
7c9a00bfd115 Allow TLS Diffie-Hellmann parameters to be loaded from a file (ticket #17)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 513
diff changeset
136 # DH parameters directly from. This accelerates the daemon start
7c9a00bfd115 Allow TLS Diffie-Hellmann parameters to be loaded from a file (ticket #17)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 513
diff changeset
137 # but is slightly less secure. If this file is provided, the
7c9a00bfd115 Allow TLS Diffie-Hellmann parameters to be loaded from a file (ticket #17)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 513
diff changeset
138 # TLS_DH_Bits parameters has no effect.
7c9a00bfd115 Allow TLS Diffie-Hellmann parameters to be loaded from a file (ticket #17)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 513
diff changeset
139 # Default : no default.
7c9a00bfd115 Allow TLS Diffie-Hellmann parameters to be loaded from a file (ticket #17)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 513
diff changeset
140 #TLS_DH_File = "<file.PEM>";
7c9a00bfd115 Allow TLS Diffie-Hellmann parameters to be loaded from a file (ticket #17)
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 513
diff changeset
141
18
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
142
e7187583dcf8 Added CA helper script
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 13
diff changeset
143 ##############################################################
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
144 ## Timers configuration
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
145
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
146 # The Tc timer of this peer.
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
147 # It is the delay before a new attempt is made to reconnect a disconnected peer.
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
148 # The value is expressed in seconds. The recommended value is 30 seconds.
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
149 # Default: 30
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
150 #TcTimer = 30;
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
151
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
152 # The Tw timer of this peer.
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
153 # It is the delay before a watchdog message is sent, as described in RFC 3539.
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
154 # The value is expressed in seconds. The default value is 30 seconds. Value must
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
155 # be greater or equal to 6 seconds. See details in the RFC.
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
156 # Default: 30
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
157 #TwTimer = 30;
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
158
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
159 ##############################################################
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
160 ## Applications configuration
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
161
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
162 # Disable the relaying of Diameter messages?
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
163 # For messages not handled locally, the default behavior is to forward the
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
164 # message to another peer if any is available, according to the routing
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
165 # algorithms. In addition the "0xffffff" application is advertised in CER/CEA
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
166 # exchanges.
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
167 # Default: Relaying is enabled.
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
168 #NoRelay;
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
169
253
ad6c0118fb50 Configurable number of server threads
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 24
diff changeset
170 # Number of server threads that can handle incoming messages at the same time.
ad6c0118fb50 Configurable number of server threads
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 24
diff changeset
171 # Default: 4
ad6c0118fb50 Configurable number of server threads
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 24
diff changeset
172 #AppServThreads = 4;
ad6c0118fb50 Configurable number of server threads
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 24
diff changeset
173
1165
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
174 # Other applications are configured by loaded extensions.
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
175
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
176 ##############################################################
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
177 ## Extensions configuration
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
178
1165
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
179 # The freeDiameter framework merely provides support for
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
180 # Diameter Base Protocol. The specific application behaviors,
1165
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
181 # as well as advanced functions, are provided
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
182 # by loadable extensions (plug-ins).
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
183 # These extensions may in addition receive the name of a
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
184 # configuration file, the format of which is extension-specific.
12
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
185 #
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
186 # Format:
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
187 #LoadExtension = "/path/to/extension" [ : "/optional/configuration/file" ] ;
12
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
188 #
871
254d81d21d0b Fix some typos.
Thomas Klausner <tk@giga.or.at>
parents: 706
diff changeset
189 # Examples:
873
a4257b7faba3 Fix extensions file extension in the sample file
Sebastien Decugis <sdecugis@freediameter.net>
parents: 871
diff changeset
190 #LoadExtension = "extensions/sample.fdx";
a4257b7faba3 Fix extensions file extension in the sample file
Sebastien Decugis <sdecugis@freediameter.net>
parents: 871
diff changeset
191 #LoadExtension = "extensions/sample.fdx":"conf/sample.conf";
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
192
1165
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
193 # Extensions are named as follow:
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
194 # dict_* for extensions that add content to the dictionary definitions.
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
195 # dbg_* for extensions useful only to retrieve more information on the framework execution.
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
196 # acl_* : Access control list, to control which peers are allowed to connect.
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
197 # rt_* : routing extensions that impact how messages are forwarded to other peers.
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
198 # app_* : applications, these extensions usually register callbacks to handle specific messages.
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
199 # test_* : dummy extensions that are useful only in testing environments.
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
200
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
201
12
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
202 ##############################################################
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
203 ## Peers configuration
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
204
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
205 # The local server listens for incoming connections. By default,
1165
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
206 # all unknown connecting peers are rejected. Extensions can override this behavior (e.g., acl_wl).
12
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
207 #
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
208 # In addition to incoming connections, the local peer can
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
209 # be configured to establish and maintain connections to some
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
210 # Diameter nodes and allow connections from these nodes.
972
ce3cacbbccc9 Fix some typos.
Thomas Klausner <tk@giga.or.at>
parents: 925
diff changeset
211 # This is achieved with the ConnectPeer directive described below.
12
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
212 #
1165
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
213 # Note that the configured Diameter Identity MUST match
12
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
214 # the information received inside CEA, or the connection will be aborted.
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
215 #
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
216 # Format:
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
217 #ConnectPeer = "diameterid" [ { parameter1; parameter2; ...} ] ;
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
218 # Parameters that can be specified in the peer's parameter list:
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
219 # No_TCP; No_SCTP; No_IP; No_IPv6; Prefer_TCP; TLS_old_method;
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
220 # No_TLS; # assume transparent security instead of TLS
1180
773498f59520 Preparing for future DTLS/SCTP support
Sebastien Decugis <sdecugis@freediameter.net>
parents: 1165
diff changeset
221 # SctpSec3436; # Use TLS/SCTP instead of DTLS/SCTP to protect SCTP associations with this peer.
1165
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
222 # Port = 5658; # The port to connect to
12
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
223 # TcTimer = 30;
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
224 # TwTimer = 30;
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
225 # ConnectTo = "202.249.37.5";
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
226 # ConnectTo = "2001:200:903:2::202:1";
22
0b3b46da2c12 Progress on server code
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 21
diff changeset
227 # TLS_Prio = "NORMAL";
706
4ffbc9f1e922 Large UNTESTED commit with the following changes:
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 578
diff changeset
228 # Realm = "realm.net"; # Reject the peer if it does not advertise this realm.
12
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
229 # Examples:
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
230 #ConnectPeer = "aaa.wide.ad.jp";
1165
515a5b8f930a Updated documentation
Sebastien Decugis <sdecugis@freediameter.net>
parents: 972
diff changeset
231 #ConnectPeer = "old.diameter.serv" { TcTimer = 60; TLS_old_method; No_SCTP; Port=3868; } ;
12
418d2ce80dc8 Added support in configuration file for peers declaration
Sebastien Decugis <sdecugis@nict.go.jp>
parents: 10
diff changeset
232
8
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
233
3e143f047f78 Backup for the week-end
Sebastien Decugis <sdecugis@nict.go.jp>
parents:
diff changeset
234 ##############################################################
"Welcome to our mercurial repository"