Automatizace správy SSL certifikátů Let’s Encrypt pomocí DNS-01 challenge a AWS

Příspěvek popisuje kroky pro automatizaci správy SSL certifikátů od Let’s Encrypt CA použitím výzva DNS-01 a AWS.

acme-dns-route53 — je to nástroj, který nám umožní realizovat tuto funkci. Umí pracovat se SSL certifikáty od Let’s Encrypt, ukládat je do Amazon Certificate Manager, využívat Route53 API pro realizaci výzvy DNS-01 a nakonec posílat oznámení do SNS. V acme-dns-route53 se rovněž nachází vestavěná funkčnost pro použití uvnitř AWS Lambda, což je to, co potřebujeme.

Tento článek je rozdělen na 4 části:

• vytvoření zip souboru;
• vytvoření IAM role;
• vytvoření lambda funkce, která spouští acme-dns-route53;
• vytvoření CloudWatch časovače, který spouští funkci 2krát denně;

Poznámka: před začátkem je nutné nainstalovat GoLang 1.9+ a AWS CLI

Vytvoření zip souboru

acme-dns-route53 je napsán v GoLang a podporuje verzi 1.9 a vyšší.

Musíme vytvořit zip soubor s binárními daty acme-dns-route53 uvnitř. K tomu je třeba nainstalovat acme-dns-route53 z GitHub repozitáře pomocí příkazu go install:

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

Binární soubor je nainstalován do $GOPATH/bin adresáře. Všimněte si, že při instalaci jsme zadali dvě proměnné prostředí: GOOS=linux a GOARCH=amd64. Tyto informují Go kompilátor o potřebě vytvoření binárního souboru vhodného pro Linux OS a architekturu amd64 — to je to, co se spouští v AWS.
AWS předpokládá nasazení naší aplikace v zip souboru, takže vytvořme acme-dns-route53.zip archiv, který bude obsahovat právě nainstalovaný binární soubor:

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

Poznámka: binární soubor by měl být v kořeni zip archivu. K tomu používáme -j příznak.

Nyní je náš zip připraven k nasazení, zbývá jen vytvořit roli s potřebnými právy.

Vytvoření role IAM

Musíme nastavit IAM roli s právy, které naše lambda potřebuje během jejího spuštění.
Nazvěme tuto politiku lambda-acme-dns-route53-executor a hned jí přiřkneme základní roli AWSLambdaBasicExecutionRole. To umožní naší lambdě spustit se a zapisovat logy do služby AWS CloudWatch.
Nejprve vytvoříme JSON soubor, ve kterém popíšeme naše práva. To v podstatě povolí lambda službám používat roli lambda-acme-dns-route53-executor:

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

Obsah našeho souboru je následující:

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

Nyní provedeme příkaz aws iam create-role k vytvoření role:

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

Poznámka: zapamatujte si ARN politiky (Amazon Resource Name) — budeme jej potřebovat v následujících krocích.

Role lambda-acme-dns-route53-executor byla vytvořena, nyní musíme zadat oprávnění pro ni. Nejjednodušší způsob, jak to udělat, je použít příkaz aws iam attach-role-policy, přičemž předáme ARN politiky AWSLambdaBasicExecutionRole následujícím způsobem:

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

Poznámka: seznam ostatních politik naleznete zde.

Vytvoření funkce lambda, která spouští acme-dns-route53

Hurá! Nyní můžeme nasadit naši funkci na AWS pomocí příkazu aws lambda create-function. Lambda by měla být nakonfigurována s použitím následujících proměnných prostředí:

• AWS_LAMBDA — informuje, že provádění probíhá uvnitř AWS Lambda. acme-dns-route53 DOMAINS
• — seznam domén oddělených čárkami. LETSENCRYPT_EMAIL
• — obsahuje email pro Let’s Encrypt NOTIFICATION_TOPIC.
• — název SNS Notification Topic (volitelně). STAGING
• — pokud je hodnota, používá se staging prostředí. MB — limit paměti, může být změněn. 1 secs (15 min) — časový limit.
• 1024 — název našeho binárního souboru, který je v archivu.
• 900 — cesta k archivu, který jsme vytvořili.
• acme-dns-route53 Nyní nasazujeme:
• fileb://~/acme-dns-route53.zip — путь к архиву, который мы создали.

Теперь деплоим:

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

Vytvoření CloudWatch časovače, který spouští funkci dvakrát denně

Poslední krok — nastavit cron, který vyvolává naši funkci dvakrát denně:

• vytvořit pravidlo CloudWatch s hodnotou schedule_expression.
• vytvořit cíl pravidla (co má být vykonáno), určením ARN lambda funkce.
• udělit pravidlu oprávnění k vyvolání lambda funkce.

Níže jsem přiložil svůj Terraform konfiguraci, ale ve skutečnosti je to velmi jednoduché pomocí AWS konzole nebo 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}"
}

Nyní máte také nastaveno automatické vytváření a aktualizaci SSL certifikátů

Zdroj: habr.com