Building and Using the Secret Service Java API | CodeGuru

Building and Using the Secret Service Java API

The Secret Service API was jointly designed by the Gnome keyring and the KDE KWallet developers in order to have a standard way for desktop applications to access and manage stored passwords in both Gnome and KDE environments. In this article I will show you how to generate java code for the Secret Service API […]

Written By
CodeGuru Staff
CodeGuru Staff
Feb 21, 2012
1 minute read
CodeGuru content and product recommendations are editorially independent. We may make money when you click on links to our partners. Learn More

The Secret Service API was jointly designed by the Gnome keyring and the KDE KWallet developers in order to have a standard way for desktop applications to access and manage stored passwords in both Gnome and KDE environments.

In this article I will show you how to generate java code for the Secret Service API and then use it in your Java application.

A Bit of Terminology

If you are a Gnome user, passwords and keys are stored and managed by the GNOME Keyring Manager. The GUI to access passwords is a program called Seahorse.
In gnome-keyring, passwords and keys are stored in keyrings. For example the keyring that contains all passwords and keys that you will be able to use
after logging into your Gnome environment is called ‘login’.

In the KDE environment the application is called KWallet. Passwords and keys are stored in a so-called ‘Folder’.
The Secret Service API is implemented from KDE-4.8 in the KSecretService module used by KWallet.

In the Secret Service API terminology, passwords and keys are called ‘Items’. Keyrings and folders are called ‘Collections’

Mapping between SecretService API and desktop terminology
Secret Service API collection item
Gnome keyring user/password;key
KDE folder user/password;key

Use cases in this article were designed for the Gnome environment. They are of course aimed to work under the KDE 4.8 environment.

CodeGuru Logo

CodeGuru covers topics related to Microsoft-related software development, mobile development, database management, and web application programming. In addition to tutorials and how-tos that teach programmers how to code in Microsoft-related languages and frameworks like C# and .Net, we also publish articles on software development tools, the latest in developer news, and advice for project managers. Cloud services such as Microsoft Azure and database options including SQL Server and MSSQL are also frequently covered.

Property of TechnologyAdvice. © 2026 TechnologyAdvice. All Rights Reserved

Advertiser Disclosure: Some of the products that appear on this site are from companies from which TechnologyAdvice receives compensation. This compensation may impact how and where products appear on this site including, for example, the order in which they appear. TechnologyAdvice does not include all companies or all types of products available in the marketplace.