Let’s Encrypt SSL sertifika haldamise automatiseerimine DNS-01 väljakutse ja AWS-i abil

Postitus kirjeldab samme SSL sertifikaatide haldamise automatiseerimiseks Let’s Encrypt CA kasutades DNS-01 väljakutse ja AWS.

acme-dns-route53 — see on tööriist, mis võimaldab meil seda funktsiooni ellu viia. See suudab töötada Let’s Encrypt SSL sertifikaatidega, salvestada need Amazon Certificate Managerisse, kasutada Route53 API-d DNS-01 väljakutse rakendamiseks ja lõpuks saata teateid SNS-i. Samuti on olemas sisseehitatud funktsionaalsus AWS Lambda kasutamiseks, ja see on see, mida me vajame. acme-dns-route53 See artikkel on jagatud nelja ossa:

zip faili loomine;

• IAM rolli loomine;
• Lambda funktsiooni loomine, mis käivitab
• CloudWatch taimeri loomine, mis käivitab funktsiooni kaks korda päevas; acme-dns-route53;
• Märkus:

enne alustamist tuleb paigaldada GoLang 1.9+ GoLang 1.9+ ja AWS CLI

acme-dns-route53 on kirjutatud GoLang-is ja toetab versiooni, mis ei ole madalam kui 1.9.

Peame looma zip faili, kus on binaarfail

siseselt. Selleks tuleb paigaldada acme-dns-route53 GitHubi hoidlast, kasutades käsku acme-dns-route53 go install $ env GOOS=linux GOARCH=amd64 go install github.com/begmaroman/acme-dns-route53:

Binaarfail on paigaldatud

$GOPATH/bin kausta. Pange tähele, et installimise ajal määrasime kaks keskkonnamuutujat: GOOS=linux GOOS=linux ja GOARCH=amd64. Need to let the Go compiler know to create a binary suitable for Linux OS and amd64 architecture — this is what runs in AWS.
AWS assumes deploying our program in a zip file, so let's create acme-dns-route53.zip an archive that will contain the freshly installed binary:

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

enne alustamist tuleb paigaldada the binary should be at the root of the zip archive. To achieve this, we use -j the flag.

Now our zip file is ready for deployment, we just need to create a role with the necessary permissions.

IAM rolli loomine

We need to set up an IAM role with permissions required by our Lambda during its execution.
Let's name this policy lambda-acme-dns-route53-executor and immediately give it a basic role AWSLambdaBasicExecutionRole. This will allow our Lambda to start and write logs to the AWS CloudWatch service.
First, let's create a JSON file that describes our permissions. Essentially, this will allow the Lambda services to use the role. lambda-acme-dns-route53-executor:

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

The content of our file is as follows:

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

Nüüd täidame käsku aws iam create-role rolli loomiseks:

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

enne alustamist tuleb paigaldada mäletage policy ARN (Amazon Resource Name) — see on järgmistes etappides vajalik.

Roll lambda-acme-dns-route53-executor on loodud, nüüd peame määrama sellele õigused. Lihtsaim viis seda teha on kasutada käsku aws iam attach-role-policy, edastades policy ARN AWSLambdaBasicExecutionRole järgmiselt:

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

enne alustamist tuleb paigaldada loetelu muudest poliitikatest on saadaval siit.

Loomine lambdafunktsioon, mis käivitab acme-dns-route53

Hurraa! Nüüd saame selle funktsiooni AWS-i üles seada käsuga aws lambda create-function. Lambda peab olema konfigureeritud järgnevate keskkonnamuutujate abil:

• AWS_LAMBDA — näitab acme-dns-route53 et täitmine toimub AWS Lambda keskkonnas.
• DOMEENID — domeenide nimekiri, eraldatud komadega.
• LETSENCRYPT_EMAIL — sisaldab Let’s Encrypti e-posti.
• NOTIFICATION_TOPIC — SNS teavitusteema nimi (valikuline).
• STAGING — väärtuse korral 1 kasutatakse testkeskkonda.
• 1024 MB — mälu piirang, mida saab muuta.
• 900 secs (15 min) — taimer.
• acme-dns-route53 — meie binaarfaile, mis on arhiveeritud.
• fileb://~/acme-dns-route53.zip — tee arhivi, mille me lõime.

Nüüd seadistame:

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

Looge CloudWatch ajastaja, mis kutsub funktsiooni välja kaks korda päevas

Viimane samm on seadistada kront, mis kutsub meie funktsiooni kaks korda päevas:

• looge CloudWatch reegel väärtusega schedule_expression.
• looge reegli sihtmärk (mis peab toimuma), näidates lambda-funktsiooni ARN-i.
• andke reegli funktsiooni kutsumiseks luba.

Allpool olen oma Terraformi seadistuse lisanud, kuid tegelikult on see väga lihtne teha AWS konsooli või AWS CLI abil.

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

Nüüd on teil ka automatiselt seadistatud SSL sertifikaatide loomine ja uuendamine.

Allikas: habr.com