diff options
author | toma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da> | 2009-11-25 17:56:58 +0000 |
---|---|---|
committer | toma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da> | 2009-11-25 17:56:58 +0000 |
commit | 2bda8f7717adf28da4af0d34fb82f63d2868c31d (patch) | |
tree | 8d927b7b47a90c4adb646482a52613f58acd6f8c /doc/kwallet/index.docbook | |
download | tdeutils-2bda8f7717adf28da4af0d34fb82f63d2868c31d.tar.gz tdeutils-2bda8f7717adf28da4af0d34fb82f63d2868c31d.zip |
Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.
BUG:215923
git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdeutils@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'doc/kwallet/index.docbook')
-rw-r--r-- | doc/kwallet/index.docbook | 396 |
1 files changed, 396 insertions, 0 deletions
diff --git a/doc/kwallet/index.docbook b/doc/kwallet/index.docbook new file mode 100644 index 0000000..34b779e --- /dev/null +++ b/doc/kwallet/index.docbook @@ -0,0 +1,396 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ + <!ENTITY kwallet "<application>KWallet</application>"> + <!ENTITY kwalletmanager "<application>KWallet Manager</application>"> + <!ENTITY package "kdeutils"> + <!ENTITY kappname "&kwallet;"> + <!ENTITY % addindex "IGNORE"> + <!ENTITY % English "INCLUDE"> +]> + +<book lang="&language;"> +<bookinfo> +<title>The &kwallet; 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>&kwallet; 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>&kwallet; 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 &kwallet; &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="kwalletmanager"> +<title>&kwalletmanager;</title> + +<para>&kwalletmanager; 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 &kwalletmanager;.</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 &kwalletmanager; application is launched when +&kde; starts and remains in iconic form in the system tray. Alternatively, +when a wallet is opened, the &kwalletmanager; 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 &kwalletmanager; +window showing all available wallets as icons which reflect their +current status, either open or closed.</para> +<para> +<mediaobject> + <imageobject> + <imagedata fileref="kwalletmanager.png"/> + </imageobject> + </mediaobject></para> + + +<sect1 id="kwalletmanager-context-menu"> +<title>The &kwalletmanager; Context Menu</title> + +<para><mousebutton>Right</mousebutton> clicking on a wallet in the +&kwalletmanager; 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="kwalletmanager-wallet-window"> +<title>The Wallet Window</title> + +<para>Double clicking on a wallet in the &kwalletmanager; 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="kwallet-kcontrol-module"> +<title>Configuring &kwallet;</title> + +<sect1 id="wallet-preferences"> +<title><guilabel>Wallet Preferences</guilabel></title> + +<para>&kwallet; contains a small configuration panel with several options +that allow you to tune &kwallet; to your personal preferences. The +default settings for &kwallet; 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 &kwallet; is entirely disabled and +none of the other options here have any effect, nor will &kwallet; 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 &kwalletmanager; 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>&kwallet; © 2003 &George.Staikos;</para> +<para>Documentation © &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 +--> |