summaryrefslogtreecommitdiffstats
path: root/doc/tdewallet/index.docbook
blob: dcc930488545be45c9b16aae029b1c406c988f90 (plain)
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
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY tdewallet "<application>KWallet</application>">
  <!ENTITY tdewalletmanager "<application>KWallet Manager</application>">
  <!ENTITY package "tdeutils">
  <!ENTITY kappname "&tdewallet;">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE">
]>

<book lang="&language;">
<bookinfo>
<title>The &tdewallet; Handbook</title>

<authorgroup>
<author>
&George.Staikos; &George.Staikos.mail;
</author>
<author>
&Lauri.Watts; &Lauri.Watts.mail;
</author>
<othercredit role="developer">
<firstname>George</firstname><surname>Staikos</surname>
<affiliation><address><email>staikos@kde.org</email></address></affiliation>
<contrib>Developer</contrib>
</othercredit>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

<legalnotice>&FDLNotice;</legalnotice>

<date>2005-06-15</date>
<releaseinfo>1.0</releaseinfo>

<abstract>
<para>
The wallet subsytem provides a convenient and secure way to manage all your
passwords.</para>

</abstract>


<keywordset>
<keyword>KDE</keyword>
<keyword>Kwallet</keyword>
<keyword>passwords</keyword>
<keyword>forms</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title>Introduction</title>

<para>Computer users have a very large amount of data to manage, some of
which is sensitive.  In particular, you will typically have many passwords
to manage.  Remembering them is difficult, writing them down on paper or in
a text file is insecure, and using tools such at PGP is tedious and
inconvenient.</para>

<para>&tdewallet; saves this sensitive data for you in a strongly encrypted
file, accessible by all applications, and protected with a master
password that you define.</para>

<tip>
<para>&tdewallet; supports multiple wallets, so 
for the most secure operation, you should use one wallet for local
passwords, and another for network passwords and form data.  You can
configure this behavior in the &tdewallet; &kcontrolcenter; module, however
the default setting is to store everything in one wallet.</para>
</tip>

<para>A wallet is by default closed, which means that you must supply
a password to open it. Once the wallet is opened, the contents can
be accessed.</para>

</chapter>

<chapter id="tdewalletmanager">
<title>&tdewalletmanager;</title>

<para>&tdewalletmanager; serves a number of functions.  Firstly it allows you to see if
any wallets are open, which wallets those are, and which applications are
using each wallet.  You can disconnect an application's access to a wallet
from within the &tdewalletmanager;.</para>

<para>You may also manage the wallets installed on the system, creating and
deleting wallets and manipulating their contents (changing keys, ...).</para>

<para>Normally the &tdewalletmanager; application is launched when
&kde; starts and remains in iconic form in the system tray. Alternatively, 
when a wallet is opened, the &tdewalletmanager; application will be
launched.  A system tray icon indicates that a wallet is open:
 <mediaobject>
   <imageobject>
     <imagedata fileref="cr22-action-wallet_open.png"/>
   </imageobject>
 </mediaobject>

When all
wallets are closed, the icon will reflect this by showing a closed
wallet:
<mediaobject>
 <imageobject>
     <imagedata fileref="cr22-action-wallet_closed.png"/>
  </imageobject>
 </mediaobject> 

</para>

<para>Click once on the system tray wallet icon to display the &tdewalletmanager;
window showing all available wallets as icons which reflect their
current status, either open or closed.</para>
<para>
<mediaobject>
   <imageobject>
     <imagedata fileref="tdewalletmanager.png"/>
   </imageobject>
 </mediaobject></para>


<sect1 id="tdewalletmanager-context-menu">
<title>The &tdewalletmanager; Context Menu</title>

<para><mousebutton>Right</mousebutton> clicking on a wallet in the
&tdewalletmanager; window offers 
the following functions:</para>

<variablelist>

<varlistentry>
<term><guimenuitem>New Wallet...</guimenuitem></term>
<listitem>
<para>Create a new wallet. A dialog box will ask you
for the name of the new wallet that you want to create.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut>&Enter;</shortcut>
<guisubmenu>Open...</guisubmenu></menuchoice></term>
<listitem>
<para>Open the wallet. Opening the wallet causes the contents 
of the wallet to be displayed in a new window where you can
add, delete, or modify the contents of the wallet. You may also 
double click the wallet icon to cause it to open. If the wallet
is not already open, you will be requested to enter the password.
See below for details of using the wallet window.
</para>
<para>
<mediaobject>
   <imageobject>
     <imagedata fileref="edit1.png"/>
   </imageobject>
 </mediaobject></para>

</listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Change Password</guimenuitem></term>
<listitem>
<para>Change the master password for the wallet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guisubmenu>Disconnect</guisubmenu></term>
<listitem><para>Disconnect an application from the wallet. Currently
connected applications will appear in a submenu.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Close</guimenuitem></term>
<listitem><para>Force the wallet to be closed.</para></listitem>
</varlistentry>

<varlistentry>
<term><guimenuitem>Delete</guimenuitem></term>
<listitem>
<para>Delete the wallet</para>
</listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="tdewalletmanager-wallet-window">
<title>The Wallet Window</title>

<para>Double clicking on a wallet in the &tdewalletmanager; window will open a new
window displaying that wallet's contents. A wallet may contain any number
of folders, which allow storing of password information. By default a wallet
will contain folders named Form Data and Passwords.
</para>

<para>The window has four panes:</para>
<para>
<mediaobject>
   <imageobject>
     <imagedata fileref="edit1.png"/>
   </imageobject>
 </mediaobject></para>


<itemizedlist>
<listitem><para>A summary of the contents of the current
folder</para></listitem>
<listitem><para>The folders contained in the wallet</para></listitem>
<listitem><para>The entries in the currently selected
folder</para></listitem>
<listitem><para>The contents of the selected folder entry</para></listitem>
</itemizedlist>

<para>Folders may be added or deleted, and selecting a folder will update
the folder entry list and the summary display.  Selecting a folder entry
will update the entry contents pane, and allow you to edit that
entry.</para>
<para>
<mediaobject>
   <imageobject>
     <imagedata fileref="edit2.png"/>
   </imageobject>
 </mediaobject></para>


<para>Entries may also be created or deleted via the context menu for the
folder contents.</para>

<para>All folders and entries may be dragged and dropped into other wallets
or folders respectively.  This allows a user to easily package up a new
wallet for transfer to another environment.  For instance, a new wallet
could be created and copied onto a removable flash memory device.  Important
passwords could be transferred there, so you have them available in other
locations.</para>

</sect1>

</chapter>

<chapter id="tdewallet-kcontrol-module">
<title>Configuring &tdewallet;</title>

<sect1 id="wallet-preferences">
<title><guilabel>Wallet Preferences</guilabel></title>

<para>&tdewallet; contains a small configuration panel with several options
that allow you to tune &tdewallet; to your personal preferences.  The
default settings for &tdewallet; are sufficient for most users.</para>

<para>Check the box to enable or disable the &kde; wallet subsystem
entirely.  If this box is unchecked, then &tdewallet; is entirely disabled and
none of the other options here have any effect, nor will &tdewallet; record
any information, or offer to fill in forms for you.</para>

<variablelist>
<title><guilabel>Close Wallet</guilabel></title>
<varlistentry>
<term><guilabel>Close when unused for:</guilabel></term>
<listitem>
<para>Close the current wallet after a period of inactivity. If you check this
option, set the period in the box, default is 10 minutes. When a wallet is
closed, the password is needed to access it again.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Close when screen saver starts</guilabel></term>
<listitem>
<para>Close the wallet as soon as the screensaver starts. When a wallet is
closed, the password is needed to access it again.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Close when last application stops using it</guilabel></term>
<listitem>
<para>Close the wallet as soon as applications that use it have stopped. Note
that your wallets will only be closed when all the applications that use it have
stopped. When a wallet is closed, the password is needed to access it
again.</para>
</listitem>
</varlistentry>
</variablelist>

<variablelist>
<title><guilabel>Automatic Wallet Selection</guilabel></title>
<varlistentry>
<term><guilabel>Select wallet to use as default:</guilabel></term>
<listitem>
<para>Select which wallet you want to use as default wallet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Different wallet for local passwords:</guilabel></term>
<listitem>
<para>If checked, choose a different wallet for local passwords.</para>
</listitem>
</varlistentry>
</variablelist>

<variablelist>
<title><guilabel>Wallet Manager</guilabel></title>
<varlistentry>
<term><guilabel>Show manager in system tray</guilabel></term>
<listitem>
<para>Enable the wallet manager to have its icon in the system tray.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Hide System tray icon when last wallet
closes</guilabel></term>
<listitem>
<para>When there is no wallet in use anymore, remove the wallet icon from the
system tray.</para>
</listitem>
</varlistentry>
</variablelist>

<para>Finally, there is a button labelled <guibutton>Launch Wallet
Manager</guibutton>, which does precisely that.</para>
</sect1>

<sect1 id="wallet-access-control">
<title><guilabel>Access Control</guilabel></title>

<para>There is only one option on this page:</para>

<variablelist>
<varlistentry>
<term><guilabel>Prompt when an application accesses an open wallet</guilabel></term>
<listitem>
<para>Signal you when an application gains access to an open wallet.</para>
</listitem>
</varlistentry>
</variablelist>

<para>Next there is a tree style view of the access controls for your wallets.</para>

<para>&LMB; click on the <guiicon>+</guiicon> symbol beside a wallet name to
expand the tree. You will see the name of each application that has asked
for access to the wallet, and the policy you set for it.  You cannot edit
policies here, or add them, but it is possible to delete an entry by &RMB;
clicking on it and choosing <guimenuitem>Delete</guimenuitem> From the
context menu that appears, or by simply selecting it and pressing the
<keycap>Delete</keycap> key.</para>

</sect1>

</chapter>

<chapter id="advanced-features">
<title>Advanced Features</title>

<para>Wallets can be dragged from the &tdewalletmanager; window.  This allows
you to drag the wallet to a file browser window, where you can choose to
copy, move, or link the wallet, as desired.</para>

<para>You might use this to save a wallet to portable media, such as a
USB keychain, so that you can take your passwords with you to work or
on a vacation, and still have easy access to important sites.</para>

<para>Future versions will have built-in functions for easy export or
copying of data to portable devices.</para>

</chapter>

<chapter id="credits-and-licenses">
<title>Credits and Licenses</title>

<para>&tdewallet; &copy; 2003 &George.Staikos;</para>
<para>Documentation &copy; &Lauri.Watts; and &George.Staikos;</para>

<!-- TRANS:CREDIT_FOR_TRANSLATORS -->

&underFDL;
&underGPL;

</chapter>

&documentation.index;

</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

// vim:ts=2:sw=2:tw=78:noet
-->