🥇Automatisering af håndtering af Let’s Encrypt SSL-certifikater ved hjælp af DNS-01 challenge og AWS

Indlægget beskriver trinene til automatisering af styring af SSL-certifikater fra Let’s Encrypt CA ved hjælp af DNS-01 challenge og AWS.

acme-dns-route53 — dette er et værktøj, der gør det muligt for os at implementere denne funktion. Det kan arbejde med SSL-certifikater fra Let’s Encrypt, gemme dem i Amazon Certificate Manager, bruge Route53 API til at gennemføre DNS-01 challenge og endelig sende meddelelser til SNS. I acme-dns-route53 der er også indbygget funktionalitet til brug inde i AWS Lambda, og det er præcis det, vi har brug for.

Denne artikel er opdelt i 4 sektioner:

oprette en zip-fil;
oprette en IAM-rolle;
oprette en lambda-funktion, der kører acme-dns-route53;
oprette en CloudWatch-timer, der triggere funktionen 2 gange dagligt;

Note: før vi starter, skal vi installere GoLang 1.9+ og AWS CLI

Oprettelse af zip-fil

acme-dns-route53 er skrevet i GoLang og kræver version 1.9 eller nyere.

Vi skal oprette en zip-fil med binærfilen acme-dns-route53 inden i. For dette skal vi installere acme-dns-route53 fra GitHub-repositoriet ved hjælp af kommandoen go install:

$ env GOOS=linux GOARCH=amd64 go install github.com/begmaroman/acme-dns-route53

Binærfilen er installeret i $GOPATH/bin mappen. Vær opmærksom på, at vi angav to miljøvariabler under installationen: GOOS=linux og GOARCH=amd64. De informerer Go-kompilatoren om, at den skal oprette en binærfil, der passer til Linux OS og amd64-arkitekturen — det er det, der kører i AWS.
AWS forudsætter, at vi deployer vores program i en zip-fil, så lad os oprette acme-dns-route53.zip et arkiv, der kun indeholder den lige installerede binærfil:

$ zip -j ~/acme-dns-route53.zip $GOPATH/bin/acme-dns-route53

Note: binærfilen skal være i roden af zip-arkivet. For dette bruger vi -j flag.

Nu er vores zip-fil klar til deployment, det eneste der mangler, er at oprette en rolle med de nødvendige rettigheder.

Oprettelse af IAM-rolle

Vi skal opsætte en IAM-rolle med de rettigheder, der er nødvendige for vores lambda under udførelsen.
Lad os kalde denne politik lambda-acme-dns-route53-executor og straks give den den grundlæggende rolle AWSLambdaBasicExecutionRole. Dette vil tillade vores lambda at blive kørt og skrive logs i AWS CloudWatch-tjenesten.
Først opretter vi en JSON-fil, der beskriver vores rettigheder. Dette giver i princippet lambda-tjenesterne tilladelse til at bruge rollen. lambda-acme-dns-route53-executor:

$ touch ~/lambda-acme-dns-route53-executor-policy.json

Indholdet af vores fil er som følger:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "logs:CreateLogGroup"
            ],
            "Resource": "arn:aws:logs:::*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "logs:PutLogEvents",
                "logs:CreateLogStream"
            ],
            "Resource": "arn:aws:logs:::log-group:/aws/lambda/acme-dns-route53:*"
        },
        {
            "Sid": "",
            "Effect": "Allow",
            "Action": [
                "route53:ListHostedZones",
                "cloudwatch:PutMetricData",
                "acm:ImportCertificate",
                "acm:ListCertificates"
            ],
            "Resource": "*"
        },
        {
            "Sid": "",
            "Effect": "Allow",
            "Action": [
                "sns:Publish",
                "route53:GetChange",
                "route53:ChangeResourceRecordSets",
                "acm:ImportCertificate",
                "acm:DescribeCertificate"
            ],
            "Resource": [
                "arn:aws:sns:${var.region}::",
                "arn:aws:route53:::hostedzone/*",
                "arn:aws:route53:::change/*",
                "arn:aws:acm:::certificate/*"
            ]
        }
    ]
}

Lad os nu køre kommandoen aws iam create-role for at oprette en rolle:

$ aws iam create-role --role-name lambda-acme-dns-route53-executor 
 --assume-role-policy-document ~/lambda-acme-dns-route53-executor-policy.json

Note: huske policy ARN (Amazon Resource Name) — vi får brug for den i de næste trin.

Rollen lambda-acme-dns-route53-executor er oprettet, nu skal vi angive tilladelser til den. Den nemmeste måde at gøre dette på er at bruge kommandoen aws iam attach-role-policy, ved at give policy ARN AWSLambdaBasicExecutionRole som følger:

$ aws iam attach-role-policy --role-name lambda-acme-dns-route53-executor 
--policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole

Note: listen over de resterende politikker kan findes her.

Oprettelse af en Lambda-funktion, der kører acme-dns-route53

Hurra! Nu kan vi også implementere vores funktion på AWS ved hjælp af kommandoen aws lambda create-function. Lambda’en skal konfigureres ved hjælp af følgende miljøvariabler:

AWS_LAMBDA — angiver acme-dns-route53 at udførelsen foregår indenfor AWS Lambda.
DOMAINS — liste over domæner adskilt af kommaer.
LETSENCRYPT_EMAIL — indeholder Let’s Encrypt Email.
NOTIFICATION_TOPIC — navnet på SNS Notification Topic (valgfri).
STAGING — ved værdien 1 bruges staging-miljø.
1024 MB — hukommelsesgrænsen, kan ændres.
900 secs (15 min) — timeout.
acme-dns-route53 — navnet på vores binærfil, der ligger i arkivet.
fileb://~/acme-dns-route53.zip — stien til arkivet, som vi har oprettet.

Lad os nu implementere:

$ aws lambda create-function 
 --function-name acme-dns-route53 
 --runtime go1.x 
 --role arn:aws:iam:::role/lambda-acme-dns-route53-executor 
 --environment Variables="{AWS_LAMBDA=1,DOMAINS="example1.com,example2.com",LETSENCRYPT_EMAIL=begmaroman@gmail.com,STAGING=0,NOTIFICATION_TOPIC=acme-dns-route53-obtained}" 
 --memory-size 1024 
 --timeout 900 
 --handler acme-dns-route53 
 --zip-file fileb://~/acme-dns-route53.zip

 {
     "FunctionName": "acme-dns-route53", 
     "LastModified": "2019-05-03T19:07:09.325+0000", 
     "RevisionId": "e3fadec9-2180-4bff-bb9a-999b1b71a558", 
     "MemorySize": 1024, 
     "Environment": {
         "Variables": {
            "DOMAINS": "example1.com,example2.com", 
            "STAGING": "1", 
            "LETSENCRYPT_EMAIL": "your@email.com", 
            "NOTIFICATION_TOPIC": "acme-dns-route53-obtained", 
            "AWS_LAMBDA": "1"
         }
     }, 
     "Version": "$LATEST", 
     "Role": "arn:aws:iam:::role/lambda-acme-dns-route53-executor", 
     "Timeout": 900, 
     "Runtime": "go1.x", 
     "TracingConfig": {
         "Mode": "PassThrough"
     }, 
     "CodeSha256": "+2KgE5mh5LGaOsni36pdmPP9O35wgZ6TbddspyaIXXw=", 
     "Description": "", 
     "CodeSize": 8456317,
"FunctionArn": "arn:aws:lambda:us-east-1::function:acme-dns-route53", 
     "Handler": "acme-dns-route53"
 }

Oprettelse af CloudWatch-timer, der aktiverer funktionen to gange om dagen

Det sidste skridt er at konfigurere en cron, som kalder vores funktion to gange om dagen:

oprette en CloudWatch-regel med værdien schedule_expression.
oprette et mål for reglen (hvad der skal udføres), ved at angive ARN for lambda-funktionen.
give reglen tilladelse til at kalde lambda-funktionen.

Nedenfor har jeg vedhæftet min Terraform-konfiguration, men det kan faktisk gøres meget nemt med AWS-konsollen eller AWS CLI.

# Cloudwatch event rule that runs acme-dns-route53 lambda every 12 hours
resource "aws_cloudwatch_event_rule" "acme_dns_route53_sheduler" {
  name                = "acme-dns-route53-issuer-scheduler"
  schedule_expression = "cron(0 */12 * * ? *)"
}

# Specify the lambda function to run
resource "aws_cloudwatch_event_target" "acme_dns_route53_sheduler_target" {
  rule = "${aws_cloudwatch_event_rule.acme_dns_route53_sheduler.name}"
  arn  = "${aws_lambda_function.acme_dns_route53.arn}"
}

# Give CloudWatch permission to invoke the function
resource "aws_lambda_permission" "permission" {
  action        = "lambda:InvokeFunction"
  function_name = "${aws_lambda_function.acme_dns_route53.function_name}"
  principal     = "events.amazonaws.com"
  source_arn    = "${aws_cloudwatch_event_rule.acme_dns_route53_sheduler.arn}"
}

Nu har du også konfigureret automatisk oprettelse og opdatering af SSL-certifikater

Kilde: habr.com