AWS Systems Manager Agent (SSM) Terraform module

SSM Agent is Amazon software that can be installed and configured on an EC2 instance, an on-premises server, or a virtual machine (VM). SSM Agent makes it possible for Systems Manager to update, manage, and configure these resources.

This module creates an SSM document that stores preferences for session manager.

Session preferences let you specify a location to store log output for all sessions in your AWS account. You can also enable server-side encryption using a AWS KMS key for a specified stream to ensure your session records are transferred securely.

---

Usage

Requirements

• terraform version >= 0.12.0
• aws provider >= 1.36.0

Include this repository as a module in your existing terraform code:

  module "session-manager" {
    source = "git::ssh://git@github.com/osodevops/aws-terraform-module-ssm-session-manager.git"

    s3_bucket_name = "session-logs-bucket"
    s3_key_prefix = "session-logs"
    s3_encryption_enabled = true
    cloudwatch_log_group_name = "project-name/ssm/session-logs"
    cloudwatch_encryption_enabled = true
  }

Examples

The following arguments are supported:

• s3_bucket_name = The name of the bucket where to store session logs. (Optional setting)
• s3_key_prefix = Set to write output to a sub-folder, enter a sub-folder name. (Optional setting)
• s3_encryption_enabled = Specify if you want to encrypt bucket objects in S3 (Optional setting)
• cloudwatch_log_group_name = Sets the name of the log group where session logs will be uploaded to. (Optional setting)
• cloudwatch_encryption_enabled = Specify if you want to encrypt log data (Optional setting)

Related Projects

Check out these related projects.

• -

Customer Stories

Discover our customer stories and see what OSO can deliver for your business.

• Working with SSM Agent - AWS tutorial following best practice from OSO
• OpenVPN using SSM - Provides a production ready OpenVPN Server usng SSM provisioning

Need some help

File a GitHub issue, send us an email or tweet us.

The legals

Copyright © 2017-2021 OSO | See LICENCE for full details.

Who we are

We at OSO help teams to adopt emerging technologies and solutions to boost their competitiveness, operational excellence and introduce meaningful innovations that drive real business growth. Our developer-first culture, combined with our cross-industry experience and battle-tested delivery methods allow us to implement the most impactful solutions for your business.

Looking for support applying emerging technologies in your business? We’d love to hear from you, get in touch by email

Start adopting new technologies by checking out our other projects, follow us on twitter, join our team of leaders and challengers, or contact us to find the right technology to support your business.