UNPKG

@fntio/infra-client

Version:

Self-hosted AWS access portal: credential vending, target-account trust, and grant-driven private networking as CDK stacks and constructs.

117 lines (116 loc) • 5.32 kB
"use strict"; var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) { if (k2 === undefined) k2 = k; var desc = Object.getOwnPropertyDescriptor(m, k); if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) { desc = { enumerable: true, get: function() { return m[k]; } }; } Object.defineProperty(o, k2, desc); }) : (function(o, m, k, k2) { if (k2 === undefined) k2 = k; o[k2] = m[k]; })); var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) { Object.defineProperty(o, "default", { enumerable: true, value: v }); }) : function(o, v) { o["default"] = v; }); var __importStar = (this && this.__importStar) || (function () { var ownKeys = function(o) { ownKeys = Object.getOwnPropertyNames || function (o) { var ar = []; for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k; return ar; }; return ownKeys(o); }; return function (mod) { if (mod && mod.__esModule) return mod; var result = {}; if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]); __setModuleDefault(result, mod); return result; }; })(); Object.defineProperty(exports, "__esModule", { value: true }); exports.issuerHost = exports.InfraClientRoles = void 0; exports.createIssuerProvider = createIssuerProvider; exports.webIdentityPrincipal = webIdentityPrincipal; exports.webIdentityPrincipalFor = webIdentityPrincipalFor; const cdk = __importStar(require("aws-cdk-lib")); const iam = __importStar(require("aws-cdk-lib/aws-iam")); /** Prepackaged common roles. Each roleName is a frozen contract baked into * deployed trust policies — entries may be added, never renamed. */ exports.InfraClientRoles = { /** Account-wide read-only (AWS ReadOnlyAccess). */ READ_ONLY: { roleName: "InfraReadOnly", managedPolicies: [ iam.ManagedPolicy.fromAwsManagedPolicyName("ReadOnlyAccess"), ], description: "Read-only access, assumed via the credential-vending issuer.", }, /** Full access except IAM/account management (AWS PowerUserAccess). */ POWER_USER: { roleName: "InfraPowerUser", managedPolicies: [ iam.ManagedPolicy.fromAwsManagedPolicyName("PowerUserAccess"), ], description: "Power-user access (no IAM), assumed via the credential-vending issuer.", }, /** Full administrative access (AWS AdministratorAccess). */ FULL_ADMIN: { roleName: "InfraFullAdmin", managedPolicies: [ iam.ManagedPolicy.fromAwsManagedPolicyName("AdministratorAccess"), ], description: "Administrator access, assumed via the credential-vending issuer.", }, }; /** The issuer URL as IAM condition keys name it: host only, no scheme or trailing slash. */ const issuerHost = (issuerUrl) => issuerUrl.replace(/^https:\/\//, "").replace(/\/$/, ""); exports.issuerHost = issuerHost; /** The account's one OIDC provider for the hub's issuer. Reports the issuer * HOST as a literal — JSON policy condition keys cannot hold CFN tokens. */ function createIssuerProvider(scope, id, issuerUrl) { return new IssuerProvider(scope, id, issuerUrl); } class IssuerProvider extends iam.OpenIdConnectProvider { literalIssuer; constructor(scope, id, issuerUrl) { super(scope, id, { url: issuerUrl, clientIds: ["sts.amazonaws.com"], // == AUDIENCE in the minted token }); this.literalIssuer = (0, exports.issuerHost)(issuerUrl); } get openIdConnectProviderIssuer() { return this.literalIssuer; } } /** Pinned to audience + role-scoped sub — a token only assumes the role it * was minted for. The trusting role MUST use exactly this fixed roleName. */ function webIdentityPrincipal(provider, roleName) { const issuer = provider.openIdConnectProviderIssuer; if (cdk.Token.isUnresolved(issuer)) { throw new Error("webIdentityPrincipal: the provider's issuer is a CloudFormation " + "token, which cannot form IAM condition keys. Pass the provider " + "returned by createIssuerProvider(), or import one via " + "iam.OpenIdConnectProvider.fromOpenIdConnectProviderArn()."); } return webIdentityPrincipalFor(provider.openIdConnectProviderArn, issuer, roleName, cdk.Stack.of(provider).account); } /** The same pin from a provider ARN and a literal issuer host — for a template whose provider is a native * `AWS::IAM::OIDCProvider` (no construct to ask) and whose account is only known at deploy time. */ function webIdentityPrincipalFor(providerArn, issuer, roleName, account = cdk.Aws.ACCOUNT_ID) { return new iam.WebIdentityPrincipal(providerArn, { StringEquals: { [`${issuer}:aud`]: "sts.amazonaws.com", }, StringLike: { // DEPLOY ORDER: CredsStack (new sub format) must be live before this // condition lands anywhere — see the Access Model wiki page ("Sub-pinning"). [`${issuer}:sub`]: `${account}/${roleName}/*`, }, }); }