VA update
[mirror/userdir-ldap.git] / web / doc-general.wml
1 #use wml::debian::template title="General LDAP Documentation"
2 <p>
3 debian.org uses a single LDAP driven directory for account managment across
4 all the project run <a href="/machines.cgi">machines</a>. This directory
5 also provides services for leaving vacation notices, updating 
6 <a href="http://www.debian.org/devel/developers.loc">xplanet</a> coordinates,
7 email forwarding, ssh authentication keys and other information.
8
9 <p>
10 Note: master does not presently use the LDAP directory. All machines running
11 OpenSSH are using replicated SSH RSA authentication keys.
12
13 <h1>Security and Privacy</h1>
14 Three levels of information security are provided by the database. The first
15 is completely public information that anyone can see either by issuing an
16 LDAP query or by visiting the web site. The next level is "maintainer-only"
17 information that requires authentication to the directory before it can be
18 accessed. The final level is admin-only or user-only information; this
19 information can only be viewed by the user or an administrator. 
20
21 <p>
22 Maintainer-only information includes precise location information
23 [postalcode, postal address, lat/long] telephone numbers, and the vacation
24 message.
25
26 <p>
27 Admin-only/user-only information includes email forwarding, ssh keys and
28 the encrypted password. Note that email forwarding is necessarily publicly 
29 viewable from accounts on the actual machines.
30
31 <p>
32 Entries in the directory are keyed to the developers PGP key, whoever has that
33 key can make any change to the directory through the mail interface.
34
35 <h1>Access</h1>
36 The directory has several means to access it:
37 <ul>
38 <li><a href="https://db.debian.org/login.html">SSL Web Forms</a>
39 <li>Finger gateway, <tt>finger foo@debian.org</tt>
40 <li><a href="doc-mail.html">Mail gateway</a>
41 <li><a href="doc-direct.html">Direct LDAP Access</a>
42 <li>LDAP command line tools such as <tt>ud-info</tt>
43 </ul>
44
45 <p>
46 <a href="password.html">Lost or forgotten password instructions</a>