d5b68c86b5df23399e11290f13f25d866356b61a
[openafs.git] / doc / man-pages / pod5 / NoAuth.pod
1 =head1 NAME
2
3 NoAuth - Disables authorization checking
4
5 =head1 DESCRIPTION
6
7 The NoAuth file, if present in a server machine's
8 B</usr/afs/local> directory, indicates to the AFS server processes
9 running on the machine that it is not necessary to perform authorization
10 checking. They perform any action for any user who logs into the
11 machine's local file system or issues a remote command that affects the
12 machine's AFS server functioning, such as commands from the AFS command
13 suites. Because failure to check authorization exposes the
14 machine's AFS server functionality to attack, there are normally only two
15 circumstances in which the file is present:
16
17 =over 4
18
19 =item *
20
21 During installation of the machine, as instructed in the I<IBM AFS
22 Quick Beginnings>
23
24
25 =item *
26
27 During correction of a server encryption key emergency, as discussed in
28 the I<IBM AFS Administration Guide>
29
30
31 =back
32
33 In all other circumstances, the absence of the file means that the AFS
34 server processes perform authorization checking, verifying that the issuer of
35 a command has the required privilege.
36
37 Create the file in one of the following ways:
38
39 =over 4
40
41 =item *
42
43 By issuing the bosserver initialization command with the
44 B<-noauth> flag, if the Basic OverSeer (BOS) Server is not already
45 running
46
47
48 =item *
49
50 By issuing the B<bos setauth> command with off as the
51 value for the B<-authrequired> argument, if the BOS Server is already
52 running
53
54
55 =back
56
57 To remove the file, issue the bos setauth command with
58 B<on> as the value for the B<-authrequired> argument.
59
60 The file's contents, if any, are ignored; an empty (zero-length)
61 file is effective.
62
63 =head1 SEE ALSO
64
65 L<bos_setauth(1)>,
66 L<bosserver(1)>
67
68 =head1 COPYRIGHT
69
70 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
71
72 This documentation is covered by the IBM Public License Version 1.0.  It was
73 converted from HTML to POD by software written by Chas Williams and Russ
74 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.