@mtndev/cli 1.1.0 → 2.0.1

package/esm/commands/aws/iam/break-glass/schema.js

@@ -0,0 +1,19 @@
+import { profileField, verboseField } from "../../schema.js";
+import { ADMIN_GROUP_NAME } from "../admin-group.js";
+import { z } from "zod";
+//#region src/commands/aws/iam/break-glass/schema.js
+/**
+* Zod schema for `aws iam break-glass` options.
+*/
+const breakGlassOptionsSchema = z.object({
+	profile: profileField,
+	user: z.array(z.string()).optional().default([]).describe("Grant break-glass to this user (repeatable). Default: your own IAM user"),
+	yes: z.boolean().optional().default(false).describe("Skip the confirmation prompt"),
+	dryRun: z.boolean().optional().default(false).describe("Preview the grant without changing anything"),
+	verbose: verboseField
+});
+/**
+* @typedef {z.infer<typeof breakGlassOptionsSchema>} BreakGlassOptions
+*/
+//#endregion
+export { ADMIN_GROUP_NAME, breakGlassOptionsSchema };

package/esm/commands/aws/iam/check-admin/handler.d.ts

@@ -0,0 +1,5 @@
+/**
+ * `aws iam check-admin` handler: alert if anyone is a member of acl-admin-do-not-use.
+ * @param {unknown} options
+ */
+export function checkAdminCommand(options: unknown): Promise<void>;

package/esm/commands/aws/iam/check-admin/handler.js

@@ -0,0 +1,86 @@
+import { requireCommands } from "../../utils/exec-aws.js";
+import { ADMIN_GROUP_NAME, resolveAdminScanProfiles, resolveProfileScan } from "../admin-group.js";
+import { checkAdminOptionsSchema } from "./schema.js";
+import chalk from "chalk";
+import { ZodError } from "zod";
+//#region src/commands/aws/iam/check-admin/handler.js
+/**
+* `aws iam check-admin` handler: alert if anyone is a member of acl-admin-do-not-use.
+* @param {unknown} options
+*/
+async function checkAdminCommand(options) {
+	try {
+		const { profile, all, verbose } = checkAdminOptionsSchema.parse(options);
+		requireCommands(["aws"]);
+		if (all || !(profile ?? process.env.AWS_PROFILE)) requireCommands(["aws-vault"]);
+		/** @type {string[]} */
+		let profiles;
+		try {
+			profiles = resolveAdminScanProfiles({
+				profile,
+				all
+			});
+		} catch (resolveError) {
+			if (resolveError instanceof Error && resolveError.message === "No aws-vault profiles with credentials found.") {
+				console.error(chalk.red(resolveError.message));
+				process.exit(1);
+			}
+			throw resolveError;
+		}
+		console.log(chalk.blue(`\n==> Checking ${profiles.length} profile(s) for ${ADMIN_GROUP_NAME}\n`));
+		let ok = 0;
+		let alert = 0;
+		let skip = 0;
+		for (const candidate of profiles) {
+			const scan = resolveProfileScan({
+				profile: candidate,
+				verbose
+			});
+			if (!scan) {
+				skip += 1;
+				continue;
+			}
+			if (scan.users.length === 0) {
+				console.log(chalk.green(`OK     ${candidate} (${scan.accountId}) — ${ADMIN_GROUP_NAME}: 0 users`));
+				ok += 1;
+			} else {
+				console.log(chalk.red(`ALERT  ${candidate} (${scan.accountId}) — ${ADMIN_GROUP_NAME}: ${scan.users.length} user(s): ${scan.users.join(", ")}`));
+				alert += 1;
+			}
+		}
+		console.log(chalk.blue("\n==> Summary"));
+		console.log(`  Profiles scanned:  ${profiles.length}`);
+		console.log(`  OK (empty group):  ${ok}`);
+		console.log(`  ALERT (has users): ${alert}`);
+		console.log(`  Skipped (silent):  ${skip}`);
+		if (alert > 0) {
+			console.log(chalk.red(`\nRemove users from ${ADMIN_GROUP_NAME} when break-glass access is no longer needed.`));
+			process.exit(1);
+		}
+		if (ok === 0) {
+			console.log(chalk.yellow(`\nNo profiles returned IAM access for ${ADMIN_GROUP_NAME}.`));
+			console.log(chalk.yellow("  Use a profile with iam:GetGroup (e.g. md-*-iam-admin) or run with --verbose."));
+		}
+	} catch (error) {
+		if (error instanceof ZodError) {
+			console.error(chalk.red("\n❌ Invalid command options:"));
+			error.errors.forEach((err) => {
+				console.error(chalk.red(`   ${err.path.join(".")}: ${err.message}`));
+			});
+			process.exit(1);
+		}
+		const verbose = options?.verbose || false;
+		console.error(chalk.red("\n❌ check-admin failed:"));
+		if (error instanceof Error) {
+			console.error(chalk.red(`   ${error.message}`));
+			if (verbose && error.stack) {
+				console.error(chalk.gray("\nStack trace:"));
+				console.error(chalk.gray(error.stack));
+			}
+		} else console.error(chalk.red(`   ${String(error)}`));
+		console.error(chalk.yellow("\n💡 Requires the AWS CLI, and aws-vault when scanning multiple profiles.\n"));
+		process.exit(1);
+	}
+}
+//#endregion
+export { checkAdminCommand };

package/esm/commands/aws/iam/check-admin/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./handler.js";
+export * from "./schema.js";

package/esm/commands/aws/iam/check-admin/index.js

@@ -0,0 +1,4 @@
+import { ADMIN_GROUP_NAME } from "../admin-group.js";
+import { checkAdminOptionsSchema } from "./schema.js";
+import { checkAdminCommand } from "./handler.js";
+export { ADMIN_GROUP_NAME, checkAdminCommand, checkAdminOptionsSchema };

package/esm/commands/aws/iam/check-admin/schema.d.ts

@@ -0,0 +1,19 @@
+export { ADMIN_GROUP_NAME } from "../admin-group.js";
+/**
+ * Zod schema for `aws iam check-admin` options.
+ */
+export const checkAdminOptionsSchema: z.ZodObject<{
+    profile: z.ZodOptional<z.ZodString>;
+    all: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    verbose: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    verbose: boolean;
+    all: boolean;
+    profile?: string | undefined;
+}, {
+    profile?: string | undefined;
+    verbose?: boolean | undefined;
+    all?: boolean | undefined;
+}>;
+export type CheckAdminOptions = z.infer<typeof checkAdminOptionsSchema>;
+import { z } from "zod";

package/esm/commands/aws/iam/check-admin/schema.js

@@ -0,0 +1,17 @@
+import { profileField, verboseField } from "../../schema.js";
+import { ADMIN_GROUP_NAME } from "../admin-group.js";
+import { z } from "zod";
+//#region src/commands/aws/iam/check-admin/schema.js
+/**
+* Zod schema for `aws iam check-admin` options.
+*/
+const checkAdminOptionsSchema = z.object({
+	profile: profileField,
+	all: z.boolean().optional().default(false).describe("Scan every aws-vault profile (default only when --profile and AWS_PROFILE are unset)"),
+	verbose: verboseField
+});
+/**
+* @typedef {z.infer<typeof checkAdminOptionsSchema>} CheckAdminOptions
+*/
+//#endregion
+export { ADMIN_GROUP_NAME, checkAdminOptionsSchema };

package/esm/commands/aws/iam/policies/s3-restrictions-deny-non-s3-services.json

@@ -0,0 +1,20 @@
+{
+  "Version": "2012-10-17",
+  "Statement": [
+    {
+      "Sid": "DenyNonS3Services",
+      "Effect": "Deny",
+      "NotAction": [
+        "s3:*",
+        "logs:*",
+        "sts:AssumeRole",
+        "iam:PassRole",
+        "kms:Decrypt",
+        "kms:GenerateDataKey",
+        "kms:DescribeKey",
+        "lambda:InvokeFunction"
+      ],
+      "Resource": "*"
+    }
+  ]
+}

package/esm/commands/aws/iam/policies/sts-federation.json

@@ -0,0 +1,11 @@
+{
+  "Version": "2012-10-17",
+  "Statement": [
+    {
+      "Sid": "StsFederation",
+      "Effect": "Allow",
+      "Action": ["sts:GetFederationToken", "sts:GetCallerIdentity"],
+      "Resource": "*"
+    }
+  ]
+}

package/esm/commands/aws/iam/policies/user-admins-deny-list.json

@@ -0,0 +1,175 @@
+{
+  "Version": "2012-10-17",
+  "Statement": [
+    {
+      "Sid": "DenyAIServices",
+      "Effect": "Deny",
+      "Action": [
+        "bedrock:*",
+        "sagemaker:*",
+        "comprehend:*",
+        "comprehendmedical:*",
+        "rekognition:*",
+        "textract:*",
+        "personalize:*",
+        "forecast:*",
+        "lex:*",
+        "polly:*",
+        "translate:*",
+        "transcribe:*",
+        "kendra:*",
+        "q:*"
+      ],
+      "Resource": "*"
+    },
+    {
+      "Sid": "DenyOrgAndAccountWrites",
+      "Effect": "Deny",
+      "Action": [
+        "organizations:*",
+        "account:CloseAccount",
+        "account:DeleteAlternateContact",
+        "account:PutAlternateContact",
+        "account:PutChallengeQuestions",
+        "account:EnableRegion",
+        "account:DisableRegion",
+        "account:PutAccountName"
+      ],
+      "Resource": "*"
+    },
+    {
+      "Sid": "DenyBillingMutations",
+      "Effect": "Deny",
+      "Action": [
+        "aws-portal:Modify*",
+        "billing:Update*",
+        "billing:Put*",
+        "billing:Delete*",
+        "budgets:Modify*",
+        "budgets:Create*",
+        "budgets:Delete*",
+        "savingsplans:Create*",
+        "savingsplans:Delete*",
+        "supportplans:Create*",
+        "supportplans:Delete*",
+        "purchase-orders:Modify*",
+        "purchase-orders:Create*",
+        "cur:Put*",
+        "cur:Delete*"
+      ],
+      "Resource": "*"
+    },
+    {
+      "Sid": "DenyCloudTrailTampering",
+      "Effect": "Deny",
+      "Action": [
+        "cloudtrail:StopLogging",
+        "cloudtrail:DeleteTrail",
+        "cloudtrail:UpdateTrail",
+        "cloudtrail:PutEventSelectors",
+        "cloudtrail:DeleteEventDataStore"
+      ],
+      "Resource": "*"
+    },
+    {
+      "Sid": "DenyExpensiveServices",
+      "Effect": "Deny",
+      "Action": [
+        "airflow:CreateEnvironment",
+        "airflow:UpdateEnvironment",
+        "mwaa:*",
+        "transfer:CreateServer",
+        "transfer:UpdateServer",
+        "transfer:StartServer",
+        "shield:CreateSubscription",
+        "shield:CreateProtection",
+        "shield:CreateProtectionGroup"
+      ],
+      "Resource": "*"
+    },
+    {
+      "Sid": "DenyKMSDestruction",
+      "Effect": "Deny",
+      "Action": [
+        "kms:ScheduleKeyDeletion",
+        "kms:DisableKey",
+        "kms:DisableKeyRotation"
+      ],
+      "Resource": "*"
+    },
+    {
+      "Sid": "DenyNeptuneViaRds",
+      "Effect": "Deny",
+      "Action": [
+        "rds:CreateDBCluster",
+        "rds:CreateDBInstance",
+        "rds:ModifyDBCluster",
+        "rds:ModifyDBInstance",
+        "rds:RestoreDBClusterFromSnapshot",
+        "rds:RestoreDBInstanceFromDBSnapshot"
+      ],
+      "Resource": "*",
+      "Condition": {
+        "StringEquals": {
+          "rds:DatabaseEngine": "neptune"
+        }
+      }
+    },
+    {
+      "Sid": "DenyExpensiveGpuEc2",
+      "Effect": "Deny",
+      "Action": [
+        "ec2:RunInstances",
+        "ec2:RequestSpotInstances",
+        "ec2:RequestSpotFleet",
+        "ec2:ModifyInstanceAttribute"
+      ],
+      "Resource": "*",
+      "Condition": {
+        "StringLike": {
+          "ec2:InstanceType": [
+            "p2.*",
+            "p3.*",
+            "p4d.*",
+            "p4de.*",
+            "p5.*",
+            "p5d.*",
+            "p5e.*",
+            "p5en.*",
+            "p6*",
+            "g3.*",
+            "g3s.*",
+            "g4dn.*",
+            "g4ad.*",
+            "g5.*",
+            "g5g.*",
+            "g6.*",
+            "g6e.*",
+            "g6f.*",
+            "inf1.*",
+            "inf2.*",
+            "trn1.*",
+            "trn1n.*",
+            "trn2.*",
+            "trn2a.*",
+            "trn2i.*",
+            "dl1.*",
+            "dl2q.*",
+            "f1.*",
+            "f2.*",
+            "vt1.*",
+            "hpc6id.*",
+            "u-12tb1.metal",
+            "u-18tb1.metal",
+            "u-24tb1.metal",
+            "u-6tb1.56xlarge",
+            "u-9tb1.112xlarge",
+            "x2iedn.*",
+            "x2idn.*",
+            "x2iezn.*"
+          ]
+        }
+      }
+    }
+  ]
+}

package/esm/commands/aws/iam/policies/user-admins-deny-regions-list.json

@@ -0,0 +1,41 @@
+{
+  "Version": "2012-10-17",
+  "Statement": [
+    {
+      "Sid": "DenyNonApprovedRegions",
+      "Effect": "Deny",
+      "NotAction": [
+        "iam:*",
+        "organizations:*",
+        "route53:*",
+        "route53domains:*",
+        "cloudfront:*",
+        "waf:*",
+        "wafv2:*",
+        "shield:*",
+        "globalaccelerator:*",
+        "sts:*",
+        "support:*",
+        "supportplans:*",
+        "trustedadvisor:*",
+        "health:*",
+        "budgets:*",
+        "ce:*",
+        "cur:*",
+        "account:*",
+        "billing:*",
+        "aws-portal:*",
+        "tag:*",
+        "resource-groups:*",
+        "ram:*",
+        "cloudshell:*"
+      ],
+      "Resource": "*",
+      "Condition": {
+        "StringNotEquals": {
+          "aws:RequestedRegion": ["us-east-1", "us-east-2", "us-west-2"]
+        }
+      }
+    }
+  ]
+}

package/esm/commands/aws/iam/policies/user-admins-self-service-iam.json

@@ -0,0 +1,56 @@
+{
+  "Version": "2012-10-17",
+  "Statement": [
+    {
+      "Sid": "ViewAccountInfo",
+      "Effect": "Allow",
+      "Action": ["iam:GetAccountPasswordPolicy", "iam:ListVirtualMFADevices"],
+      "Resource": "*"
+    },
+    {
+      "Sid": "ManageOwnPassword",
+      "Effect": "Allow",
+      "Action": ["iam:ChangePassword", "iam:GetUser"],
+      "Resource": "arn:aws:iam::*:user/${aws:username}"
+    },
+    {
+      "Sid": "ManageOwnAccessKeys",
+      "Effect": "Allow",
+      "Action": [
+        "iam:CreateAccessKey",
+        "iam:DeleteAccessKey",
+        "iam:ListAccessKeys",
+        "iam:UpdateAccessKey",
+        "iam:GetAccessKeyLastUsed"
+      ],
+      "Resource": "arn:aws:iam::*:user/${aws:username}"
+    },
+    {
+      "Sid": "ManageOwnMFA",
+      "Effect": "Allow",
+      "Action": [
+        "iam:CreateVirtualMFADevice",
+        "iam:DeleteVirtualMFADevice",
+        "iam:EnableMFADevice",
+        "iam:ListMFADevices",
+        "iam:ResyncMFADevice",
+        "iam:DeactivateMFADevice"
+      ],
+      "Resource": [
+        "arn:aws:iam::*:mfa/${aws:username}",
+        "arn:aws:iam::*:user/${aws:username}"
+      ]
+    },
+    {
+      "Sid": "ValidateIAMPolicies",
+      "Effect": "Allow",
+      "Action": [
+        "access-analyzer:ValidatePolicy",
+        "access-analyzer:CheckAccessNotGranted",
+        "access-analyzer:CheckNoNewAccess",
+        "access-analyzer:CheckNoPublicAccess"
+      ],
+      "Resource": "*"
+    }
+  ]
+}

package/esm/commands/aws/iam/policies/user-admins-write-list.json

@@ -0,0 +1,117 @@
+{
+  "Version": "2012-10-17",
+  "Statement": [
+    {
+      "Sid": "WriteComputeAndNetwork",
+      "Effect": "Allow",
+      "Action": [
+        "ec2:*",
+        "elasticloadbalancing:*",
+        "autoscaling:*",
+        "application-autoscaling:*",
+        "lambda:*",
+        "ecs:*",
+        "ecr:*",
+        "elasticfilesystem:*",
+        "route53:*",
+        "route53domains:*",
+        "cloudfront:*",
+        "apigateway:*",
+        "servicediscovery:*"
+      ],
+      "Resource": "*"
+    },
+    {
+      "Sid": "WriteDataAndStorage",
+      "Effect": "Allow",
+      "Action": ["s3:*", "rds:*", "pi:*", "dynamodb:*", "backup:*"],
+      "Resource": "*"
+    },
+    {
+      "Sid": "WriteDeploymentAndOps",
+      "Effect": "Allow",
+      "Action": [
+        "cloudformation:*",
+        "cloudwatch:*",
+        "logs:*",
+        "events:*",
+        "scheduler:*",
+        "ssm:*",
+        "cloudtrail:*",
+        "xray:*",
+        "states:*",
+        "cloudshell:*"
+      ],
+      "Resource": "*"
+    },
+    {
+      "Sid": "WriteSecurityAndMessaging",
+      "Effect": "Allow",
+      "Action": [
+        "acm:*",
+        "secretsmanager:*",
+        "kms:*",
+        "sns:*",
+        "sqs:*",
+        "ses:*"
+      ],
+      "Resource": "*"
+    },
+    {
+      "Sid": "WriteResourceOrganization",
+      "Effect": "Allow",
+      "Action": ["resource-groups:*", "tag:*", "ram:*"],
+      "Resource": "*"
+    },
+    {
+      "Sid": "SupportAndHealth",
+      "Effect": "Allow",
+      "Action": [
+        "support:*",
+        "supportplans:Get*",
+        "supportplans:List*",
+        "health:*",
+        "trustedadvisor:*"
+      ],
+      "Resource": "*"
+    },
+    {
+      "Sid": "Sts",
+      "Effect": "Allow",
+      "Action": [
+        "sts:GetCallerIdentity",
+        "sts:GetFederationToken",
+        "sts:GetSessionToken"
+      ],
+      "Resource": "*"
+    },
+    {
+      "Sid": "IamPassRoleForServices",
+      "Effect": "Allow",
+      "Action": "iam:PassRole",
+      "Resource": "arn:aws:iam::*:role/*",
+      "Condition": {
+        "StringEquals": {
+          "iam:PassedToService": [
+            "ec2.amazonaws.com",
+            "lambda.amazonaws.com",
+            "ecs.amazonaws.com",
+            "ecs-tasks.amazonaws.com",
+            "elasticloadbalancing.amazonaws.com",
+            "events.amazonaws.com",
+            "apigateway.amazonaws.com",
+            "rds.amazonaws.com",
+            "backup.amazonaws.com",
+            "cloudformation.amazonaws.com"
+          ]
+        }
+      }
+    },
+    {
+      "Sid": "ServiceLinkedRoles",
+      "Effect": "Allow",
+      "Action": ["iam:CreateServiceLinkedRole", "iam:DeleteServiceLinkedRole"],
+      "Resource": "*"
+    }
+  ]
+}

package/esm/commands/aws/iam/remove-admin/handler.d.ts

@@ -0,0 +1,6 @@
+/**
+ * `aws iam remove-admin` handler: remove users from the break-glass
+ * acl-admin-do-not-use group, either for one profile or every aws-vault profile.
+ * @param {unknown} options
+ */
+export function removeAdminCommand(options: unknown): Promise<void>;