Interface KeyIdentityProvider
- All Known Subinterfaces:
AuthenticationIdentitiesProvider
,KeyPairProvider
- All Known Implementing Classes:
AbstractGeneratorHostKeyProvider
,AbstractKeyPairProvider
,AbstractResourceKeyPairProvider
,BouncyCastleGeneratorHostKeyProvider
,BuiltinClientIdentitiesWatcher
,ClassLoadableResourceKeyPairProvider
,ClientIdentitiesWatcher
,DefaultClientIdentitiesWatcher
,FileKeyPairProvider
,LazyClientKeyIdentityProvider
,MappedKeyPairProvider
,MultiKeyIdentityProvider
,SimpleGeneratorHostKeyProvider
- Functional Interface:
- This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final KeyIdentityProvider
An "empty" implementation ofKeyIdentityProvider
that returns an empty group of key pairs -
Method Summary
Modifier and TypeMethodDescriptionstatic KeyPair
Attempts to find the first non-null
KeyPair
static boolean
isEmpty
(KeyIdentityProvider provider) iterableOf
(SessionContext session, Collection<? extends KeyIdentityProvider> providers) loadKeys
(SessionContext session) Load available keys.static KeyIdentityProvider
multiProvider
(Collection<? extends KeyIdentityProvider> providers) Wraps a group ofKeyIdentityProvider
into a single onestatic KeyIdentityProvider
multiProvider
(KeyIdentityProvider... providers) Wraps a group ofKeyIdentityProvider
into a single onestatic KeyIdentityProvider
resolveKeyIdentityProvider
(KeyIdentityProvider identities, KeyIdentityProvider keys) Creates a "unified"KeyIdentityProvider
out of 2 possible ones as follows:static KeyIdentityProvider
wrapKeyPairs
(Iterable<KeyPair> pairs) Wraps a group ofKeyPair
s into aKeyIdentityProvider
static KeyIdentityProvider
wrapKeyPairs
(KeyPair... pairs) Wraps a group ofKeyPair
s into aKeyIdentityProvider
-
Field Details
-
EMPTY_KEYS_PROVIDER
An "empty" implementation ofKeyIdentityProvider
that returns an empty group of key pairs
-
-
Method Details
-
loadKeys
Load available keys.- Parameters:
session
- TheSessionContext
for invoking this load command - may benull
if not invoked within a session context (e.g., offline tool or session unknown).- Returns:
- an
Iterable
instance of available keys - ignored ifnull
- Throws:
IOException
- If failed to read/parse the keys dataGeneralSecurityException
- If failed to generate the keys
-
isEmpty
- Parameters:
provider
- TheKeyIdentityProvider
instance to verify- Returns:
true
if instance isnull
or theEMPTY_KEYS_PROVIDER
-
resolveKeyIdentityProvider
static KeyIdentityProvider resolveKeyIdentityProvider(KeyIdentityProvider identities, KeyIdentityProvider keys) Creates a "unified"
KeyIdentityProvider
out of 2 possible ones as follows:- If both are
null
then returnnull
. - If either one is
null
/empty
then use the non-null
one. - If both are the same instance then use the instance.
- Otherwise, returns a wrapper that groups both providers.
- Parameters:
identities
- The registered key pair identitieskeys
- The extra available key pairs- Returns:
- The resolved provider
- See Also:
- If both are
-
multiProvider
Wraps a group ofKeyIdentityProvider
into a single one- Parameters:
providers
- The providers - ignored ifnull
/empty (i.e., returnsEMPTY_KEYS_PROVIDER
)- Returns:
- The wrapping provider
- See Also:
-
multiProvider
Wraps a group ofKeyIdentityProvider
into a single one- Parameters:
providers
- The providers - ignored ifnull
/empty (i.e., returnsEMPTY_KEYS_PROVIDER
)- Returns:
- The wrapping provider
- See Also:
-
iterableOf
static Iterable<KeyPair> iterableOf(SessionContext session, Collection<? extends KeyIdentityProvider> providers) - Parameters:
session
- TheSessionContext
for invoking this load command - may benull
if not invoked within a session context (e.g., offline tool or session unknown).providers
- The group of providers - ignored ifnull
/empty (i.e., returns an empty iterable instance)- Returns:
- The wrapping iterable
-
wrapKeyPairs
Wraps a group ofKeyPair
s into aKeyIdentityProvider
- Parameters:
pairs
- The key pairs - ignored ifnull
/empty (i.e., returnsEMPTY_KEYS_PROVIDER
).- Returns:
- The provider wrapper
-
wrapKeyPairs
Wraps a group ofKeyPair
s into aKeyIdentityProvider
- Parameters:
pairs
- The key pairsIterable
- ignored ifnull
(i.e., returnsEMPTY_KEYS_PROVIDER
).- Returns:
- The provider wrapper
-
exhaustCurrentIdentities
Attempts to find the first non-null
KeyPair
- Parameters:
ids
- TheIterator
- ignored ifnull
or no next element available- Returns:
- The first non-
null
key pair found in the iterator -null
if all elements exhausted without such an entry
-