DNS-01 сорилт болон AWS ашиглан Let's Encrypt SSL сертификатын удирдлагын автоматжуулалт

Нийтлэлд SSL сертификатын менежментийг автоматжуулах алхмуудыг тайлбарласан болно CA-г шифрлэцгээе ашиглах DNS-01 сорилт и AWS.

acme-dns-route53 нь энэ функцийг хэрэгжүүлэх боломжийг бидэнд олгох хэрэгсэл юм. Энэ нь Let's Encrypt-ийн SSL сертификатуудтай ажиллах, Amazon Certificate Manager-д хадгалах, DNS-53 сорилтыг хэрэгжүүлэхийн тулд Route01 API ашиглах, эцэст нь SNS руу мэдэгдэл илгээх боломжтой. IN acme-dns-route53 AWS Lambda-д ашиглахад зориулагдсан суурилуулсан функц байдаг бөгөөд энэ нь бидэнд хэрэгтэй зүйл юм.

Энэ нийтлэл нь 4 хэсэгт хуваагдана:

  • зип файл үүсгэх;
  • IAM үүргийг бий болгох;
  • ажилладаг lambda функцийг үүсгэх acme-dns-route53;
  • өдөрт 2 удаа функцийг идэвхжүүлдэг CloudWatch таймер үүсгэх;

Тайлбар: Эхлэхээсээ өмнө та суулгах хэрэгтэй GoLang 1.9+ и AWS CLI

Zip файл үүсгэж байна

acme-dns-route53 нь GoLang дээр бичигдсэн бөгөөд 1.9-ээс доошгүй хувилбарыг дэмждэг.

Бид хоёртын файлтай зип файл үүсгэх хэрэгтэй acme-dns-route53 дотор. Үүнийг хийхийн тулд та суулгах хэрэгтэй acme-dns-route53 тушаалыг ашиглан GitHub репозитороос go install:

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

Хоёртын файлыг суулгасан $GOPATH/bin лавлах. Суулгах явцад бид хоёр өөрчлөгдсөн орчинг зааж өгсөн болохыг анхаарна уу: GOOS=linux и GOARCH=amd64. Тэд Go хөрвүүлэгчид Линукс үйлдлийн систем болон amd64 архитектурт тохирох хоёртын файлыг үүсгэх хэрэгтэйг ойлгуулж өгдөг - энэ нь AWS дээр ажилладаг.
AWS нь манай програмыг зип файлд байршуулна гэж хүлээж байгаа тул бүтээцгээе acme-dns-route53.zip шинээр суулгасан хоёртын файлыг агуулсан архив:

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

Тайлбар: Хоёртын файл нь зип архивын үндсэн хэсэгт байх ёстой. Үүний тулд бид ашигладаг -j туг.

Одоо бидний зип хоч ашиглахад бэлэн болсон тул шаардлагатай эрх бүхий дүр бүтээх л үлдлээ.

IAM үүргийг бий болгож байна

Бид үүнийг хэрэгжүүлэх явцад манай ламбдагийн шаардсан эрх бүхий IAM үүргийг бий болгох хэрэгтэй.
Үүнийг бодлого гэж нэрлэе lambda-acme-dns-route53-executor нэн даруй түүнд үндсэн үүрэг өг AWSLambdaBasicExecutionRole. Энэ нь манай lambda-г AWS CloudWatch үйлчилгээнд лог ажиллуулах, бичих боломжийг олгоно.
Эхлээд бид эрхээ тодорхойлсон JSON файл үүсгэнэ. Энэ нь үндсэндээ lambda үйлчилгээнд үүргийг ашиглах боломжийг олгоно lambda-acme-dns-route53-executor:

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

Манай файлын агуулга дараах байдалтай байна.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "logs:CreateLogGroup"
            ],
            "Resource": "arn:aws:logs:<AWS_REGION>:<AWS_ACCOUNT_ID>:*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "logs:PutLogEvents",
                "logs:CreateLogStream"
            ],
            "Resource": "arn:aws:logs:<AWS_REGION>:<AWS_ACCOUNT_ID>: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}:<AWS_ACCOUNT_ID>:<TOPIC_NAME>",
                "arn:aws:route53:::hostedzone/*",
                "arn:aws:route53:::change/*",
                "arn:aws:acm:<AWS_REGION>:<AWS_ACCOUNT_ID>:certificate/*"
            ]
        }
    ]
}

Одоо тушаалыг ажиллуулцгаая aws iam create-role дүр бүтээх:

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

Тайлбар: ARN (Amazon Resource Name) бодлогыг санаарай - бид дараагийн алхамуудад хэрэгтэй болно.

Гүйцэтгэх үүрэг lambda-acme-dns-route53-executor үүсгэсэн, одоо бид үүнд зориулсан зөвшөөрлийг зааж өгөх хэрэгтэй. Үүнийг хийх хамгийн хялбар арга бол командыг ашиглах явдал юм aws iam attach-role-policy, бодлогыг нэвтрүүлэх ARN AWSLambdaBasicExecutionRole дараах байдлаар:

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

Тайлбар: бусад бодлоготой жагсаалтыг олж болно энд.

Ажиллаж байгаа lambda функцийг үүсгэж байна acme-dns-route53

Өө! Одоо та тушаалыг ашиглан манай функцийг AWS-д байрлуулж болно aws lambda create-function. Ламбда нь дараах орчны хувьсагчдыг ашиглан тохируулагдсан байх ёстой.

  • AWS_LAMBDA - тодорхой болгодог acme-dns-route53 Энэ гүйцэтгэл нь AWS Lambda дотор явагддаг.
  • DOMAINS — таслалаар тусгаарлагдсан домэйнуудын жагсаалт.
  • LETSENCRYPT_EMAIL - агуулна Имэйлийг шифрлэцгээе.
  • NOTIFICATION_TOPIC — SNS мэдэгдлийн сэдвийн нэр (заавал биш).
  • STAGING - үнэ цэнээр 1 тайзны орчинг ашиглаж байна.
  • 1024 MB - санах ойн хязгаар, өөрчлөх боломжтой.
  • 900 сек (15 мин) - завсарлага.
  • acme-dns-route53 - архивт байгаа манай хоёртын файлын нэр.
  • fileb://~/acme-dns-route53.zip - бидний үүсгэсэн архивт хүрэх зам.

Одоо байрлуулцгаая:

$ aws lambda create-function 
 --function-name acme-dns-route53 
 --runtime go1.x 
 --role arn:aws:iam::<AWS_ACCOUNT_ID>:role/lambda-acme-dns-route53-executor 
 --environment Variables="{AWS_LAMBDA=1,DOMAINS="example1.com,example2.com",[email protected],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": "[email protected]", 
            "NOTIFICATION_TOPIC": "acme-dns-route53-obtained", 
            "AWS_LAMBDA": "1"
         }
     }, 
     "Version": "$LATEST", 
     "Role": "arn:aws:iam::<AWS_ACCOUNT_ID>: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:<AWS_ACCOUNT_ID>:function:acme-dns-route53", 
     "Handler": "acme-dns-route53"
 }

Өдөрт 2 удаа функцийг идэвхжүүлдэг CloudWatch таймер үүсгэх

Сүүлийн алхам бол бидний функцийг өдөрт хоёр удаа дууддаг cron-г тохируулах явдал юм.

  • утга бүхий CloudWatch дүрмийг үүсгэ schedule_expression.
  • lambda функцийн ARN-ийг зааж өгснөөр дүрмийн зорилтыг (юуг гүйцэтгэх ёстой) үүсгэнэ.
  • lambda функцийг дуудах дүрэмд зөвшөөрөл өгнө.

Доор би Terraform тохиргоогоо хавсаргасан боловч үнэн хэрэгтээ үүнийг AWS консол эсвэл 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}"
}

Одоо та SSL сертификатуудыг автоматаар үүсгэж, шинэчлэхээр тохируулагдсан

Эх сурвалж: www.habr.com

сэтгэгдэл нэмэх