ʻO ka Automation o Let's Encrypt SSL certificate management using DNS-01 challenge and AWS

Hōʻike ka pou i nā hana e hoʻokaʻawale i ka hoʻokele o nā palapala SSL mai E hoʻopili iā CA hoʻohana ʻana DNS-01 pilikia и AWS.

acme-dns-alanui53 he mea hana e hiki ai iā mākou ke hoʻokō i kēia hiʻohiʻona. Hiki iā ia ke hana me nā palapala SSL mai Let's Encrypt, mālama iā lākou ma Amazon Certificate Manager, hoʻohana i ka Route53 API no ka hoʻokō ʻana i ka hoʻokūkū DNS-01, a ʻo ka hope, hoʻouna i nā leka hoʻomaopopo iā SNS. IN acme-dns-alanui53 Aia kekahi hana i kūkulu ʻia no ka hoʻohana ʻana i loko o AWS Lambda, a ʻo ia ka mea e pono ai mākou.

Ua māhele ʻia kēia ʻatikala i 4 mau ʻāpana:

  • ka hana ʻana i kahi faila zip;
  • hana i kahi hana IAM;
  • e hana ana i kahi hana lambda e holo ana acme-dns-alanui53;
  • ka hana ʻana i kahi manawa CloudWatch e hoʻoulu i kahi hana 2 mau manawa i ka lā;

'Ōlelo Aʻo: Ma mua o kou hoʻomaka ʻana pono ʻoe e hoʻokomo ʻO GoLang 1.9+ и AWS CLI

Ke hana ʻana i kahi faila zip

Ua kākau ʻia ʻo acme-dns-route53 ma GoLang a kākoʻo i ka mana ma lalo o 1.9.

Pono mākou e hana i kahi faila zip me kahi binary acme-dns-route53 i loko. No ka hana ʻana i kēia pono ʻoe e hoʻokomo acme-dns-route53 mai ka waihona waihona GitHub me ka hoʻohana ʻana i ke kauoha go install:

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

Hoʻokomo ʻia ka binary i loko $GOPATH/bin papa kuhikuhi. E ʻoluʻolu e hoʻomaopopo i ka wā o ka hoʻokomo ʻana ua kuhikuhi mākou i ʻelua mau wahi i hoʻololi ʻia: GOOS=linux и GOARCH=amd64. Hoʻomaopopo lākou i ka Go compiler pono e hana i kahi binary kūpono no ka Linux OS a me ka hoʻolālā amd64 - ʻo ia ka mea e holo nei ma AWS.
Manaʻo ʻo AWS e kau ʻia kā mākou papahana i kahi faila zip, no laila e hana mākou acme-dns-route53.zip waihona e loaʻa ai ka binary hou i hoʻokomo ʻia:

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

'Ōlelo Aʻo: Pono ka binary ma ke kumu o ka waihona zip. No kēia mea mākou e hoʻohana ai -j hae.

I kēia manawa ua mākaukau kā mākou inoa inoa zip no ka hoʻolaha ʻana, ʻo ka mea i koe wale nō ke hana i kahi kuleana me nā kuleana kūpono.

Ke hana nei i kahi hana IAM

Pono mākou e hoʻonohonoho i kahi kuleana IAM me nā kuleana i koi ʻia e kā mākou lambda i ka wā e hoʻokō ai.
E kāhea kākou i kēia kulekele lambda-acme-dns-route53-executor a hāʻawi koke iā ia i kahi kuleana kumu AWSLambdaBasicExecutionRole. E ʻae kēia i kā mākou lambda e holo a kākau i nā lāʻau i ka lawelawe AWS CloudWatch.
ʻO ka mea mua, hana mākou i kahi faila JSON e wehewehe ana i kā mākou kuleana. E ʻae kēia i nā lawelawe lambda e hoʻohana i ka hana lambda-acme-dns-route53-executor:

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

ʻO nā mea i loko o kā mākou faila penei:

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

I kēia manawa, e holo kāua i ke kauoha aws iam create-role e hana i kahi kuleana:

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

'Ōlelo Aʻo: e hoʻomanaʻo i ke kulekele ARN (Amazon Resource Name) - pono mākou i nā pae aʻe.

ʻO ke kuleana o lambda-acme-dns-route53-executor hana ʻia, i kēia manawa pono mākou e kuhikuhi i nā ʻae no ia. ʻO ke ala maʻalahi e hana i kēia, ʻo ia ka hoʻohana ʻana i ke kauoha aws iam attach-role-policy, hoʻoholo i ke kulekele ARN AWSLambdaBasicExecutionRole penei:

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

'Ōlelo Aʻo: hiki ke loaʻa kahi papa inoa me nā kulekele ʻē aʻe maanei.

Ke hana nei i kahi hana lambda e holo ana acme-dns-alanui53

Hooray! I kēia manawa hiki iā ʻoe ke kau i kā mākou hana i AWS me ka hoʻohana ʻana i ke kauoha aws lambda create-function. Pono e hoʻonohonoho ʻia ka lambda me ka hoʻohana ʻana i nā ʻano hoʻololi kaiapuni:

  • AWS_LAMBDA - hoʻomaopopo acme-dns-alanui53 ke hana ʻia nei ka hoʻokō i loko o AWS Lambda.
  • DOMAINS — he papa inoa o nā kāʻei kapu i hoʻokaʻawale ʻia e nā koma.
  • LETSENCRYPT_EMAIL - aia E hoʻopili i ka leka uila.
  • NOTIFICATION_TOPIC — inoa o SNS Notification Topic (koho).
  • STAGING - ma ka waiwai 1 hoʻohana ʻia ke kaiapuni staging.
  • 1024 MB - ka palena hoʻomanaʻo, hiki ke hoʻololi.
  • 900 secs (15 min) — manawa pau.
  • acme-dns-route53 - ka inoa o kā mākou binary, aia ma ka waihona.
  • fileb://~/acme-dns-route53.zip - ke ala i ka waihona a mākou i hana ai.

I kēia manawa, e hoʻolaha kākou:

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

Ke hana nei i kahi manawa CloudWatch e hoʻomaka i kahi hana 2 mau manawa i ka lā

ʻO ka hana hope e hoʻonohonoho i ka cron, e kāhea i kā mākou hana ʻelua i ka lā:

  • hana i kahi lula CloudWatch me ka waiwai schedule_expression.
  • e hana i kahi pahuhopu lula (he aha ka mea e hoʻokō ʻia) ma ke kuhikuhi ʻana i ka ARN o ka hana lambda.
  • hāʻawi i ka ʻae i ka lula e kāhea i ka hana lambda.

Ma lalo iho ua hoʻopili wau i kaʻu Terraform config, akā ʻoiaʻiʻo ua hana ʻia kēia me ka hoʻohana ʻana i ka console AWS a i ʻole 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}"
}

I kēia manawa ua hoʻonohonoho ʻia ʻoe e hana a hoʻohou i nā palapala SSL

Source: www.habr.com

Pākuʻi i ka manaʻo hoʻopuka