Socket
Book a DemoInstallSign in
Socket

@renovosolutions/cdk-aspects-library-tags

Package Overview
Dependencies
Maintainers
3
Versions
1
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@renovosolutions/cdk-aspects-library-tags

A library of CDK aspects for tagging AWS resources

0.0.0
latest
Source
npmnpm
Version published
Weekly downloads
2
Maintainers
3
Weekly downloads
 
Created
Source

CDK Aspects Library - Tags

A library of AWS CDK Aspects for applying consistent tagging to AWS resources.

Features

This library provides two main aspects for tagging AWS resources:

ApplyTags

An aspect that applies a set of custom tags to all taggable resources in the given scope. This is useful for:

  • Cost allocation and tracking
  • Resource management and organization
  • Compliance and governance requirements
  • Environment identification

ApplyKmsTags

An aspect that applies CloudFormation-specific tags to KMS keys, including:

  • cfn:stack-name - The name of the CloudFormation stack
  • cfn:logical-id - The logical ID of the KMS key resource

This is particularly useful because KMS keys are not automatically tagged by CloudFormation, making them difficult to track and manage in large deployments.

It's not possible to use the same tags that CloudFormation applies to other resources, because those names are reserved for CloudFormation's internal use. As a best approximation, it uses the similar tag names listed above.

Examples

TypeScript

import { Aspects, App, Stack } from 'aws-cdk-lib';
import { aws_s3 as s3, aws_kms as kms } from 'aws-cdk-lib';
import { ApplyTags, ApplyKmsTags } from '@renovosolutions/cdk-aspects-library-tags';

const app = new App();
const stack = new Stack(app, 'MyStack');

// Create some resources
new s3.Bucket(stack, 'MyBucket');
new kms.Key(stack, 'MyKey');

// Apply custom tags to all taggable resources
const tags = {
  'Environment': 'Production',
  'Project': 'MyProject',
  'Owner': 'TeamName'
};
Aspects.of(stack).add(new ApplyTags(tags));

// Apply CloudFormation tags specifically to KMS keys
Aspects.of(stack).add(new ApplyKmsTags());

Python

from aws_cdk import (
  Aspects,
  App,
  Stack,
  aws_s3 as s3,
  aws_kms as kms,
)
from renovosolutions_aspects_tags import (
  ApplyTags,
  ApplyKmsTags,
)

app = App()
stack = Stack(app, "MyStack")

# Create some resources
s3.Bucket(stack, "MyBucket")
kms.Key(stack, "MyKey")

# Apply custom tags to all taggable resources
tags = {
    "Environment": "Production",
    "Project": "MyProject",
    "Owner": "TeamName"
}
Aspects.of(stack).add(ApplyTags(tags))

# Apply CloudFormation tags specifically to KMS keys
Aspects.of(stack).add(ApplyKmsTags())

C Sharp

using Amazon.CDK;
using Amazon.CDK.AWS.S3;
using Amazon.CDK.AWS.KMS;
using System.Collections.Generic;
using renovosolutions;

var app = new App();
var stack = new Stack(app, "MyStack");

// Create some resources
new Bucket(stack, "MyBucket");
new Key(stack, "MyKey");

// Apply custom tags to all taggable resources
var tags = new Dictionary<string, string>
{
    ["Environment"] = "Production",
    ["Project"] = "MyProject",
    ["Owner"] = "TeamName"
};
Aspects.Of(stack).Add(new ApplyTags(tags));

// Apply CloudFormation tags specifically to KMS keys
Aspects.Of(stack).Add(new ApplyKmsTags());

Scope of Application

The aspects in this library work at different scopes:

  • ApplyTags: Applies to all resources that implement the ITaggable interface (most AWS resources)
  • ApplyKmsTags: Applies specifically to AWS::KMS::Key resources

You can apply these aspects at any level in your CDK hierarchy:

  • App level: Tags all resources across all stacks
  • Stack level: Tags all resources within a specific stack
  • Construct level: Tags resources within a specific construct

API Reference

For detailed API documentation, see API.md.

Contributing

Contributions are welcome! Please see our contributing guidelines for more details.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Keywords

aspects

FAQs

Package last updated on 01 Aug 2025

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

About

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.

  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc

U.S. Patent No. 12,346,443 & 12,314,394. Other pending.