Prerequisites
- An AWS account with AWS Secrets Manager enabled.
- Create an IAM service-account user with programmatic access (access key ID + secret access key) e.g.
paradime-ssm-access-service-account - An IAM role that Paradime will assume via
sts:AssumeRoleto fetch secrets. - The IAM role must have
secretsmanager:GetSecretValuepermission on the secrets you want to reference.
Step 1: Create an IAM role for Paradime
- Open the IAM Console and create a new role, call it
ParadimeSSMAccessRole. - Get the ARN of the IAM user you created that will have the programmatic access
- Select Custom trust policy, call it and add a trust relationship that allows your IAM user to assume the role:
- Attach an inline policy, call it
ParadimeSSMAccessPolicygranting access to the secrets Paradime needs:
Scope the
Resource field to only the secrets Paradime needs. Avoid using * in production.Step 2: Connect in Paradime
- In Paradime, go to Settings → Integrations (see connecting integrations).
- Find AWS Secrets Manager under the Secret Managers category and click Connect.
- Fill in the required fields:
- Click Test connection. Paradime will perform an
sts:AssumeRolecall to verify the credentials work end-to-end.
Step 3: Reference secrets
Once connected, you can use AWS Secrets Manager ARNs anywhere Paradime accepts environment variable values or connection profile fields.Reference format
Extracting a JSON key
If your secret value is a JSON object, append#key_name to extract a specific field:
password key inside the secret’s JSON payload.
Example: Bolt environment variable
In your Bolt schedule’s environment variables, set:
Paradime resolves the ARN to the live secret value at schedule run time. The plaintext value is never stored in Paradime.
Disconnecting
To remove the AWS Secrets Manager integration:- Navigate to Settings → Integrations.
- Click Disconnect on the AWS Secrets Manager card.