WHATSNEW: Add information on changed security defaults.
[nivanova/samba-autobuild/.git] / WHATSNEW.txt
1                    =================================
2                    Release Notes for Samba 3.6.0pre1
3                    July 28, 2010
4                    =================================
5
6
7 This is the first preview release of Samba 3.6.  This is *not*
8 intended for production environments and is designed for testing
9 purposes only.  Please report any defects via the Samba bug reporting
10 system at https://bugzilla.samba.org/.
11
12
13 Major enhancements in Samba 3.6.0 include:
14
15
16 Changed security defaults
17 -------------------------
18
19 Samba 3.6 has adopted a number of improved security defaults that will
20 impact on existing users of Samba.
21
22  client ntlmv2 auth = yes
23  client use spnego principal = no
24  send spnego principal = no
25
26 The impact of 'client ntlmv2 auth = yes' is that by default we will not
27 use NTLM authentication as a client.  This applies to the Samba client
28 tools such as smbclient and winbind, but does not change the separately
29 released in-kernel CIFS client.  To re-enable the poorer NTLM encryption
30 set '--option=clientusentlmv2auth=no' on your smbclient command line, or
31 set 'client ntlmv2 auth = no' in your smb.conf
32
33 The impact of 'client use spnego principal = no' is that we may be able
34 to use Kerberos to communicate with a server less often in smbclient,
35 winbind and other Samba client tools.  We may fall back to NTLMSSP in
36 more situations where we would previously rely on the insecure
37 indication from the 'NegProt' CIFS packet.  This mostly occursed when
38 connecting to a name alias not recorded as a servicePrincipalName for
39 the server.  This indication is not available from Windows 2008 or later
40 in any case, and is not used by modern Windows clients, so this makes
41 Samba's behaviour consistent with other clients and against all servers.
42
43 The impact of 'send spnego principal = no' is to match Windows 2008 and
44 not to send this principal, making existing clients give more consistent
45 behaviour (more likely to fall back to NTLMSSP) between Samba and
46 Windows 2008, and between Windows versions that did and no longer use
47 this insecure hint.
48
49
50 SMB2 support
51 ------------
52
53 SMB2 support in 3.6.0 is fully functional (with one omission),
54 and can be enabled by setting:
55
56 max protocol = SMB2
57
58 in the [global] section of your smb.conf and re-starting
59 Samba. All features should work over SMB2 except the modification
60 of user quotas using the Windows quota management tools.
61
62 As this is the first release containing what we consider
63 to be a fully featured SMB2 protocol, we are not enabling
64 this by default, but encourage users to enable SMB2 and
65 test it. Once we have enough confirmation from Samba
66 users and OEMs that SMB2 support is stable in wide user
67 testing we will enable SMB2 by default in a future Samba
68 release.
69
70
71 Internal Winbind passdb changes
72 -------------------------------
73
74 Winbind has been changed to use the internal samr and lsa rpc pipe to get
75 local user and group information instead of calling passdb functions. The
76 reason is to use more of our infrastructure and test this infrastructure by
77 using it. With this approach more code in Winbind is shared.
78
79
80 New Spoolss code
81 ----------------
82
83 The spoolss and the old RAP printing code have been completely
84 overhauled and refactored.
85
86 All calls from lanman/printing code has been changed to go through the
87 spoolss RPC interfaces, this allows us to keep all checks in one place
88 and avoid special cases in the main printing code.
89 Printing code has been therefore confined within the spoolss code.
90
91 All the printing code, including the spoolss RPC interfaces has been
92 changed to use the winreg RPC interfaces to store all data.
93 All data has been migrated from custom, arbitrary TDB files to the
94 registry interface. This transition allow us to present correct data to
95 windows client accessing the server registry through the winreg RPC
96 interfaces to query for printer data. Data is served out from a real
97 registry implementation and therefore arguably 100% forward compatible.
98
99 Migration code from the previous TDB files formats is provided. This
100 code is automatically invoked the first time the new code is run on the
101 server. Although manual migration is also available using the 'net
102 printer migrate' command.
103
104 These changes not only make all the spoolss code much more closer to
105 "the spec", it also greatly improves our internal testing of both
106 spoolss and winreg interfaces, and reduces overall code duplication.
107
108 As part of this work, new tests have been also added to increase
109 coverage.
110
111 This code will also allow, in future, an easy transition to split out
112 the spooling functions into a separate daemon for those OEMs that do not
113 need printing functionality in their appliances, reducing the code
114 footprint.
115
116
117 SMB Traffic Analyzer
118 --------------------
119
120 Added the new SMB Traffic Analyzer (SMBTA) VFS module protocol 2
121 featuring encryption, multiple arguments, and easier parseability. A new
122 tool 'smbta-util' has been created to control the encryption behaviour
123 of SMBTA. For compatibility, SMBTA by default operates on version 1.
124 There are programs consuming the data that the module sends.
125
126 More information can be found on
127 http://holger123.wordpress.com/smb-traffic-analyzer/
128
129
130 ######################################################################
131 Changes
132 #######
133
134 smb.conf changes
135 ----------------
136
137    Parameter Name                      Description     Default
138    --------------                      -----------     -------
139
140    log writeable files on exit         New             No
141    ctdb locktime warn threshold        New             0
142    smb2 max read                       New             1048576
143    smb2 max write                      New             1048576
144    smb2 max trans                      New             1048576
145    username map cache time             New             0
146    async smb echo handler              New             No
147
148
149 ######################################################################
150 Reporting bugs & Development Discussion
151 #######################################
152
153 Please discuss this release on the samba-technical mailing list or by
154 joining the #samba-technical IRC channel on irc.freenode.net.
155
156 If you do report problems then please try to send high quality
157 feedback. If you don't provide vital information to help us track down
158 the problem then you will probably be ignored.  All bug reports should
159 be filed under the Samba 3.6 product in the project's Bugzilla
160 database (https://bugzilla.samba.org/).
161
162
163 ======================================================================
164 == Our Code, Our Bugs, Our Responsibility.
165 == The Samba Team
166 ======================================================================
167