1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
<page xmlns="http://projectmallard.org/1.0/"
xmlns:its="http://www.w3.org/2005/11/its"
type="topic" id="contacts-ldap">
<info>
<link type="guide" xref="contacts-using-several-addressbooks"/>
<revision pkgversion="3.1.5" version="0.4" date="2015-03-09" status="final"/>
<credit type="author">
<name its:translate="no">Andre Klapper</name>
<email its:translate="no">ak-47@gmx.net</email>
</credit>
<credit type="author">
<name its:translate="no">Novell, Inc</name>
<!-- Content partially from
https://help.gnome.org/users/evolution/2.32/usage-contact-sharing.html.en
and
https://help.gnome.org/users/evolution/2.32/config-prefs-contact.html.en#bxmw6w5
-->
</credit>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
<desc>Use shared address books on a local network.</desc>
</info>
<title>Adding LDAP access</title>
<p>The LDAP protocol was created to let users share contact information over
a network by sharing access to a central directory. LDAP allows a company to
maintain a shared set of contact information. Many companies keep a common
LDAP address book for all their employees or for client contacts.</p>
<section id="add-ldap-addressbook">
<title>Adding an LDAP address book</title>
<steps>
<item>
<p>Click <guiseq><gui>File</gui><gui>New</gui>
<gui>Address Book</gui></guiseq>.</p>
</item>
<item>
<p>In the <gui>Type</gui> field, select
<gui>On LDAP Servers</gui>.</p>
</item>
<item>
<p>Enter a name that you prefer.</p>
</item>
<item>
<p>In the <gui>Connecting to LDAP</gui> tab:</p>
<list>
<item>
<p>Enter the address of the server, the port number (the default number
is 389) and whether you want to connect securely.</p>
</item>
<item>
<p>Define the login method and your username.</p>
</item>
</list>
</item>
<item>
<p>In the <gui>Using LDAP</gui> tab you define the following
settings:</p>
<list>
<item>
<p>Search Base: The search base is the starting point for a directory
search. Contact your system administrator for information about the
correct settings.</p>
</item>
<item>
<p>Search Scope: The search scope is the breadth of a given search.</p>
<p>The following options are available:</p>
<list>
<item>
<p>One Level: Searches one entry below the Search Base.</p>
</item>
<item>
<p>Subtree: Searches the Search Base and all entries below it.</p>
</item>
</list>
</item>
<item>
<p>Search Filter: The search filter can be set here for all the LDAP
queries. For example:</p>
<list>
<item>
<p><code>ObjectClass=*</code>: Lists all the objects from the
server.</p>
</item>
<item>
<p><code>ObjectClass=User</code>: Lists only the users.</p>
</item>
<item>
<p><code>Filter (|(ObjectClass=User)(ObjectClass=groupOfNames))</code>:
Retrieves the User and Contact List objects.</p>
</item>
<item>
<p><code>(&(mail=*)(ObjectClass=*))</code>: Lists the objects
associated with the email addresses.</p>
</item>
</list>
</item>
<item>
<p>Download Limit: The maximum number of results for a given search.
Most servers refuse to send more than 500 contacts, but you can set
the number lower if you want to shorten downloads for very broad
searches. This option is ignored, if <gui>Copy book content locally
for offline operation</gui> is checked.</p>
</item>
</list>
</item>
<item>
<p>Click <gui style="button">OK</gui>.</p>
</item>
</steps>
<note style="tip">
<p>If you are unsure about some settings, ask your system
administrator.</p>
</note>
</section>
<section id="ldap-vs-local-addressbooks">
<title>Differences to local address books</title>
<p>LDAP address books work like local address books on your computer, with
the following exceptions:</p>
<list>
<item>
<p>Network folders are only available when you are connected to the
network. If you use a laptop or have a modem connection, you might want
to copy or cache some of the network directory. You do this by dragging
and dropping your desired contacts into the local address books.</p>
</item>
<item>
<p>You can also mark the network folder for offline usage. To mark the
folder, right-click the folder, click <gui>Properties</gui> and select
<gui>Copy folder content locally for offline operation</gui>.</p>
</item>
<item>
<p>To prevent excess network traffic, <app>Evolution</app> does not
normally load data from the LDAP server upon opening.</p>
</item>
<item>
<p>Depending on your server settings, you might not be able to edit all
the fields in a contact stored on an LDAP server. Some servers prohibit
some or all changes, and others use a smaller set of fields than
<app>Evolution</app> allows. Check with your system administrator if you
need different settings.</p>
</item>
</list>
</section>
</page>
|
