Learn about our RFC process, Open RFC meetings & more.Join in the discussion! »

@k9securityio/k9-cdk

0.3.0 • Public • Published

k9 AWS CDK policy library

k9 Security's k9-cdk helps you protect data by provisioning strong AWS security bucket with safe defaults and a least-privilege bucket policy built on the k9 access capability model.

Usage

Use the k9 CDK to generate a policy and use it in your existing code base.

For example the following code will

  1. provision an S3 Bucket
  2. allow the ci and person1 users to administer the bucket
  3. allow the app-backend role to write data into the bucket
  4. allow the app-backend and customer-service role to read data in the bucket
import * as cdk from "@aws-cdk/core";
import * as s3 from "@aws-cdk/aws-s3";
import * as k9 from "@k9securityio/k9-cdk";
 
// Define which principals may access the bucket and what capabilities they should have
const administerResourceArns = new Set<string>([
        "arn:aws:iam::12345678910:user/ci", 
        "arn:aws:iam::12345678910:user/person1"
    ]
);
 
const writeDataArns = new Set<string>([
        "arn:aws:iam::12345678910:role/app-backend",
    ]
);
const readDataArns = new Set<string>(writeDataArns)
    .add("arn:aws:iam::12345678910:role/customer-service");
 
const app = new cdk.App();
 
const stack = new cdk.Stack(app, 'K9Example');
const bucket = new s3.Bucket(stack, 'TestBucket', {});
 
const k9BucketPolicyProps: k9.s3.K9BucketPolicyProps = {
    bucket: bucket,
    k9DesiredAccess: new Array<k9.k9policy.AccessSpec>(
         {
             accessCapability: k9.k9policy.AccessCapability.AdministerResource,
             allowPrincipalArns: administerResourceArns,
         },
         {
             accessCapability: k9.k9policy.AccessCapability.WriteData,
             allowPrincipalArns: writeDataArns,
         },
         {
             accessCapability: k9.k9policy.AccessCapability.ReadData,
             allowPrincipalArns: readDataArns,
         }
         // omit access spec for delete-data because it is unneeded
     )
};
 
k9.s3.makeBucketPolicy(stack, "S3Bucket", k9BucketPolicyProps);

See the generated k9 bucket policy in the examples directory.

Local Development and Testing

The high level build commands for this project are driven by make:

  • make all - build library, run tests, and deploy
  • make build - build the library
  • make unit-test - run unit tests for the library
  • make converge - deploy the integration test resources
  • make destroy - destroy the integration test resources

The low level build commands for this project are:

  • npm run build compile typescript to js
  • npm run watch watch for changes and compile
  • npm run test perform the jest unit tests
  • cdk deploy deploy this stack to your default AWS account/region
  • cdk diff compare deployed stack with current state
  • cdk synth emits the synthesized CloudFormation template

Keywords

none

Install

npm i @k9securityio/k9-cdk

DownloadsWeekly Downloads

1

Version

0.3.0

License

Apache-2.0

Unpacked Size

58.5 kB

Total Files

13

Last publish

Collaborators

  • avatar