Integração de inquilinos na arquitetura SaaS para o modelo de silo usando C# e AWS CDK

O usuário envia uma POST API solicitação com a nova carga útil do inquilino (nome do inquilino, descrição do inquilino) JSON para um servidor hospedado REST API pelo Amazon Gateway. API O API Gateway processa a solicitação e a encaminha para a função de back-end do Lambda Tenant Onboarding. Neste exemplo, não há autorização nem autenticação. Em uma configuração de produção, isso API deve ser integrado ao sistema de segurança da infraestrutura SaaS.

A função de integração do locatário verifica a solicitação. Em seguida, ele tenta armazenar o registro do inquilino, que inclui o nome do inquilino, o identificador único universal gerado pelo inquilino (UUID) e a descrição do inquilino, na tabela de integração de inquilinos do Amazon DynamoDB. 

Depois que o DynamoDB armazena o registro, um stream do DynamoDB inicia a função downstream da Lambda Tenant Infrastructure.

A função do Lambda Tenant Infrastructure atua com base no stream recebido do DynamoDB. Se o stream for para o INSERT evento, a função usa a NewImage seção do stream (registro de atualização mais recente, campo Nome do inquilino) para invocar CloudFormation a criação de uma nova infraestrutura de locatário usando o modelo armazenado no bucket do S3. O CloudFormation modelo exige o parâmetro Nome do inquilino. 

AWS CloudFormation cria a infraestrutura do inquilino com base no CloudFormation modelo e nos parâmetros de entrada.

Cada configuração de infraestrutura do inquilino tem um CloudWatch alarme, um alarme de cobrança e um evento de alarme.

O evento de alarme se torna uma mensagem para um SNS tópico, que é criptografada pela AWS KMS chave do inquilino.

O SNS tópico encaminha a mensagem de alarme recebida para a SQS fila, que é criptografada pela chave de criptografia AWS KMS for do locatário.

O usuário envia uma DELETE API solicitação com a nova carga útil do inquilino (nome do inquilino, descrição do inquilino) JSON para o servidor hospedado REST API pelo Amazon API Gateway, que processará a solicitação e encaminhará para a função de integração do inquilino. Neste exemplo, não há autorização nem autenticação. Em uma configuração de produção, isso API será integrado ao sistema de segurança da infraestrutura SaaS.

A função de integração do locatário verificará a solicitação e, em seguida, tentará excluir o registro do locatário (nome do locatário) da tabela de integração do locatário. 

Depois que o DynamoDB exclui o registro com sucesso (o registro existe na tabela e é excluído), um stream do DynamoDB inicia a função downstream do Lambda Tenant Infrastructure.

A função do Lambda Tenant Infrastructure atua com base no registro de stream recebido do DynamoDB. Se o stream for para o REMOVE evento, a função usa a OldImage seção do registro (informações do registro e campo Nome do inquilino, antes da última alteração, que é exclusão) para iniciar a exclusão de uma pilha existente com base nas informações desse registro.

AWS CloudFormation exclui a pilha de inquilinos de destino de acordo com a entrada.

APIGateway

Serve como ponto de REST API entrada para a pilha do plano de controle.

Função do Lambda de integração do locatário

Essa função Lambda é iniciada pelo API Gateway usando o método m.

Uma API solicitação de POST método resulta na inserção (tenant name,tenant description) na tabela do Tenant Onboarding DynamoDB.

Neste exemplo de código, o nome do locatário também é usado como parte do nome da pilha do locatário e dos nomes dos recursos dentro dessa pilha. Isso é para facilitar a identificação desses recursos. Esse nome de locatário deve ser exclusivo em toda a configuração para evitar conflitos ou erros. A configuração detalhada da validação de entrada é explicada na documentação das IAMfunções e na seção Limitações.

O processo de persistência na tabela do DynamoDB só será bem-sucedido se o nome do locatário não for usado em nenhum outro registro na tabela.

O nome do locatário nesse caso é a chave de partição dessa tabela, pois somente a chave de partição pode ser usada como uma expressão da condição PutItem.

Se o nome do locatário nunca tiver sido registrado antes, o registro será salvo na tabela com sucesso.

No entanto, se o nome do locatário já for usado por um registro existente na tabela, a operação falhará e iniciará uma exceção do DynamoDB. ConditionalCheckFailedException A exceção será usada para retornar uma mensagem de falha (HTTP BadRequest) indicando que o nome do locatário já existe.

Uma API solicitação de DELETE método removerá o registro de um nome de inquilino específico da tabela Tenant Onboardin g.

A exclusão do registro do DynamoDB neste exemplo será bem-sucedida mesmo que o registro não exista.

Se o registro de destino existir e for excluído, ele criará um registro de stream do DynamoDB. Caso contrário, nenhum registro downstream será criado.

Integração de locatários no DynamoDB, com o Amazon DynamoDB Streams habilitado

Isso registra as informações de metadados do locatário, e qualquer registro salvo ou excluído enviará um stream downstream para a Tenant Infrastructure função do Lambda. 

A Função do Lambda da infraestrutura do locatário

Essa função do Lambda é iniciada pelo registro de stream do DynamoDB da etapa anterior. Se o registro for de um INSERT evento, ele será invocado AWS CloudFormation para criar uma nova infraestrutura de locatário com o CloudFormation modelo armazenado em um bucket do S3. Se o registro for para REMOVE, ele iniciará a exclusão de uma pilha existente com base no campo do registro do stream Tenant Name.

S3 bucket

Isso é para armazenar o CloudFormation modelo.

IAMfunções para cada função do Lambda e uma função de serviço para CloudFormation

Cada função do Lambda tem sua IAM função exclusiva com permissões de privilégio mínimo para realizar sua tarefa. Por exemplo, a função do Tenant On-boarding Lambda tem acesso de leitura/gravação ao DynamoDB, e a função do Lambda Tenant Infrastructure só pode ler o stream do DynamoDB.

Uma função CloudFormation de serviço personalizada é criada para o provisionamento da pilha de inquilinos. Essa função de serviço contém permissões adicionais para provisionamento de CloudFormation pilhas (por exemplo, a AWS KMS chave). Isso divide as funções entre o Lambda CloudFormation e evita todas as permissões em uma única função (função do Lambda de infraestrutura).

As permissões que permitem ações poderosas (como criar e excluir CloudFormation pilhas) são bloqueadas e permitidas somente em recursos que começam com. tenantcluster- A exceção é por causa AWS KMS de sua convenção de nomenclatura de recursos. O nome do inquilino ingerido do API será anexado tenantcluster- junto com outras verificações de validação (alfanumérico somente com hífen e limitado a menos de 30 caracteres para caber na maioria dos nomes de recursos). AWS Isso garante que o nome do locatário não resulte acidentalmente na interrupção das pilhas ou dos recursos da infraestrutura principal.