Automatisering av hantering av Let's Encrypt SSL-certifikat med hjälp av DNS-01 utmaning och AWS

Den här posten beskriver stegen för att automatisera hanteringen av SSL-certifikat från Let’s Encrypt CA genom att använda DNS-01-utmaning och AWS.

acme-dns-route53 — ett verktyg som gör att vi kan implementera denna funktion. Det kan hantera SSL-certifikat från Let’s Encrypt, lagra dem i Amazon Certificate Manager, använda Route53 API för att genomföra DNS-01-utmaningen och slutligen skicka meddelanden till SNS. I acme-dns-route53 finns också inbyggd funktionalitet för användning inom AWS Lambda, och det är precis vad vi behöver.

Denna artikel är uppdelad i 4 sektioner:

• skapa en zip-fil;
• skapa en IAM-roll;
• skapa en lambda-funktion som kör acme-dns-route53;
• skapa en CloudWatch-timer som triggar funktionen 2 gånger om dagen;

Obs: innan du börjar måste du installera GoLang 1.9+ och Skapa en serverlös funktion via webbgränssnittet eller med ett verktyg

Skapa zip-fil

acme-dns-route53 är skrivet i GoLang och stödjer versioner 1.9 eller högre.

Vi behöver skapa en zip-fil med binären acme-dns-route53 inuti. För detta behöver vi installera acme-dns-route53 från GitHub-repositoriet med kommandot go install:

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

Binären installeras i $GOPATH/bin katalogen. Observera att vi i installationen angav två miljövariabler: GOOS=linux och GOARCH=amd64. De meddelar Go-kompilatorn att den ska skapa en binär fil som är lämplig för Linux OS och amd64-arkitektur — detta är vad som körs i AWS.
AWS förutsätter att vårt program deployeras i en zip-fil, så låt oss skapa acme-dns-route53.zip ett arkiv som endast innehåller den nyligen installerade binären:

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

Obs: binären ska vara i roten av zip-arkivet. För detta använder vi -j flaggan.

Nu är vår zip fil redo för distribution, vi behöver bara skapa en roll med nödvändiga rättigheter.

Skapa IAM-roll

Vi behöver konfigurera en IAM-roll med rättigheter som vår lambda behöver under sin körning.
Låt oss kalla denna policy lambda-acme-dns-route53-executor och ge den en grundläggande roll AWSLambdaBasicExecutionRole. Detta gör att vår lambda kan starta och skriva loggar i AWS CloudWatch-tjänsten.
Först skapar vi en JSON-fil som beskriver våra rättigheter. Detta, i huvudsak, tillåter lambda-tjänsterna att använda rollen lambda-acme-dns-route53-executor:

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

Innehållet i vår fil är följande:

{
    "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/*"
            ]
        }
    ]
}

Nu kör vi kommandot aws iam create-role för att skapa en roll:

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

Obs: kom ihåg policy ARN (Amazon Resource Name) - vi kommer att behöva den senare.

Rollen lambda-acme-dns-route53-executor är skapad, nu måste vi ange behörigheter för den. Det enklaste sättet att göra detta är att använda kommandot aws iam attach-role-policy, genom att skicka policy ARN AWSLambdaBasicExecutionRole på följande sätt:

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

Obs: en lista över övriga policys kan hittas här.

Skapa en Lambda-funktion som kör acme-dns-route53

Hurray! Nu kan vi också deploya vår funktion på AWS med kommandot aws lambda create-function. Lambda ska konfigureras med följande miljövariabler:

• AWS_LAMBDA — anger acme-dns-route53 att körningen sker inom AWS Lambda.
• DOMAINS — en lista över domäner, separerade med kommatecken.
• LETSENCRYPT_EMAIL — innehåller Let’s Encrypt Email.
• NOTIFICATION_TOPIC — namnet på SNS Notification Topic (valfritt).
• STAGING — vid värdet 1 används staging-miljö.
• 1024 MB — minnesgräns, kan ändras.
• 900 secs (15 min) — tidsgräns.
• acme-dns-route53 — namnet på vår binärfil, som ligger i arkivet.
• fileb://~/acme-dns-route53.zip — sökvägen till arkivet som vi skapade.

Nu deployar vi:

$ 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"
 }

Skapa en CloudWatch-timer som triggar funktionen två gånger om dagen

Det sista steget är att konfigurera en cron-jobb som kallar vår funktion två gånger om dagen:

• skapa en CloudWatch-regel med värdet schedule_expression.
• skapa ett mål för regeln (vad som ska köras) genom att ange ARN för lambda-funktionen.
• ge regeln rätt att kalla lambda-funktionen.

Nedan bifogar jag min Terraform-konfiguration, men det görs faktiskt mycket enkelt med AWS-konsolen 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 ni också automatiserat skapandet och uppdateringen av SSL-certifikat

Källa: habr.com