AWS Secrets Manager

AWS Secrets Manager é um serviço de gerenciamento de segredos que ajuda a proteger o acesso às suas aplicações, serviços e recursos de TI. Ele permite rotacionar, gerenciar e recuperar credenciais de banco de dados, chaves de API e outros segredos ao longo do seu ciclo de vida.

Com o AWS Secrets Manager, você pode:

  • Armazenar segredos com segurança: Criptografe segredos em repouso usando chaves de criptografia AWS KMS
  • Recuperar segredos programaticamente: Acesse segredos das suas aplicações e workflows sem hardcoding de credenciais
  • Rotacionar segredos automaticamente: Configure a rotação automática para serviços suportados como RDS, Redshift e DocumentDB
  • Auditar o acesso: Rastreie o acesso e as alterações de segredos por meio da integração com o AWS CloudTrail
  • Controlar o acesso com IAM: Use políticas IAM refinadas para gerenciar quem pode acessar quais segredos
  • Replicar entre regiões: Replique automaticamente segredos para várias regiões AWS para recuperação de desastres

No Zoen, a integração com o AWS Secrets Manager permite que seus workflows recuperem com segurança credenciais e valores de configuração em tempo de execução, criem e gerenciem segredos como parte de pipelines de automação, e mantenham um repositório centralizado de segredos que seus agentes podem acessar. Isso é particularmente útil para workflows que precisam autenticar com serviços externos, rotacionar credenciais ou gerenciar configuração sensível entre ambientes — tudo sem expor segredos nas definições do seu workflow.

Usage Instructions

Integrate AWS Secrets Manager into the workflow. Can retrieve, create, update, list, delete, describe, tag, untag, restore, and rotate secrets.

Actions

secrets_manager_get_secret

Retrieve a secret value from AWS Secrets Manager

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
secretIdstringYesThe name or ARN of the secret to retrieve
versionIdstringNoThe unique identifier of the version to retrieve
versionStagestringNoThe staging label of the version to retrieve (e.g., AWSCURRENT, AWSPREVIOUS)

Output

ParameterTypeDescription
namestringName of the secret
secretValuestringThe decrypted secret value
arnstringARN of the secret
versionIdstringVersion ID of the secret
versionStagesarrayStaging labels attached to this version
createdDatestringDate the secret was created

secrets_manager_list_secrets

List secrets stored in AWS Secrets Manager

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
maxResultsnumberNoMaximum number of secrets to return (1-100, default 100)
nextTokenstringNoPagination token from a previous request

Output

ParameterTypeDescription
secretsjsonList of secrets with name, ARN, description, dates, rotation rules/window, and version-to-stage mappings
nextTokenstringPagination token for the next page of results
countnumberNumber of secrets returned

secrets_manager_create_secret

Create a new secret in AWS Secrets Manager

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
namestringYesName of the secret to create
secretValuestringYesThe secret value (plain text or JSON string)
descriptionstringNoDescription of the secret

Output

ParameterTypeDescription
messagestringOperation status message
namestringName of the created secret
arnstringARN of the created secret
versionIdstringVersion ID of the created secret

secrets_manager_update_secret

Update the value of an existing secret in AWS Secrets Manager

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
secretIdstringYesThe name or ARN of the secret to update
secretValuestringYesThe new secret value (plain text or JSON string)
descriptionstringNoUpdated description of the secret

Output

ParameterTypeDescription
messagestringOperation status message
namestringName of the updated secret
arnstringARN of the updated secret
versionIdstringVersion ID of the updated secret

secrets_manager_delete_secret

Delete a secret from AWS Secrets Manager

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
secretIdstringYesThe name or ARN of the secret to delete
recoveryWindowInDaysnumberNoNumber of days before permanent deletion (7-30, default 30)
forceDeletebooleanNoIf true, immediately delete without recovery window

Output

ParameterTypeDescription
messagestringOperation status message
namestringName of the deleted secret
arnstringARN of the deleted secret
deletionDatestringScheduled deletion date

secrets_manager_describe_secret

Retrieve full metadata for a secret in AWS Secrets Manager, including rotation configuration and replication status, without exposing the secret value

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
secretIdstringYesThe name or ARN of the secret to describe

Output

ParameterTypeDescription
namestringName of the secret
arnstringARN of the secret
descriptionstringDescription of the secret
kmsKeyIdstringKMS key ID used to encrypt the secret
rotationEnabledbooleanWhether automatic rotation is enabled
rotationLambdaARNstringARN of the Lambda function used for rotation
rotationRulesjsonRotation schedule configuration
lastRotatedDatestringDate the secret was last rotated
lastChangedDatestringDate the secret was last changed
lastAccessedDatestringDate the secret was last accessed
deletedDatestringScheduled deletion date
nextRotationDatestringDate the secret is next scheduled to rotate
tagsarrayTags attached to the secret
versionIdsToStagesjsonMap of version IDs to their staging labels
owningServicestringID of the AWS service that manages this secret, if any
createdDatestringDate the secret was created
primaryRegionstringThe primary region of the secret, if replicated
replicationStatusarrayReplication status for each region the secret is replicated to

secrets_manager_tag_resource

Attach tags to a secret in AWS Secrets Manager

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
secretIdstringYesThe name or ARN of the secret to tag
tagsjsonYesTags to attach, as an array of {key, value} pairs (max 50)

Output

ParameterTypeDescription
messagestringOperation status message
namestringName or ARN of the tagged secret

secrets_manager_untag_resource

Remove tags from a secret in AWS Secrets Manager

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
secretIdstringYesThe name or ARN of the secret to untag
tagKeysjsonYesTag keys to remove, as an array of strings (max 50)

Output

ParameterTypeDescription
messagestringOperation status message
namestringName or ARN of the untagged secret

secrets_manager_restore_secret

Cancel a scheduled deletion for a secret in AWS Secrets Manager, restoring access to it

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
secretIdstringYesThe name or ARN of the secret to restore

Output

ParameterTypeDescription
messagestringOperation status message
namestringName of the restored secret
arnstringARN of the restored secret

secrets_manager_rotate_secret

Start or reconfigure rotation for a secret in AWS Secrets Manager

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
secretIdstringYesThe name or ARN of the secret to rotate
clientRequestTokenstringNoIdempotency token for the new secret version (32-64 characters)
rotationLambdaARNstringNoARN of the Lambda function that performs rotation (omit for managed rotation)
automaticallyAfterDaysnumberNoNumber of days between rotations (1-1000). Mutually exclusive with schedule expression
durationstringNoLength of the rotation window in hours, e.g. "3h"
scheduleExpressionstringNoA cron() or rate() expression defining the rotation schedule
rotateImmediatelybooleanNoWhether to rotate immediately (default true) or wait for the next scheduled window

Output

ParameterTypeDescription
messagestringOperation status message
namestringName of the secret
arnstringARN of the secret
versionIdstringID of the new secret version created by rotation

On this page