@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
JavaScript
;
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}/*`,
},
});
}