org.springframework.credhub.core.credential

Interface ReactiveCredHubCredentialOperations

All Known Implementing Classes:

ReactiveCredHubCredentialTemplate

public interface ReactiveCredHubCredentialOperations

Specifies the interactions with CredHub to save, generate, retrieve, and delete credentials.

Author:

Scott Frederick

Method Summary

Modifier and Type	Method and Description
reactor.core.publisher.Mono<java.lang.Void>	deleteByName(CredentialName name) Delete a credential by its full name.
reactor.core.publisher.Flux<CredentialSummary>	findByName(CredentialName name) Find a credential using a full or partial name.
reactor.core.publisher.Flux<CredentialSummary>	findByPath(java.lang.String path) Find a credential using a path.
<T,P> reactor.core.publisher.Mono<CredentialDetails<T>>	generate(ParametersRequest<P> parametersRequest, java.lang.Class<T> credentialType) Generate a new credential in CredHub, or overwrite an existing credential with a new generated value.
<T> reactor.core.publisher.Mono<CredentialDetails<T>>	getById(java.lang.String id, java.lang.Class<T> credentialType) Retrieve a credential using its ID, as returned in a write request.
<T> reactor.core.publisher.Mono<CredentialDetails<T>>	getByName(CredentialName name, java.lang.Class<T> credentialType) Retrieve a credential using its name, as passed to a write request.
<T> reactor.core.publisher.Flux<CredentialDetails<T>>	getByNameWithHistory(CredentialName name, java.lang.Class<T> credentialType) Retrieve a credential using its name, as passed to a write request.
<T> reactor.core.publisher.Flux<CredentialDetails<T>>	getByNameWithHistory(CredentialName name, int versions, java.lang.Class<T> credentialType) Retrieve a credential using its name, as passed to a write request.
<T> reactor.core.publisher.Mono<CredentialDetails<T>>	regenerate(CredentialName name, java.lang.Class<T> credentialType) Regenerate a credential in CredHub.
<T> reactor.core.publisher.Mono<CredentialDetails<T>>	write(CredentialRequest<T> credentialRequest) Write a new credential to CredHub, or overwrite an existing credential with a new value.

Method Detail

write

<T> reactor.core.publisher.Mono<CredentialDetails<T>> write(CredentialRequest<T> credentialRequest)

Write a new credential to CredHub, or overwrite an existing credential with a new value.

Type Parameters:

T - the credential implementation type

Parameters:

credentialRequest - the credential to write to CredHub; must not be null

Returns:

the details of the written credential

generate

<T,P> reactor.core.publisher.Mono<CredentialDetails<T>> generate(ParametersRequest<P> parametersRequest,
                                                                 java.lang.Class<T> credentialType)

Generate a new credential in CredHub, or overwrite an existing credential with a new generated value.

Type Parameters:

T - the credential implementation type

P - the credential parameter implementation type

Parameters:

parametersRequest - the parameters of the new credential to generate in CredHub; must not be null

credentialType - the type of the credential to be regenerated; must not be null

Returns:

the details of the generated credential

regenerate

<T> reactor.core.publisher.Mono<CredentialDetails<T>> regenerate(CredentialName name,
                                                                 java.lang.Class<T> credentialType)

Regenerate a credential in CredHub. Only credentials that were previously generated can be re-generated.

Type Parameters:

T - the credential implementation type

Parameters:

name - the name of the credential; must not be null

credentialType - the type of the credential to be regenerated; must not be null

Returns:

the details of the regenerated credential

getById

<T> reactor.core.publisher.Mono<CredentialDetails<T>> getById(java.lang.String id,
                                                              java.lang.Class<T> credentialType)

Retrieve a credential using its ID, as returned in a write request.

Type Parameters:

T - the credential implementation type

Parameters:

id - the ID of the credential; must not be null

credentialType - the type of the credential to be retrieved; must not be null

Returns:

the details of the retrieved credential

getByName

<T> reactor.core.publisher.Mono<CredentialDetails<T>> getByName(CredentialName name,
                                                                java.lang.Class<T> credentialType)

Retrieve a credential using its name, as passed to a write request. Only the current credential value will be returned.

Type Parameters:

T - the credential implementation type

Parameters:

name - the name of the credential; must not be null

credentialType - the type of credential expected to be returned

Returns:

the details of the retrieved credential

getByNameWithHistory

<T> reactor.core.publisher.Flux<CredentialDetails<T>> getByNameWithHistory(CredentialName name,
                                                                           java.lang.Class<T> credentialType)

Retrieve a credential using its name, as passed to a write request. A collection of all stored values for the named credential will be returned, including historical values.

Type Parameters:

T - the credential implementation type

Parameters:

name - the name of the credential; must not be null

credentialType - the type of credential expected to be returned

Returns:

the details of the retrieved credential, including history

getByNameWithHistory

<T> reactor.core.publisher.Flux<CredentialDetails<T>> getByNameWithHistory(CredentialName name,
                                                                           int versions,
                                                                           java.lang.Class<T> credentialType)

Retrieve a credential using its name, as passed to a write request. A collection of stored values for the named credential will be returned, with the specified number of historical values.

Type Parameters:

T - the credential implementation type

Parameters:

name - the name of the credential; must not be null

versions - the number of historical versions to retrieve

credentialType - the type of credential expected to be returned

Returns:

the details of the retrieved credential, including history

findByName

reactor.core.publisher.Flux<CredentialSummary> findByName(CredentialName name)

Find a credential using a full or partial name.

Parameters:

name - the name of the credential; must not be null

Returns:

a summary of the credential search results

findByPath

reactor.core.publisher.Flux<CredentialSummary> findByPath(java.lang.String path)

Find a credential using a path.

Parameters:

path - the path to the credential; must not be null

Returns:

a summary of the credential search results

deleteByName

reactor.core.publisher.Mono<java.lang.Void> deleteByName(CredentialName name)

Delete a credential by its full name.

Parameters:

name - the name of the credential; must not be null

Returns:

an empty Mono