com.atlassian.bamboo.configuration.external

Interface CredentialsExportService

All Known Implementing Classes:

CredentialsExportServiceImpl

@ExperimentalApi
public interface CredentialsExportService

Since:

5.15

Method Summary

Modifier and Type	Method and Description
Iterable<Path>	exportAllCredentials() Export all shared credentials to default location in Bamboo home dir.
Iterable<Path>	exportCredentials(CredentialsData credentialsData) Export a shared credential to default location in Bamboo home dir.
CredentialsData	importCredentials(com.atlassian.bamboo.specs.api.model.credentials.SharedCredentialsProperties credentialProperties) Validates exported credential properties within Bamboo context (e.g.
com.atlassian.bamboo.specs.api.model.credentials.SharedCredentialsProperties	toEntityProperties(String yamlString) Converts data from a YAML document to credential export properties.

Method Detail

exportAllCredentials

@NotNull
Iterable<Path> exportAllCredentials()

Export all shared credentials to default location in Bamboo home dir. Credentials will have their configuration encrypted for confidential data security.

Returns:

paths to files updated by export process

exportCredentials

@NotNull
Iterable<Path> exportCredentials(@NotNull
                                          CredentialsData credentialsData)

Export a shared credential to default location in Bamboo home dir. The entity should be encrypted for data security.

Returns:

paths to files updated by export process

See Also:

EncryptedCredentialsAccessor

toEntityProperties

@NotNull
com.atlassian.bamboo.specs.api.model.credentials.SharedCredentialsProperties toEntityProperties(String yamlString)
                                                                                                  throws com.atlassian.bamboo.specs.api.exceptions.PropertiesValidationException,
                                                                                                         YamlValidationException

Converts data from a YAML document to credential export properties. This method performs validation of YAML types and of the properties without Bamboo context (e.g. no database integrity is verified).

Parameters:

yamlString -

Returns:

credential properties after contextless validation

Throws:

YamlValidationException - if the format of the YAML file is invalid

com.atlassian.bamboo.specs.api.exceptions.PropertiesValidationException - if the imported properties were not valid

importCredentials

@NotNull
CredentialsData importCredentials(@NotNull
                                           com.atlassian.bamboo.specs.api.model.credentials.SharedCredentialsProperties credentialProperties)
                                    throws com.atlassian.bamboo.specs.api.exceptions.PropertiesValidationException,
                                           YamlValidationException

Validates exported credential properties within Bamboo context (e.g. verifying database integrity), then imports the data into the database.

Parameters:

credentialProperties - credential properties to import

Returns:

saved credential entity

Throws:

YamlValidationException - if the format of the YAML file is invalid (plugins will parse their part here)

com.atlassian.bamboo.specs.api.exceptions.PropertiesValidationException - if data validation fails