some corrections suggested by #debian-devel channel members
[mirror/userdir-ldap-cgi.git] / html / doc-general.wml
1 #use wml::db.d.o title="General LDAP Documentation"
2
3 <p>
4 debian.org uses a single LDAP driven directory for account management across
5 all the project run <a href="/machines.cgi">machines</a>. This directory
6 also provides services for leaving vacation notices, updating
7 <a href="http://www.debian.org/devel/developers.loc">xplanet</a> coordinates,
8 email forwarding, ssh authentication keys and other information.
9
10 <p>
11 Note: the 'passwd' program and 'chfn' do not work with LDAP information.
12 Please use the web page or email gateway for the time being. All machines 
13 running OpenSSH are using replicated SSH RSA authentication keys.
14
15 <h1>Security and Privacy</h1>
16 <p>
17 Three levels of information security are provided by the database. The first
18 is completely public information that anyone can see either by issuing an
19 LDAP query or by visiting the web site. The next level is
20 <em>developer-only</em> information that requires the search to be
21 performed from a .debian.org machine (see <a href="doc-direct.html">this
22 tutorial</a> on how to use ldapsearch from a .debian.org machine for a
23 direct connection to the LDAP daemon) or from the web interface after
24 one has authenticated themselves as a Debian Developer. The final level is
25 <em>admin-only</em> or <em>user-only</em> information; this
26 information can only be viewed by the user or an administrator.
27
28 <p>
29 <em>developer-only</em> information includes precise location information
30 [postalcode, postal address, lat/long] telephone numbers, and the vacation
31 message.
32
33 <p>
34 <em>Admin-only/user-only</em> information includes email forwarding,
35 ssh keys and
36 the encrypted password. Note that email forwarding is necessarily publicly 
37 viewable from accounts on the actual machines.
38
39 <p>
40 Entries in the directory are keyed to the developers PGP key, whoever has that
41 key can make any change to the directory through the mail interface.
42
43 <h1>Access</h1>
44 <p>
45 The directory has several means to access it:
46 <ul>
47 <li><a href="https://db.debian.org/login.html">SSL Web Forms</a>
48 <li>Finger gateway, <tt>finger foo@db.debian.org</tt>
49 <li>GPG key gateway, <tt>finger foo/key@db.debian.org</tt>
50 <li><a href="doc-mail.html">Mail gateway</a>
51 <li><a href="doc-direct.html">Direct LDAP Access</a>
52 <li>LDAP command line tools such as <tt>ud-info</tt>
53 </ul>
54
55 <p>
56 <a href="password.html">Lost or forgotten password instructions</a>