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