AWS Secrets Manager

Move secrets to and from a Secrets Manager name prefix.

The connection

What	This provider
Vendor	Amazon Web Services
Key	`aws-secrets`
Availability	`available`. You can connect it today.
Credential penv holds	`aws-iam`
Values read back	yes
Activation	`immediate`

Direction	What it does
`import`	Reads names and values out of the store into penv.
`export`	Writes names and values from penv into the store.

immediate. The running app sees a new value at once.

Direction	Policies you can pick
`import`	`skip_existing`, `new_version`, `fail`
`export`	`create_only`, `overwrite`, `overwrite_and_prune`

How syncs work says what each one does.

You paste a credential you already hold. penv seals it and never shows it again.

Field	Label	Kind	Required	What it is
`accessKeyId`	Access key ID	text	yes
`secretAccessKey`	Secret access key	secret, masked here and sealed	yes

Fixed when you connect, and shared by every mapping on it.

Field	Label	Kind	Required	Advanced	What it is
`region`	Region	text	yes	no	The region this connection reaches. One connection covers one region.
`accountId`	Account ID	text	no	yes	If supplied, the generated policy names the account instead of a wildcard.
`basePrefix`	Base prefix	text	yes	no	The widest secret name prefix this connection may touch. Every sync scope will sit under it.

Answered once per environment you map.

Field	Label	Kind	Required	Advanced	What it is
`namePrefix`	Secret name prefix	text	yes	no	Maps onto this environment. One key becomes one secret beneath it.

penv probes for these when it verifies the connection.

Permission	Directions	Blocking	Without it
`sts:GetCallerIdentity`	every direction	yes	We cannot confirm which IAM identity this credential is.
`secretsmanager:ListSecrets`	every direction	yes	Preview cannot list what is under this prefix.
`secretsmanager:GetSecretValue`	`import`	yes	Import cannot read any value.
`secretsmanager:CreateSecret`	`export`	yes	Export cannot add a key that is not there yet.
`secretsmanager:PutSecretValue`	`export`	yes	Export cannot update a key that already exists.
`secretsmanager:DeleteSecret`	`export`	no	The overwrite_and_prune policy cannot remove remote keys.
`secretsmanager:RestoreSecret`	`export`	no	A key pruned in the last 30 days cannot be written again.
`kms:Decrypt`	`import`	no	Secrets under a customer-managed KMS key will not import.
`kms:GenerateDataKey`	`export`	no	Export cannot write under a customer-managed KMS key.