Frequently Asked Questions

Adaptor module

  1. How do I use this module ?

Freedesktop Secrets

  1. What is this ?
  2. What are the requirements to use it ?
  3. How do I setup JSAGA in order to use passwords stored in my desktop environment ?
  4. How do I define/manage passwords in my desktop environment ?
  5. Why do I get this error "no unix-java in java.library.path" ?
  6. Why do I get this error "Your Gnome keyring or KDE KWallet should be installed and running" ?
  7. Why do I get this error "The collection does not exist" ?
  8. Why do I get this error "The collection is empty" ?
  9. Why do I get this error "The item is locked. Please unlock before using it." ?
  10. Why do I get this error "No credential matching Label" ?

Adaptor module

How do I use this module ?
The command "jsaga-help" provides some useful information about the usage and the current configuration of the plug-ins. 
jsaga-help -help
If this command does not provides the answer to your question, then please contact us so that we can fill out this FAQ.

[top]

Freedesktop Secrets

What is this ?
It is a security adaptor that will allow JSAGA to use passwords stored in your desktop environment (Gnome-keyring or KDE KWallet)

[top]

What are the requirements to use it ?
  • You must use Gnome or KDE>=4.8
  • You must install the libmatthew-java library (available at http://www.matthew.ath.cx/projects/java/ or on some Linux distros) Then you have to specify the appropriate library path where you have installed the libmatthew library (using PREFIX) using the "java.library.path" property: 
    java.library.path=/your/path/to/libmatthew/lib/jni/

[top]

How do I setup JSAGA in order to use passwords stored in my desktop environment ?
Use a context of type "gnome-keyring" pr "kwallet" (depending on your desktop) with following attributes:
  • Collection: name of the keyring (Gnome) or Folder (KWallet) that contains the password (for example 'login' is the Gnome keyring with all passwords available after logged in). The default is 'login' for Gnome and 'passwords' for KDE
  • Id: unique identifier of a password
  • Label: name of the password to get
  • Attribute-xxx: key-dependent attribute (for example if your password has attrbute protocol=xmpp, use Attribute-protocol)
  • UserID: user name that will be used by JSAGA associated with the password found
If "Id" is given, only one password can match. All other attributes are ignored. If "Id" is not given, the first password that matches attributes of type Attribute-xxx and that matches Label if given is taken.

[top]

How do I define/manage passwords in my desktop environment ?
In gnome, use "Seahorse". In KDE, use "KWallet"

[top]

Why do I get this error "no unix-java in java.library.path" ?
Check that the "java.library.path" property points to the location you have installed libmatthew: "/path/to/libmatthew/lib/jni"

[top]

Why do I get this error "Your Gnome keyring or KDE KWallet should be installed and running" ?
You are not runnning Gnome nor KDE (>= 4.8), or the corresponding service is not running. Check your desktop system documentation

[top]

Why do I get this error "The collection does not exist" ?
The collection that you specified in attributes (or the default value) does not exist

[top]

Why do I get this error "The collection is empty" ?
The collection that you specified in attributes does not contain any password

[top]

Why do I get this error "The item is locked. Please unlock before using it." ?
The password or key is locked and cannot be used until you unlock it on your desktop.

[top]

Why do I get this error "No credential matching Label" ?
No password label matches the Label you specifiy in attributes.

[top]