Manual

Manual

Getting started

Getting started

TODO

Account types explained

Account types explained

KisKis provides some basic account types for different purposes, such as “Network Accounts”, “Bank Accounts”, “Secured Files” and “Credit Cards”. However, if the attributes of them doesn't meet your needs, you can define your own account types in an easy way.

Network Account

Network Account

This is the most often used account type. It can be used for computer-logins, mailserver-authentications, internet services and so on.

The network account provides additional attributes for:

  1. username: Typical use is the login name of an internet service or computer account.

  2. URL: The location where the service or computer can be found. This URL can be delivered to the Build-In-Application-Starter, so that you can associate your preferred application to it. Therefore, you would have to click on the button “open URL”. Examples: http://www.foo.de/?un=%username&pwd=%pwd or pop://mail.foo.de/

  3. eMail: If anybody wanted to know an email address you can type it in here. This is very useful if you have multiple email accounts and if you want to keep track which account knows which email address, especially if you use such services like spamgourmet.com.

Bank Accounts

Bank Accounts

This account type models a typical money account on a bank. It provides some additional attributes needed for financial transactions such as “telephone-pin”, “account number”, ...

Notice the TAN-list field for Transaction-Numbers. It is used to define sets of TANs. Each TAN-list is identified by an ID and a creation date. Within the following dialog the TANs can be added, removed or marked as used.

Credit Card

Credit Card

A “Credit Card” is usually associated with a bank and has a tiny pin. Though, the most interesting part is its number which can be entered as well.

Secured File

Secured File

Sometimes files can be opened with a passphrase only. So you can define an account which is linked to the file. This files can be opened with your preferred filemanager. TODO: verlinken You can encrypt or decrypt them with OpenPGP as well.

Checking password quality

Checking password quality

You can check your password quality with two internal tools. The first is a simple analyzer which tests the strength of your password depending on the character set used. A character set describes numbers, lower-case letters, upper-case letters, punctuation, ... The more different character sets a password uses, the more secure it is because a brute force attack needs to take more possible variations into account.

The second way is a dictionary-based check using cracklib. The password is validated against a dictionary. If cracklib is able to find parts of the word in its dictionary you should use another password because a dictionary-based attack on your account could succeed with a high probability.

Using your own dictionary

Using your own dictionary

You can use your own wordlist as dictionary. Create a simple text-file with a word for each line. The words have to be sorted alphabetically.

Example:

aron

berta

# a comment will be ignored

julia

zoron

Once you created this file you can create a cracklib-dict. Just open “Edit/Options/Cracklib Dictionary”

The default should look as in the picture above.

  1. Enter a new name in “Cracklib Dictionary filename”, e. g. mydict.

  2. Click the button for “create new Dictionary from wordlist” and select your wordlist file.

  3. A new dictionary mydict.pwd will be created.

  4. Click on save.

You can use an existing cracklib-dictionary as well. Just click on “select an existing dictionary file” and select the “*.pwd”-file.

Managing your own account-templates

Managing your own account-templates

Open the menu item “Edit/Manage account templates” to open the template overview dialog.

Here you can see all your defined account templates. In this case, two were already defined. Note that an item is unqiuely identified by its name (case-sensitive). So you cannot have a second item called “My Credit Card”. All the templates are stored within your current datafile.

Adding templates

Adding templates

Just click on the “new”-button. A new item called “new template” will appear.

Editing templates

Editing templates

Double-click on the item of your choice to open the “template editor dialog”.

Name your template and add some tiny properties with “new” and “edit” to it. You can order them using the arrow buttons on the right panel.

Give each property a unqiue name within the template and chose a type out of the combo-box. As you can see, the following types are supported:

  1. Date: will be rendered as a date field.

  2. Password: will be rendered as a password field.

  3. String: will be rendered as a simple text field.

  4. URL: will be rendered as a URL-input field which allows you to start an associated application.

  5. TODO: RichText: will be rendered as a text area.

Warning:

Be careful when modifying a template you have already instanciated and filled with important data. New properties aren't a problem at all. But keep in mind, that deleting a property will delete ALL associated values from the instances as well. You should also note that deleting a template will delete all instances.

Deleting templates

Deleting templates

Just click on “delete” to remove the selected item. If the item is currently instanciated a warning will be shown.

Using templates

Using templates

Select a group-node within the tree-view and activate the menu-item “Edit/New item”. Chose a template out of the combo-box and click on the “new”-button.

Let's enter some values for the defined properties and apply the changes.

Importing CSV-files

Importing CSV-files

KisKis provides a basic feature to import existent data via “comma-separated-values”-files. Just activate the menu item “File/import” to start the procedure. Note that the imported accounts will be typed as “Network Accounts” and will be added to the opened file.

The CSV-file should be formatted as follows:

  1. A header with pre-defined values must be included:

    1. group

    2. label

    3. password

    4. username

    5. email

    6. url

    7. created (a date formatted as: YYYY-MM-DD)

    8. expiration (a date formatted as: YYYY-MM-DD)

    9. comment

  2. at least one row should exist

Example:

group | label | password | username | email | url | created

My Group | My Account Name | My Secret Password | MyUsername | foo@bar | http://localhost:8080/foo | 2004-01-01

My Group | Second | secret ||||

Notice the header in the first line and two different data rows. The order in the column header is not important.

You don't have to provide values for each column. You could use the header

label | password

as well and omit the other column values ( the rest will be filled with pre-defined standard values). But if you have defined two columns in the header, each data row MUST provide two columns as well (but a column can be empty). If you don't provide a group-column the root-node will receive the new account.

In this example the field-delimiter is '|'. You can chose any other character sequence, but be sure, that this sequence cannot be found within your data-values! Leading and trailing spaces within each field will be cut and ignored.

An import-action cannot be made undone.

Converting ASCII-files

To retrieve the specified format You can use existing office-applications like OpenOffice Calc or Microsoft Excel.

Just open the existing ASCII-file as a CSV-file, rename the columns, reformat the values if needed and save it back again as a CSV-file.

It might happen, that the office-application uses the '”'-character as a text-marker. In this case, You can remove them with a simple text-editor (VI, Notepad, ...) using the search-and-replace-function.

Howto Use The Build-In-Application-Starter

Howto Use The Build-In-Application-Starter

“Network Accounts” provide the facility to open an URL with an external program. The prefix of the URL will be matched with a list of defined prefixes for external programs.

Therefore you have perform the following steps:

  1. Register an application

    1. Open the menu item “Help/Options”

    2. Select the tab “Applications”

    3. Create a new entry in the ordered list. This list is processed from top. The first matching entry is executed. So you have to enter the more specific prefixes at first, the more general at last.

      1. Enter the command line that will start the program. Make sure, that the executable can be found by KisKis. A variable named “%url” can be placed within the command line. This variable will be substituted with an concrete URL when running the program.

      2. Enter an URL-prefix for this entry.

    4. Save the changes.

  2. Enter an URL in a new “Network Account”

    1. Create a new “Network Account” by “edit/new account/Network Account”.

    2. Enter a password, username, email and URL in the specific fields.

    3. The URL can contain some extra variables which will be substituted like:

      1. %username

      2. %pwd

      3. %email

    4. Apply the changes.

    5. Push the button “Open URL”. The external program should now be opened.

Examples:

Examples:
Application List (Windows)
Application List (Windows)

1:http://localhost => c:\opera\opera.exe %url

2:http => d:\firefox\firefox.exe -remote "openURL(

%url, new-tab)”

3:=> explorer.exe %url

Application List (Linux)
Application List (Linux)

1:http://localhost => /opt/opera/opera %url

2:http => /opt/firefox/firefox -remote "openURL(

%url, new-tab)”

3:=> kfmclient exec %url

As you can see, all Web-Sites on your local machine will be opened by Opera (line 1), the rest is viewed using Firefox (2). Line 3 will be used for all URL's which begin with anything but http.

Defining URL's

1: http://localhost?un= %username &p= %pwd &mail= %email

Technical notes about attachments

Normally you should not be bothered with the manual decryption of attachments, but here is how it works:

File attachments are stored as separate files which are associated with the password-file (e. g. kiskis.xml) by name for efficiency reasons. All attachments of kiskis.xml can be found as kiskis.xml.attachment.<i> encrypted as separate PGP-Messages. Each attachment is encrypted with a new random key which you can find within the kiskis.xml-file in the <Attachment>-element.