Updating Unix installation notes.
[samba.git] / docs / textdocs / UNIX_SECURITY.txt
1 Contributor:    John H Terpstra <jht@samba.anu.edu.au>
2 Date:           July 5, 1998
3 Status:         Current
4
5 Subject:        SETTING UNIX FILE SYSTEM SECURITY
6 ===============================================================================
7 The following excerpt from a bug report demonstrates the need to
8 understand Unix file system security and to manage it correctly.
9
10 Quote:
11 ======
12 > We are unable to keep individual users from mapping to any other user's
13 > home directory once they have supplied a valid password! They only need
14 > to enter their own password. I have not found *any* method that I can
15 > use to configure samba to enforce that only a user may map their own
16 > home directory.
17
18 > User xyzzy can map his home directory. Once mapped user xyzzy can also map
19 > *anyone* elses home directory!
20
21 ANSWER:
22 =======
23 This is not a security flaw, it is by design. Samba allows
24 users to have *exactly* the same access to the UNIX filesystem
25 as they would if they were logged onto the UNIX box, except
26 that it only allows such views onto the file system as are
27 allowed by the defined shares.
28
29 This means that if your UNIX home directories are set up
30 such that one user can happily cd into another users
31 directory and do an ls, the UNIX security solution is to 
32 change the UNIX file permissions on the users home directories
33 such that the cd and ls would be denied.
34
35 Samba tries very had not to second guess the UNIX administrators
36 security policies, and trusts the UNIX admin to set
37 the policies and permissions he or she desires.
38
39 Samba does allow the setup you require when you have set the
40 "only user = yes" option on the share, is that you have not set the
41 valid users list for the share.
42
43 Note that only user works in conjunction with the users= list,
44 so to get the behavior you require, add the line :
45
46 user = %S
47
48 to the definition of the [homes] share, as recommended in
49 the smb.conf man page.
50