Package: aws-solutions-constructs.aws-lambda-secretsmanager
aws-lambda-secretsmanager module---All classes are under active development and subject to non-backward compatible changes or removal in any
future version. These are not subject to theSemantic Versioningmodel.
This means that while you may use them, you may need to update your source code when upgrading to a newer version of this package.Reference Documentation:https://docs.aws.amazon.com/solutions/latest/constructs/LanguagePackagePythonaws_solutions_constructs.aws_lambda_secretsmanagerTypescript@aws-solutions-constructs/aws-lambda-secretsmanagerJavasoftware.amazon.awsconstructs.services.lambdasecretsmanagerOverviewThis AWS Solutions Construct implements the AWS Lambda function and AWS Secrets Manager secret with the least privileged permissions.Here is a minimal deployable pattern definition:Typescriptimport{Construct}from'constructs';import{Stack,StackProps}from'aws-cdk-lib';import{LambdaToSecretsmanagerProps,LambdaToSecretsmanager}from'@aws-solutions-constructs/aws-lambda-secretsmanager';import*aslambdafrom'aws-cdk-lib/aws-lambda';constconstructProps:LambdaToSecretsmanagerProps={lambdaFunctionProps:{runtime:lambda.Runtime.NODEJS_16_X,code:lambda.Code.fromAsset(`lambda`),handler:'index.handler'},};newLambdaToSecretsmanager(this,'test-lambda-secretsmanager-stack',constructProps);Pythonfromaws_solutions_constructs.aws_lambda_secretsmanagerimportLambdaToSecretsmanagerProps,LambdaToSecretsmanagerfromaws_cdkimport(aws_lambdaas_lambda,Stack)fromconstructsimportConstructLambdaToSecretsmanager(self,'test-lambda-secretsmanager-stack',lambda_function_props=_lambda.FunctionProps(code=_lambda.Code.from_asset('lambda'),runtime=_lambda.Runtime.PYTHON_3_9,handler='index.handler'))Javaimportsoftware.constructs.Construct;importsoftware.amazon.awscdk.Stack;importsoftware.amazon.awscdk.StackProps;importsoftware.amazon.awscdk.services.lambda.*;importsoftware.amazon.awscdk.services.lambda.Runtime;importsoftware.amazon.awsconstructs.services.lambdasecretsmanager.*;newLambdaToSecretsmanager(this,"test-lambda-secretsmanager-stack",newLambdaToSecretsmanagerProps.Builder().lambdaFunctionProps(newFunctionProps.Builder().runtime(Runtime.NODEJS_16_X).code(Code.fromAsset("lambda")).handler("index.handler").build()).build());Pattern Construct PropsNameTypeDescriptionexistingLambdaObj?lambda.FunctionExisting instance of Lambda Function object, providing both this andlambdaFunctionPropswill cause an error.lambdaFunctionProps?lambda.FunctionPropsUser provided props to override the default props for the Lambda function.secretProps?secretsmanager.SecretPropsOptional user provided props to override the default props for Secrets ManagerexistingSecretObj?secretsmanager.SecretExisting instance of Secrets Manager Secret object, If this is set then the secretProps is ignoredgrantWriteAccess?stringOptional Access granted to the Lambda function for the secret. 'Read' or 'ReadWrite". Default is "Read"secretEnvironmentVariableName?stringOptional Name for the Lambda function environment variable set to the ARN of the secret. Default: SECRET_ARN.existingVpc?ec2.IVpcAn optional, existing VPC into which this pattern should be deployed. When deployed in a VPC, the Lambda function will use ENIs in the VPC to access network resources and an Interface Endpoint will be created in the VPC for AWS Secrets Manager. If an existing VPC is provided, thedeployVpcproperty cannot betrue. This usesec2.IVpcto allow clients to supply VPCs that exist outside the stack using theec2.Vpc.fromLookup()method.vpcProps?ec2.VpcPropsOptional user-provided properties to override the default properties for the new VPC.enableDnsHostnames,enableDnsSupport,natGatewaysandsubnetConfigurationare set by the pattern, so any values for those properties supplied here will be overridden. IfdeployVpcis nottruethen this property will be ignored.deployVpc?booleanWhether to create a new VPC based onvpcPropsinto which to deploy this pattern. Setting this to true will deploy the minimal, most private VPC to run the pattern:One isolated subnet in each Availability Zone used by the CDK programenableDnsHostnamesandenableDnsSupportwill both be set to trueIf this property istruethenexistingVpccannot be specified. Defaults tofalse.Pattern PropertiesNameTypeDescriptionlambdaFunctionlambda.FunctionReturns an instance of lambda.Function created by the constructsecretsecretsmanager.SecretReturns an instance of secretsmanager.Secret created by the constructvpc?ec2.IVpcReturns an interface on the VPC used by the pattern (if any). This may be a VPC created by the pattern or the VPC supplied to the pattern constructor.Default settingsOut of the box implementation of the Construct without any override will set the following defaults:AWS Lambda FunctionConfigure limited privilege access IAM role for Lambda functionEnable reusing connections with Keep-Alive for NodeJs Lambda functionEnable X-Ray TracingSet Environment Variables(default) SECRET_ARN containing the ARN of the secret as return by CDKsecretArn property.AWS_NODEJS_CONNECTION_REUSE_ENABLED (for Node 10.x and higher functions)Amazon SecretsManager SecretEnable read-only access for the associated AWS Lambda FunctionCreates a new Secret(default) random name(default) random valueRetain the Secret when deleting the CloudFormation stackArchitecture© Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.