Skip to content

masterpointio/terraform-datadog-users

Repository files navigation

Banner

terraform-datadog-users

Release

💡 Learn more about Masterpoint below.

Purpose and Functionality

This Terraform module is designed to create and manage Datadog user accounts.

The users are associated with one of the three out-of-the-box roles:

  • Datadog Admin
  • Datadog Standard
  • Datadog Read Only

Usage

module "datadog_users" {
  source  = "masterpointio/datadog/users"
  version = "X.X.X"

  users = [
    {
      roles    = ["standard"],
      email    = "[email protected]",
      name     = "Jane Smith",
      role     = "Editor",
      username = "janesmith"
    }
  ]
}

Check out examples/complete for the full example.

To ensure the secure handling of DataDog sensitive data for datadog/datadog provider, the module's example is designed to work with the SOPS (Secrets OPerationS) provider. SOPS is a tool for encrypting and decrypting files containing sensitive data, often used in conjunction with Terraform to manage secrets. The example also utilizes terraform-secrets-helper module - a helper that provides a standard way of managing secrets from different sources, incuding SOPS files.

❗ We recommend to use AWS KMS, GCP KMS, Azure Key Vault for SOPS files encryption. Don't use the secrets from the example in your real configuration!

Here are some basic SOPS operations that help you to work with the example:

  • Pass age key to SOPS provider configuration:
cd ./example/complete
export SOPS_AGE_KEY_FILE=key.txt
  • Encryption/decryption via SOPS editior
sops example.yaml

Requirements

Name Version
terraform >= 1.3
datadog >= 3.14

Providers

Name Version
datadog >= 3.14

Modules

No modules.

Resources

Name Type
datadog_user.users resource
datadog_role.admin data source
datadog_role.read_only data source
datadog_role.standard data source

Inputs

Name Description Type Default Required
users n/a
list(object({
disabled = optional(bool, false)
email = string
name = string
roles = set(string)
send_user_invitation = optional(bool, true)
username = string
}))
n/a yes

Outputs

Name Description
datadog_users A map of all Datadog user resources keyed by username.

Built By

Powered by the Masterpoint team and driven forward by contributions from the community ❤️

Contributors

Contribution Guidelines

Contributions are welcome and appreciated!

Found an issue or want to request a feature? Open an issue

Want to fix a bug you found or add some functionality? Fork, clone, commit, push, and PR — we'll check it out.

Who We Are 𐦂𖨆𐀪𖠋

Established in 2016, Masterpoint is a team of experienced software and platform engineers specializing in Infrastructure as Code (IaC). We provide expert guidance to organizations of all sizes, helping them leverage the latest IaC practices to accelerate their engineering teams.

Our Mission

Our mission is to simplify cloud infrastructure so developers can innovate faster, safer, and with greater confidence. By open-sourcing tools and modules that we use internally, we aim to contribute back to the community, promoting consistency, quality, and security.

Our Commitments

  • 🌟 Open Source: We live and breathe open source, contributing to and maintaining hundreds of projects across multiple organizations.
  • 🌎 1% for the Planet: Demonstrating our commitment to environmental sustainability, we are proud members of 1% for the Planet, pledging to donate 1% of our annual sales to environmental nonprofits.
  • 🇺🇦 1% Towards Ukraine: With team members and friends affected by the ongoing Russo-Ukrainian war, we donate 1% of our annual revenue to invasion relief efforts, supporting organizations providing aid to those in need. Here's how you can help Ukraine with just a few clicks.

Connect With Us

We're active members of the community and are always publishing content, giving talks, and sharing our hard earned expertise. Here are a few ways you can see what we're up to:

LinkedIn Newsletter Blog YouTube

... and be sure to connect with our founder, Matt Gowie.

License

Apache License, Version 2.0.

Open Source Initiative

Copyright © 2016-2025 Masterpoint Consulting LLC

About

Terraform module to configure and provision Datadog users

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages