|
Eclipse Platform Release 3.4 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.eclipse.osgi.service.security.TrustEngine
A TrustEngine
is used to establish the authenticity of a
Certificate
chain.
Clients may implement this interface.
Constructor Summary | |
TrustEngine()
|
Method Summary | |
String |
addTrustAnchor(Certificate anchor,
String alias)
Add a trust anchor point to this trust engine. |
protected abstract String |
doAddTrustAnchor(Certificate anchor,
String alias)
Add a trust anchor point to this trust engine. |
protected abstract void |
doRemoveTrustAnchor(Certificate anchor)
Remove a trust anchor point from the engine, based on the certificate itself. |
protected abstract void |
doRemoveTrustAnchor(String alias)
Remove a trust anchor point from the engine, based on the human readable "friendly name" |
abstract Certificate |
findTrustAnchor(Certificate[] chain)
Returns the certificate trust anchor contained in the specified chain which was used to establish the authenticity of the chain. |
abstract String[] |
getAliases()
Return the list of friendly name aliases for the TrustAnchors installed in the engine. |
abstract String |
getName()
Return a representation string of this trust engine |
abstract Certificate |
getTrustAnchor(String alias)
Return the certificate associated with the unique "friendly name" in the engine. |
abstract boolean |
isReadOnly()
Return a value indicate whether this trust engine is read-only. |
void |
removeTrustAnchor(Certificate anchor)
Remove a trust anchor point from the engine, based on the certificate itself. |
void |
removeTrustAnchor(String alias)
Remove a trust anchor point from the engine, based on the human readable "friendly name" |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public TrustEngine()
Method Detail |
public abstract Certificate findTrustAnchor(Certificate[] chain) throws IOException
null
is returned.
chain
- - a complete or incomplete certificate chain, implementations *MAY* complete chains
IOException
- if there is a problem connecting to the backing storepublic String addTrustAnchor(Certificate anchor, String alias) throws IOException, GeneralSecurityException
null
is used
as the alias then an alias will be generated based on the trust anchor certificate.
anchor
- - the certificate to add as an anchor pointalias
- - a unique and human-readable 'friendly name' which can be used to reference the certificate.
A null
value may be used.
IOException
- if there is a problem connecting to the backing store
GeneralSecurityException
- if there is a certificate problem
IllegalArgumentException
- if the alias or anchor already exist in this trust engineprotected abstract String doAddTrustAnchor(Certificate anchor, String alias) throws IOException, GeneralSecurityException
null
is used
as the alias then an alias will be generated based on the trust anchor certificate.
anchor
- - the certificate to add as an anchor pointalias
- - a unique and human-readable 'friendly name' which can be used to reference the certificate.
A null
value may be used.
IOException
- if there is a problem connecting to the backing store
GeneralSecurityException
- if there is a certificate problem
IllegalArgumentException
- if the alias or anchor already exist in this trust enginepublic final void removeTrustAnchor(Certificate anchor) throws IOException, GeneralSecurityException
anchor
- - the certificate to be removed
IOException
- if there is a problem connecting to the backing store
GeneralSecurityException
- if there is a certificate problemprotected abstract void doRemoveTrustAnchor(Certificate anchor) throws IOException, GeneralSecurityException
anchor
- - the certificate to be removed
IOException
- if there is a problem connecting to the backing store
GeneralSecurityException
- if there is a certificate problempublic void removeTrustAnchor(String alias) throws IOException, GeneralSecurityException
alias
- - the name of the trust anchor
IOException
- if there is a problem connecting to the backing store
GeneralSecurityException
- if there is a certificate problemprotected abstract void doRemoveTrustAnchor(String alias) throws IOException, GeneralSecurityException
alias
- - the name of the trust anchor
IOException
- if there is a problem connecting to the backing store
GeneralSecurityException
- if there is a certificate problempublic abstract Certificate getTrustAnchor(String alias) throws IOException, GeneralSecurityException
alias
- - the friendly name
IOException
- if there is a problem connecting to the backing store
GeneralSecurityException
- if there is a certificate problempublic abstract String[] getAliases() throws IOException, GeneralSecurityException
IOException
- if there is a problem connecting to the backing store
GeneralSecurityException
- if there is a certificate problempublic abstract boolean isReadOnly()
public abstract String getName()
|
Eclipse Platform Release 3.4 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Guidelines for using Eclipse APIs.
Copyright (c) Eclipse contributors and others 2000, 2008. All rights reserved.