KeyStore - Reference Documentation
Class implementing access to Java key stores from JavaScript
Index of Methods
Properties
| Type | Name | Description |
|---|---|---|
| java.security.KeyStore | native | The native Java keystore object |
Constructor
Prototype
KeyStore(String provider, String type, String filename, String password)
KeyStore(String provider, String type, String filename)
KeyStore(String provider, String type)
KeyStore(String provider)
Description
Create and load key store
Arguments
| Type | Name | Description |
|---|---|---|
String
|
provider | Provider to use for key store access |
String
|
type | Key store type. Default is "jks". |
String
|
filename | Name of file containing keys. Default is empty. |
String
|
password | Password used to access key store. Default is no password. |
Exceptions
| Name | Value | Description |
|---|---|---|
| GPError | GPError.ARGUMENTS_MISSING | Too few arguments in call |
| GPError | GPError.INVALID_ARGUMENTS | Too many arguments in call |
| GPError | GPError.INVALID_TYPE | Type of argument is invalid for call |
| GPError | GPError.CRYPTO_FAILED | Accessing key store failed |
Example
var ks = new KeyStore("BC", "BKS", "sample.bks", "1234");
// var ks = new KeyStore("SUN", "JKS");
// var ks = new KeyStore("SunJCE", "JCEKS");
getAliases()
Prototype
String[] getAliases()
Description
Return list of aliases defined in key store.
Return
String[]
|
Array containing alias names from key store |
Exceptions
| Name | Value | Description |
|---|---|---|
| GPError | GPError.ARGUMENTS_MISSING | Too few arguments in call |
| GPError | GPError.INVALID_ARGUMENTS | Too many arguments in call |
| GPError | GPError.INVALID_TYPE | Type of argument is invalid for call |
| GPError | GPError.CRYPTO_FAILED | Accessing key failed |
Example
var aliases = ks.getAliases();
for (var i = 0; i < aliases.length; i++) {
print(aliases[i]);
}
getKey()
Prototype
getKey(Key key)
getKey(Key key, String password)
Description
Link key object with key instance in key store using the key id.
Arguments
| Type | Name | Description |
|---|---|---|
Key
|
key | Key object |
String
|
password | Password to access key instance |
Return
|
Exceptions
| Name | Value | Description |
|---|---|---|
| GPError | GPError.ARGUMENTS_MISSING | Too few arguments in call |
| GPError | GPError.INVALID_ARGUMENTS | Too many arguments in call |
| GPError | GPError.INVALID_TYPE | Type of argument is invalid for call |
| GPError | GPError.CRYPTO_FAILED | Accessing key failed |
Example
var k = new Key();
k.setType(Key.PRIVATE);
k.setID("openscdp");
ks.getKey(k, "1234");
getCertificate()
Prototype
getCertificate(String alias)
Description
Get named certificate from keystore.
Arguments
| Type | Name | Description |
|---|---|---|
String
|
alias | Alias name of certificate |
Return
|
Exceptions
| Name | Value | Description |
|---|---|---|
| GPError | GPError.ARGUMENTS_MISSING | Too few arguments in call |
| GPError | GPError.INVALID_ARGUMENTS | Too many arguments in call |
| GPError | GPError.INVALID_TYPE | Type of argument is invalid for call |
Example
var cert = ks.getCertificate("openscdp");
assert(cert.getSubjectDNString() == "E=support@openscdp.org,C=DE,L=Minden," +
"O=CardContact,CN=OpenSCDP");
setKey()
Prototype
setKey(Key key)
setKey(Key key, String password)
setKey(Key key, String password, X590[] certificates)
Description
Store key in key store, encrypted with optional password. Private keys may only be stored with associated certificate chain.
Arguments
| Type | Name | Description |
|---|---|---|
Key
|
key | Key object |
String
|
password | Password to access key instance |
X509[]
|
certificates | Chain of certificates |
Return
|
Exceptions
| Name | Value | Description |
|---|---|---|
| GPError | GPError.ARGUMENTS_MISSING | Too few arguments in call |
| GPError | GPError.INVALID_ARGUMENTS | Too many arguments in call |
| GPError | GPError.INVALID_TYPE | Type of argument is invalid for call |
| GPError | GPError.CRYPTO_FAILED | Accessing key failed |
Example
k.setID("test");
ks.setKey(k, "1234", [cert]);
setCertificate()
Prototype
setCertificate(String alias, X509 certificate)
Description
Store certificate in key store.
Arguments
| Type | Name | Description |
|---|---|---|
X509
|
certificate | Certificate |
Return
|
Exceptions
| Name | Value | Description |
|---|---|---|
| GPError | GPError.ARGUMENTS_MISSING | Too few arguments in call |
| GPError | GPError.INVALID_ARGUMENTS | Too many arguments in call |
| GPError | GPError.INVALID_TYPE | Type of argument is invalid for call |
| GPError | GPError.CRYPTO_FAILED | Accessing key failed |
Example
ks.setCertificate("test", cert);
store()
Prototype
store()
store(String filename)
setKey(String filename, String password)
Description
Save keystore to persistent storage
Arguments
| Type | Name | Description |
|---|---|---|
String
|
filename | File name for storing the key store |
String
|
password | Password to access key instance |
Return
|
Exceptions
| Name | Value | Description |
|---|---|---|
| GPError | GPError.ARGUMENTS_MISSING | Too few arguments in call |
| GPError | GPError.INVALID_ARGUMENTS | Too many arguments in call |
| GPError | GPError.INVALID_TYPE | Type of argument is invalid for call |
| GPError | GPError.CRYPTO_FAILED | Accessing key failed |
Example
ks.store("newstore.bks", "1234");
© Copyright 2003 - 2013 CardContact Software & System Consulting, Minden, Germany