Package org.jdesktop.swingx.auth

Class KeyChain

java.lang.Object

org.jdesktop.swingx.auth.KeyChain

public class KeyChain
extends Object

KeyChain is a class that implements the "KeyChain" concept. Fundamentally, it allows you to store multiple keys/credentials in a central password store. Access to this central store is controlled through a master password. This mechanism is used in many popular client applications where you need to store credentials for multiple servers/accounts. The actual store for the KeyStore can be any OutputStream and it can work in the webstart sandbox using Muffins.

To contstruct a KeyChain, you need to pass in an InputStream to the store and it will initialize the KeyStore from the InputStream. You can add and remove entries any time once you have an instance of KeyChain. To persist the KeyChain and reflect any changes, you need to call store method with an OutputStream.

Author:

Bino George

Constructor Summary

Constructors

Constructor	Description
KeyChain(char[] masterPassword, InputStream inputStream)	Creates an instance of KeyChain and initializes the store from the InputStream.

Method Summary

Modifier and Type	Method	Description
void	addPassword(String user, String server, char[] password)	Adds a password to the KeyChain for a given account/user and server.
String	getPassword(String user, String server)	Fetches the password for a given account/user and server.
void	removePassword(String user, String server)	Removes a password for a given account/user and server.
void	store(OutputStream ostream)	Persists the KeyChain to an OutputStream

Methods inherited from class java.lang.Object

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

Constructor Details

KeyChain

public KeyChain(char[] masterPassword,
 InputStream inputStream)
         throws IOException

Creates an instance of KeyChain and initializes the store from the InputStream.

Parameters:

masterPassword -

inputStream -

Throws:

IOException

Method Details

getPassword

public String getPassword(String user,
 String server)

Fetches the password for a given account/user and server.

Parameters:

user -

server -

Returns:

null if no password could be obtained, the password otherwise

addPassword

public void addPassword(String user,
 String server,
 char[] password)

Adds a password to the KeyChain for a given account/user and server.

Parameters:

user -

server -

password -

removePassword

public void removePassword(String user,
 String server)

Removes a password for a given account/user and server.

Parameters:

user -

server -

store

public void store(OutputStream ostream)
           throws IOException

Persists the KeyChain to an OutputStream

Parameters:

ostream -

Throws:

IOException