AWS SSM Parameter Store

Move parameters to and from an SSM path, signed in with an access key.

A newer connection reaches the same service: AWS SSM Parameter Store (IAM role).

Connection

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

Direction	What it does
`import`	We read names and values out of the store into your environment.
`export`	We write names and values from your environment 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.

Paste a credential from the vendor. We seal it and never show it again.

Field	Label	Kind	Required	What it is
`accessKeyId`	Access key ID	text	yes
`secretAccessKey`	Secret access key	secret; we mask it here and seal it	yes

You set these when you connect. Every mapping on the connection shares them.

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.
`basePath`	Base path	text	yes	no	The widest SSM path this connection may touch. Every sync scope will sit under it.

You answer these once per environment you map.

Field	Label	Kind	Required	Advanced	What it is
`path`	SSM path	text	yes	no	Maps onto this environment. Will sit under the connection's base path.
`recursive`	Include nested paths	yes or no	yes	yes	Nested SSM paths become the parameter's path prefix with us. Starts at `true`.

We probe for these when we verify the connection.

Permission	Directions	Blocking	Without it
`sts:GetCallerIdentity`	every direction	yes	We cannot confirm which IAM identity this credential is.
`ssm:GetParametersByPath`	every direction	yes	Preview cannot list what is under this path.
`kms:Decrypt`	`import`	no	SecureString parameters will import empty
`ssm:PutParameter`	`export`	yes	Export cannot write anything.
`kms:Encrypt`	`export`	yes	Export cannot write SecureString parameters.
`ssm:DeleteParameter`	`export`	no	The overwrite_and_prune policy cannot remove remote keys.