Package dev.enola.common.secret.gnome

Class GnomeSecretManager

java.lang.Object

dev.enola.common.secret.gnome.GnomeSecretManager

All Implemented Interfaces:

SecretManager, Closeable, AutoCloseable

public class GnomeSecretManager
extends Object
implements SecretManager, Closeable

GnomeSecretManager is a SecretManager implementation that uses the GNOME keyring via D-Bus. (An alternative would be to "shell out" and execute the external "secret-tool" command.)

Constructor Summary

Constructors

Constructor	Description
GnomeSecretManager()

Method Summary

Modifier and Type	Method	Description
void	close()
void	delete(String key)	Deletes a secret from the manager.
Optional<Secret>	getOptional(String key)	Retrieves a secret by its key, with optionality.
static void	main(String[] args)
void	store(String key, char[] value)	Stores a secret value associated with a unique key.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface dev.enola.common.secret.SecretManager

get

Constructor Details

GnomeSecretManager

public GnomeSecretManager()
                   throws IOException

Throws:

IOException

Method Details

store

public void store(String key,
 char[] value)
           throws IOException

Description copied from interface: SecretManager

Stores a secret value associated with a unique key. The sensitive value is provided as a char array. Implementations will zero out the input value array immediately after calling this method for security. If a secret with the same key already exists, its value is overwritten.

Specified by:

store in interface SecretManager

Parameters:

key - The unique key (name) for the secret.

value - The sensitive secret value as a character array.

Throws:

IOException - If an error occurs while storing the secret.

getOptional

public Optional<Secret> getOptional(String key)

Description copied from interface: SecretManager

Retrieves a secret by its key, with optionality.

Specified by:

getOptional in interface SecretManager

Parameters:

key - The unique key (name) of the secret to retrieve.

Returns:

An Optional containing the Secret, if found.

delete

public void delete(String key)

Description copied from interface: SecretManager

Deletes a secret from the manager.

Specified by:

delete in interface SecretManager

Parameters:

key - The unique key (name) of the secret to delete.

close

public void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

main

public static void main(String[] args)
                 throws IOException

Throws:

IOException