Secrets Manager

AWS SecretsManager is the main storage for application secrets.

Steps

flowchart LR
  A[1. Create a new secret]
  B[2. Update value of secret];
  C[3. Use secret]
  A --> B --> C

Step 1: Create a new secret

Edit the secrets-property of the SecretsManager module.

In this example, a new secret named MY_NEW_SECRET is added:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

module "secretsmanager" {
  source = "git@github.com:BYM-IKT/terraform-aws-secretsmanager-secrets.git"
  account_id       = var.account_id
  environment      = var.environment
  region           = var.region
  application_name = var.application_name
  secrets = [
    ...
    "MY_NEW_SECRET",
  ]
}

Create a Pull Request to Terraform apply this change.

Step 2: Update value of secret

1. Log in to the AWS Account's console: https://bymoslo.awsapps.com/start
2. Navigate to AWS Secrets Manager.
3. Navigate to the secret you just created (for example, in this example MY_NEW_SECRET).
4. Click Retrieve secret value.
5. Click Edit.
6. Update the value and press Save.

Step 3: Use secret value in application

ECS Fargate

To use this secret in an existing Fargate, add a new entry in secretsmanager_secrets that references to the secret ARN from the SecretsManager module from step 1.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

module "application" {
  source = "git@github.com:BYM-IKT/terraform-byks-module.git?ref=v12"
  ...
  ecs_services = {
    kattehotell-service = {
      ...
      secretsmanager_secrets = {
        ...
        MY_NEW_SECRET = module.secretsmanager.secrets_arn["MY_NEW_SECRET"]
      }
    }
  }
}

After this change has been applied, the secret value is available as an environment variable. In this example, the secret value is reachable under the environment variable MY_NEW_SECRET.

AWS Lambda Function

To use this secret in an existing Lambda Function, retrieve the secret value using the data source aws_secretsmanager_secret_version, and feed its output to environment_variables:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

data "aws_secretsmanager_secret_version" "this" {
  for_each  = module.secretsmanager.secrets_arn
  secret_id = each.value
}

module "application" {
  source = "git@github.com:BYM-IKT/terraform-byks-module.git?ref=v12"
  ...
  lambda_functions = {
    kattehotell-booking = {
      ...
      environment_variables = {
        ...
        MY_NEW_SECRET = data.aws_secretsmanager_secret_version.this["MY_NEW_SECRET"].secret_string
      }
    }
  }
}

After this change has been applied, the secret value is available as an environment variable. In this example, the secret value is reachable under the environment variable MY_NEW_SECRET.