Uathoibriú bainistíochta teastas SSL Let's Encrypt ag baint úsáide as dúshlán DNS-01 agus AWS

Déanann an post cur síos ar na céimeanna chun bainistíocht deimhnithe SSL a uathoibriú ó A ligean ar Criptigh CA ag baint úsáide as Dúshlán DNS-01 и AWS.

acme-dns-bhealach53 Is uirlis é a ligfidh dúinn an ghné seo a chur i bhfeidhm. Is féidir leis oibriú le deimhnithe SSL ó Let's Encrypt, iad a shábháil i Bainisteoir Teastais Amazon, bain úsáid as an Route53 API chun an dúshlán DNS-01 a chur i bhfeidhm, agus, ar deireadh, fógraí a bhrú chuig SNS. IN acme-dns-bhealach53 Tá feidhmiúlacht ionsuite ann freisin le húsáid taobh istigh de AWS Lambda, agus is é seo a theastaíonn uainn.

Tá an t-alt seo roinnte ina 4 chuid:

  • ag cruthú comhad zip;
  • ról IAM a chruthú;
  • ag cruthú feidhm lambda a ritheann acme-dns-bhealach53;
  • ag cruthú lasc ama CloudWatch a spreagann feidhm 2 uair sa lá;

Nóta: Sula dtosaíonn tú ní mór duit a shuiteáil GoLang 1.9+ и AWS CLI

Comhad zip a chruthú

Tá acme-dns-route53 scríofa i GoLang agus ní thacaíonn sé le leagan níos ísle ná 1.9.

Ní mór dúinn a chruthú zip-comhad le dénártha acme-dns-route53 istigh. Chun seo a dhéanamh ní mór duit a shuiteáil acme-dns-route53 ó stór GitHub ag baint úsáide as an ordú go install:

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

Tá an dénártha suiteáilte i $GOPATH/bin eolaire. Tabhair faoi deara gur shonraigh muid dhá thimpeallacht athraithe le linn na suiteála: GOOS=linux и GOARCH=amd64. Déanann siad soiléir don tiomsaitheoir Go go gcaithfidh sé dénártha a chruthú atá oiriúnach do Linux OS agus ailtireacht amd64 - is é seo a ritheann ar AWS.
Tá AWS ag súil go n-imscarfar ár gclár i gcomhad zip, mar sin déanaimis a chruthú acme-dns-route53.zip cartlann ina mbeidh an dénártha nua-shuiteáilte:

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

Nóta: Ba cheart go mbeadh an dénártha i bhfréamh na cartlainne zip. Chun seo a úsáid againn -j bratach.

Anois tá ár leasainm zip réidh le himscaradh, níl fágtha ach ról a chruthú leis na cearta riachtanacha.

Ról IAM a chruthú

Ní mór dúinn ról IAM a bhunú leis na cearta a éilíonn ár lambda le linn a fhorghníomhaithe.
Glaoimis ar an bpolasaí seo lambda-acme-dns-route53-executor agus láithreach bonn a thabhairt di AWSLambdaBasicExecutionRole. Tabharfaidh sé seo deis dár lambda logaí a reáchtáil agus a scríobh chuig seirbhís AWS CloudWatch.
Ar dtús, cruthaímid comhad JSON a chuireann síos ar ár gcearta. Ligfidh sé seo go bunúsach do sheirbhísí lambda an ról a úsáid lambda-acme-dns-route53-executor:

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

Seo a leanas a bhfuil sa chomhad:

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

Anois, déanaimis an t-ordú a rith aws iam create-role chun ról a chruthú:

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

Nóta: cuimhnigh ar an bpolasaí ARN (Ainm Acmhainne Amazon) - beidh sé de dhíth orainn sna chéad chéimeanna eile.

Ról lambda-acme-dns-route53-executor cruthaithe, anois ní mór dúinn ceadanna a shonrú chun é. Is é an bealach is éasca chun é seo a dhéanamh ná an t-ordú a úsáid aws iam attach-role-policy, polasaí a rith ARN AWSLambdaBasicExecutionRole ar an mbealach seo a leanas:

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

Nóta: is féidir liosta le polasaithe eile a fháil anseo.

Ag cruthú feidhm lambda a ritheann acme-dns-bhealach53

Hooray! Anois is féidir leat ár bhfeidhm a imscaradh chuig AWS ag baint úsáide as an ordú aws lambda create-function. Ní mór an lambda a chumrú ag baint úsáide as na hathróga timpeallachta seo a leanas:

  • AWS_LAMBDA - déanann sé soiléir acme-dns-bhealach53 go dtarlaíonn an forghníomhú taobh istigh de AWS Lambda.
  • DOMAINS — liosta de na fearainn atá scartha le camóga.
  • LETSENCRYPT_EMAIL - ina bhfuil A ligean ar Criptigh Ríomhphost.
  • NOTIFICATION_TOPIC — ainm an Ábhair Fhógartha SNS (roghnach).
  • STAGING - ar an luach 1 úsáidtear timpeallacht stáitse.
  • 1024 MB - teorainn chuimhne is féidir, a athrú.
  • 900 soic (15 nóim) - teorainn ama.
  • acme-dns-route53 — ainm ár ndénártha, atá sa chartlann.
  • fileb://~/acme-dns-route53.zip — an cosán chuig an gcartlann a chruthaigh muid.

Anois déanaimis imscaradh:

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

Uaineadóir CloudWatch a chruthú a spreagann feidhm 2 uair sa lá

Is é an chéim dheireanach ná cron a shocrú, a ghlaonn ár bhfeidhm faoi dhó sa lá:

  • cruthaigh riail CloudWatch leis an luach schedule_expression.
  • cruthaigh sprioc riail (cad ba cheart a chur i gcrích) trí ARN na feidhme lambda a shonrú.
  • cead a thabhairt don riail chun an fheidhm lambda a ghlaoch.

Thíos tá mo chumraíocht Terraform ceangailte agam, ach i ndáiríre déantar é seo go han-simplí ag baint úsáide as consól AWS nó 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}"
}

Anois tá tú cumraithe chun teastais SSL a chruthú agus a nuashonrú go huathoibríoch

Foinse: will.com

Add a comment