Package de.willuhn.jameica.security
Class Wallet
java.lang.Object
de.willuhn.jameica.security.Wallet
Liefert eine Art Brieftasche, ueber die andere Klassen Daten
verschluesselt abspeichern koennen.
HINWEIS: Das Wallet verwendet zum Verschluesseln per Default den asymmetrischen RSA-Algorithmus (es sei denn, es wurde explizit eine andere Engine angegeben). Es ist im Default-Fall also nicht fuer groessere Daten (Dateien, Streams, etc.) geeignet sondern typischerweise fuer Passwoerter.
Will zum Beispiel ein Plugin irgendwelche Passwort-Informationen sicher speichern, dann kann es mittels folgenden Codes ein Wallet erzeugen:
// erzeugt eine neue Wallet-Datei in ~/.jameica/cfg mit dem
// Dateinamen "beliebige.Klasse.wallet2"
Wallet wallet = new Wallet(beliebige.Klasse.class);
// Speichern des Passwortes "geheim" unter dem Alias "passwort".
wallet.set("passwort","geheim");
// Auslesen des Passwortes "geheim".
String password = wallet.getString("passwort");
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionLoescht den genanten Alias.void
Loescht alle Nutzdaten, deren Alias-Name mit dem angegebenen beginnt.Liefert den Wert des genannten Alias-Namen entschluesselt.String[]
Liefert alle Keys, deren Name mit dem Prefix beginnt.getKeys()
Liefert eine Liste aller Aliases in diesem Wallet.void
set
(String alias, Serializable data) Speichert einen Datensatz verschluesselt in dem Wallet.void
Legt fest, mit welcher Crypto-Engine die Speicherung erfolgen soll.
-
Constructor Details
-
Method Details
-
setEngine
Legt fest, mit welcher Crypto-Engine die Speicherung erfolgen soll.- Parameters:
engine
- die zu verwendende Engine.
-
set
Speichert einen Datensatz verschluesselt in dem Wallet.- Parameters:
alias
- Alias-Name.data
- Nutzdaten, die verschluesselt gespeichert werden sollen odernull
wenn der Wert geloescht werden soll.- Throws:
Exception
-
delete
Loescht den genanten Alias.- Parameters:
alias
- Name des zu loeschenden Alias.- Returns:
- der geloeschte Wert hinter dem Alias.
- Throws:
Exception
-
deleteAll
Loescht alle Nutzdaten, deren Alias-Name mit dem angegebenen beginnt. Wird als Prefixnull
oder ein Leerstring angegeben, wird das komplette Wallet geleert.- Parameters:
aliasPrefix
- Alias-Prefix.- Throws:
Exception
-
getAll
Liefert alle Keys, deren Name mit dem Prefix beginnt. Wirdnull
uebergeben, werden alle Keys zurueckgeliefert.- Parameters:
aliasPrefix
- Alias-Prefix.- Returns:
- Liste der gefundenen Keys.
Die Funktion liefert nie
null
sondern hoechstens ein leeres Array. - Throws:
Exception
-
getKeys
Liefert eine Liste aller Aliases in diesem Wallet.- Returns:
- Liste der Aliases.
-
get
Liefert den Wert des genannten Alias-Namen entschluesselt.- Parameters:
alias
- Alias-Name.- Returns:
- Nutzdaten.
-