aws-lambda-secretsmanager

Todas as classes estão em desenvolvimento ativo e estão sujeitas a alterações ou remoção não compatíveis com versões anteriores em qualquer versão futura. Estes não estão sujeitos àSemantic versionModelo. Isso significa que, embora você possa usá-los, você pode precisar atualizar seu código-fonte ao atualizar para uma versão mais recente deste pacote.

Observações: Para garantir a funcionalidade adequada, os pacotes AWS Solutions Constructs e os pacotes CDK da AWS em seu projeto devem ser da mesma versão.

Linguagem	Pacote
Python	aws_solutions_constructs.aws_lambda_secretsmanager
TypeScript	@aws-solutions-constructs/aws-lambda-secretsmanager
Java	software.amazon.awsconstructs.services.lambdasecretsmanager

Overview

Este AWS Solutions Construct implementa a função do AWS Lambda e o segredo do AWS Secrets Manager com as permissões menos privilegiadas.

Aqui está uma definição de padrão implantável mínima no TypeScript:

const { LambdaToSecretsmanagerProps,  LambdaToSecretsmanager } from '@aws-solutions-constructs/aws-lambda-secretsmanager';

const props: LambdaToSecretsmanagerProps = {
    lambdaFunctionProps: {
      runtime: lambda.Runtime.NODEJS_14_X,
      // This assumes a handler function in lib/lambda/index.js
      code: lambda.Code.fromAsset(`${__dirname}/lambda`),
      handler: 'index.handler'
    },
};

new LambdaToSecretsmanager(this, 'test-lambda-secretsmanager-stack', props);

Initializer

new LambdaToSecretsmanager(scope: Construct, id: string, props: LambdaToSecretsmanagerProps);

Parâmetros

• escopoConstruct

• idstring

• propsLambdaToSecretsmanagerProps

Adereços de criação de padrão

Nome	Tipo	Descrição
ExistingAmbdaobj?	lambda.Function	Instância existente do objeto Lambda Function, fornecendo tanto isso elambdaFunctionPropscausará um erro.
LambdaFunctionProps?	lambda.FunctionProps	O usuário forneceu adereços para substituir os adereços padrão para a função Lambda.
SecretProps?	secretsmanager.SecretProps	O usuário opcional forneceu adereços para substituir os adereços padrão para o Secrets Manager.
ExistingSecrettoBJ?	secretsmanager.Secret	Instância existente do objeto secreto Secrets Manager dos, Se isso estiver definido, a propriedadesecretPropsé ignorado.
GrantWriteAccess?	boolean	Acesso de gravação opcional ao segredo para a função Lambda (somente leitura por padrão).
Nome do secretárioVironmentVariableName?	string	Nome opcional para o conjunto de variáveis de ambiente secreto do Secrets Manager para a função Lambda.
ExistingVPC?	ec2.IVpc	Uma VPC opcional existente na qual esse padrão deve ser implantado. Quando implantada em uma VPC, a função Lambda usará ENIs na VPC para acessar recursos de rede e um ponto final de interface será criado na VPC para AWS Secrets Manager. Se uma VPC existente for fornecida, odeployVpcA propriedade não pode sertrue. Isso usaec2.IVpcpara permitir que os clientes forneçam VPCs que existem fora da pilha usando oec2.Vpc.fromLookup()Método do.
VPCProps?	ec2.VpcProps	Propriedades opcionais fornecidas pelo usuário para substituir as propriedades padrão da nova VPC.enableDnsHostnames,enableDnsSupport,natGateways, esubnetConfigurationsão definidos pelo padrão, portanto, quaisquer valores para essas propriedades fornecidas aqui serão substituídos. SedeployVpcnão étrueentão essa propriedade será ignorada.
Implementar VPC?	boolean	Criar uma nova VPC com base novpcPropsno qual implantar esse padrão. Configurando isso comotrueimplantará a VPC mínima e mais privada para executar o padrão: Uma sub-rede isolada em cada zona de disponibilidade usada pelo programa CDK enableDnsHostnameseenableDnsSupportserão ambos definidos comotrue Se esta propriedade fortrue, entãoexistingVpcnão pode ser especificado. Padronizado como false.

Propriedades de padrão

Nome	Tipo	Descrição
LambdaFunction	lambda.Function	Retorna uma instância delambda.Functioncriado pela construção.
segredo	secretsmanager.Secret	Retorna uma instância desecretsmanager.Secretcriado pela construção.
VPC?	ec2.IVpc	Retorna uma interface na VPC usada pelo padrão (se houver). Esta pode ser uma VPC criada pelo padrão ou pela VPC fornecida ao construtor de padrões.

Configurações padrão

A implementação imediata desse padrão sem substituições definirá os seguintes padrões:

Função do AWS Lambda

• Configurar a função do IAM de acesso de privilégio limitado para a função Lambda

• Habilite a reutilização de conexões com a função Keep-Alive para NodeJS Lambda.

• Ativar rastreamento do X-Ray.

• Definir variáveis de ambiente:

  • (padrão) SECRET_ARN contendo o ARN do segredo como retorno pelo CDKSecretArnA propriedade

  • AWS_NODEJS_CONNECTION_REUSE_ENABLED(para funções Node 10.x e superiores)

Segredo do Amazon Secrets Manager

• Habilitar acesso somente leitura para a função do AWS Lambda associada

• Habilitar a criptografia do lado do servidor usando uma chave KMS padrão para a conta e a região

• Cria um novo segredo:

  • (padrão) nome aleatório

  • valor aleatório (padrão)

• Manter o segredo ao excluir a pilha do CloudFormation

Architecture

GitHub

Para exibir o código desse padrão, crie/exiba problemas e solicitações pull e muito mais:
	@aws -solutions-constructs/aws-lambda-secretsmanager