com.atlassian.bamboo.credentials

Interface CredentialType

All Superinterfaces:

BambooPluginModule, InitablePluginModule<CredentialTypeModuleDescriptor>

All Known Implementing Classes:

AbstractCredentialType, SshCredentialType, UsernamePasswordCredentialType

public interface CredentialType
extends InitablePluginModule<CredentialTypeModuleDescriptor>

Handles shared credentials.

Since:

5.9

Method Summary

Modifier and Type	Method and Description
Map<String,String>	generateCredentialsConfigMap(ActionParametersMap params, CredentialsData previousCredentialsData) Convert the params from the ui into a config map to be stored in the database.
Map<String,String>	generateCredentialsConfigMap(Map<String,String> params) Convert the given map into a config map of the shared credential to be stored in the database.
Map<String,String>	getCredentialsConfigurationMap(CredentialsData credentialsData) Convert an existing CredentialsData to a map.
void	populateContextForCreate(Map<String,Object> context) Provide any required context to be used when rendering the freemarker template for creating credentials.
void	populateContextForEdit(Map<String,Object> context, CredentialsData previousCredentialsData) Provide any required context to be used when rendering the freemarker template for editing credentials.
void	validate(ActionParametersMap params, CredentialsData previousCredentialsData, ErrorCollection errorCollection) Validate configuration.

Methods inherited from interface com.atlassian.bamboo.plugin.InitablePluginModule

init

Method Detail

populateContextForCreate

void populateContextForCreate(@NotNull
                              Map<String,Object> context)

Provide any required context to be used when rendering the freemarker template for creating credentials. Allows you to add any default values for initial creation

Parameters:

context - map to put your context in.

populateContextForEdit

void populateContextForEdit(@NotNull
                            Map<String,Object> context,
                            @NotNull
                            CredentialsData previousCredentialsData)

Provide any required context to be used when rendering the freemarker template for editing credentials.

Parameters:

context - map to put your context in.

previousCredentialsData - existing credentials

validate

void validate(@NotNull
              ActionParametersMap params,
              @Nullable
              CredentialsData previousCredentialsData,
              @NotNull
              ErrorCollection errorCollection)

Validate configuration.

Parameters:

params - configuration to be validated

previousCredentialsData - the previous immutable CredentialsData before saving or null if credentials are being created.

errorCollection - error collection to be set on validation failure

generateCredentialsConfigMap

@NotNull
Map<String,String> generateCredentialsConfigMap(@NotNull
                                                         ActionParametersMap params,
                                                         @Nullable
                                                         CredentialsData previousCredentialsData)

Convert the params from the ui into a config map to be stored in the database. Can assume validation has occurred in the #validate method.

Sensitive parameters such as passwords do not have to be encrypted, as they will be secured before being stored in the database.

Parameters:

params - request parameters.

previousCredentialsData - the previous immutable CredentialsData before saving or null if credentials are being created.

Returns:

the configuration map to be stored in the database.

generateCredentialsConfigMap

@NotNull
Map<String,String> generateCredentialsConfigMap(@NotNull
                                                         Map<String,String> params)
                                                  throws WebValidationException

Convert the given map into a config map of the shared credential to be stored in the database.

Sensitive parameters such as passwords do not have to be encrypted, as they will be secured before being stored in the database.

Parameters:

params - original map to be converted

Returns:

the configuration map to be stored in the database.

Throws:

WebValidationException - if params contains invalid configuration

getCredentialsConfigurationMap

@NotNull
Map<String,String> getCredentialsConfigurationMap(@NotNull
                                                           CredentialsData credentialsData)

Convert an existing CredentialsData to a map. So that configuration of the credential can used by other component, e.g. the rest plugin. Each implementation of CredentialType should populate different data to the map and encrypt them if necessary.

Parameters:

credentialsData - an existing credential

Returns:

Map that stores the credential's configuration