From 2bda8f7717adf28da4af0d34fb82f63d2868c31d Mon Sep 17 00:00:00 2001 From: toma Date: Wed, 25 Nov 2009 17:56:58 +0000 Subject: 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 --- doc/kwallet/Makefile.am | 4 + doc/kwallet/cr22-action-wallet_closed.png | Bin 0 -> 997 bytes doc/kwallet/cr22-action-wallet_open.png | Bin 0 -> 1098 bytes doc/kwallet/edit1.png | Bin 0 -> 19314 bytes doc/kwallet/edit2.png | Bin 0 -> 26113 bytes doc/kwallet/edit3.png | Bin 0 -> 59244 bytes doc/kwallet/index.docbook | 396 ++++++++++++++++++++++++++++++ doc/kwallet/kwalletmanager.png | Bin 0 -> 11282 bytes doc/kwallet/password1.png | Bin 0 -> 19088 bytes doc/kwallet/password2.png | Bin 0 -> 21999 bytes 10 files changed, 400 insertions(+) create mode 100644 doc/kwallet/Makefile.am create mode 100644 doc/kwallet/cr22-action-wallet_closed.png create mode 100644 doc/kwallet/cr22-action-wallet_open.png create mode 100644 doc/kwallet/edit1.png create mode 100644 doc/kwallet/edit2.png create mode 100644 doc/kwallet/edit3.png create mode 100644 doc/kwallet/index.docbook create mode 100644 doc/kwallet/kwalletmanager.png create mode 100644 doc/kwallet/password1.png create mode 100644 doc/kwallet/password2.png (limited to 'doc/kwallet') diff --git a/doc/kwallet/Makefile.am b/doc/kwallet/Makefile.am new file mode 100644 index 0000000..085981d --- /dev/null +++ b/doc/kwallet/Makefile.am @@ -0,0 +1,4 @@ + +KDE_LANG = en +KDE_DOCS = AUTO + diff --git a/doc/kwallet/cr22-action-wallet_closed.png b/doc/kwallet/cr22-action-wallet_closed.png new file mode 100644 index 0000000..57558ac Binary files /dev/null and b/doc/kwallet/cr22-action-wallet_closed.png differ diff --git a/doc/kwallet/cr22-action-wallet_open.png b/doc/kwallet/cr22-action-wallet_open.png new file mode 100644 index 0000000..55a447f Binary files /dev/null and b/doc/kwallet/cr22-action-wallet_open.png differ diff --git a/doc/kwallet/edit1.png b/doc/kwallet/edit1.png new file mode 100644 index 0000000..1d0fe7c Binary files /dev/null and b/doc/kwallet/edit1.png differ diff --git a/doc/kwallet/edit2.png b/doc/kwallet/edit2.png new file mode 100644 index 0000000..05b6dd8 Binary files /dev/null and b/doc/kwallet/edit2.png differ diff --git a/doc/kwallet/edit3.png b/doc/kwallet/edit3.png new file mode 100644 index 0000000..9292870 Binary files /dev/null and b/doc/kwallet/edit3.png differ 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 @@ + +KWallet"> + KWallet Manager"> + + + + +]> + + + +The &kwallet; Handbook + + + +&George.Staikos; &George.Staikos.mail; + + +&Lauri.Watts; &Lauri.Watts.mail; + + +GeorgeStaikos +
staikos@kde.org
 +Developer + + + + +&FDLNotice; + +2005-06-15 +1.0 + + + +The wallet subsytem provides a convenient and secure way to manage all your +passwords. + + + + + +KDE +Kwallet +passwords +forms + + + + + +Introduction + +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. + +&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. + + +&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. + + +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. + + + + +&kwalletmanager; + +&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;. + +You may also manage the wallets installed on the system, creating and +deleting wallets and manipulating their contents (changing keys, ...). + +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: + + + + + + +When all +wallets are closed, the icon will reflect this by showing a closed +wallet: + + + + + + + + +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. + + + + + + + + + +The &kwalletmanager; Context Menu + +Right clicking on a wallet in the +&kwalletmanager; window offers +the following functions: + + + + +New Wallet... + +Create a new wallet. A dialog box will ask you +for the name of the new wallet that you want to create. + + + + +&Enter; +Open... + +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. + + + + + + + + + + + + +Change Password + +Change the master password for the wallet. + + + + +Disconnect +Disconnect an application from the wallet. Currently +connected applications will appear in a submenu. + + + +Close +Force the wallet to be closed. + + + +Delete + +Delete the wallet + + + + + + +The Wallet Window + +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. + + +The window has four panes: + + + + + + + + + +A summary of the contents of the current +folder +The folders contained in the wallet +The entries in the currently selected +folder +The contents of the selected folder entry + + +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. + + + + + + + + +Entries may also be created or deleted via the context menu for the +folder contents. + +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. + + + + + + +Configuring &kwallet; + + +<guilabel>Wallet Preferences</guilabel> + +&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. + +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. + + +<guilabel>Close Wallet</guilabel> + +Close when unused for: + +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. + + + + +Close when screen saver starts + +Close the wallet as soon as the screensaver starts. When a wallet is +closed, the password is needed to access it again. + + + + +Close when last application stops using it + +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. + + + + + +<guilabel>Automatic Wallet Selection</guilabel> + +Select wallet to use as default: + +Select which wallet you want to use as default wallet. + + + + +Different wallet for local passwords: + +If checked, choose a different wallet for local passwords. + + + + + +<guilabel>Wallet Manager</guilabel> + +Show manager in system tray + +Enable the wallet manager to have its icon in the system tray. + + + + +Hide System tray icon when last wallet +closes + +When there is no wallet in use anymore, remove the wallet icon from the +system tray. + + + + +Finally, there is a button labelled Launch Wallet +Manager, which does precisely that. + + + +<guilabel>Access Control</guilabel> + +There is only one option on this page: + + + +Prompt when an application accesses an open wallet + +Signal you when an application gains access to an open wallet. + + + + +Next there is a tree style view of the access controls for your wallets. + +&LMB; click on the + 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 Delete From the +context menu that appears, or by simply selecting it and pressing the +Delete key. + + + + + + +Advanced Features + +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. + +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. + +Future versions will have built-in functions for easy export or +copying of data to portable devices. + + + + +Credits and Licenses + +&kwallet; © 2003 &George.Staikos; +Documentation © &Lauri.Watts; and &George.Staikos; + + + +&underFDL; +&underGPL; + + + +&documentation.index; + + + + diff --git a/doc/kwallet/kwalletmanager.png b/doc/kwallet/kwalletmanager.png new file mode 100644 index 0000000..67c7220 Binary files /dev/null and b/doc/kwallet/kwalletmanager.png differ diff --git a/doc/kwallet/password1.png b/doc/kwallet/password1.png new file mode 100644 index 0000000..d5cb22a Binary files /dev/null and b/doc/kwallet/password1.png differ diff --git a/doc/kwallet/password2.png b/doc/kwallet/password2.png new file mode 100644 index 0000000..c116e93 Binary files /dev/null and b/doc/kwallet/password2.png differ -- cgit v1.2.3