Der Beitrag beschreibt die Schritte zur Automatisierung der Verwaltung von SSL-Zertifikaten von verwendend, und AWS.
â ist ein Tool, das es uns ermöglicht, diese Funktion zu realisieren. Es kann mit SSL-Zertifikaten von Letâs Encrypt arbeiten, sie im Amazon Certificate Manager speichern, die Route53-API zur Umsetzung der DNS-01-Herausforderung nutzen und schlieĂlich Benachrichtigungen in SNS pushen. DarĂŒber hinaus acme-dns-route53 gibt es eine integrierte FunktionalitĂ€t zur Nutzung innerhalb von AWS Lambda, und das ist genau das, was wir brauchen.
Dieser Artikel ist in 4 Abschnitte unterteilt:
- Erstellung einer Zip-Datei;
- Erstellung einer IAM-Rolle;
- Erstellung einer Lambda-Funktion, die startet acme-dns-route53;
- Erstellung eines CloudWatch-Timers, der die Funktion zweimal tÀglich auslöst;
Hinweis: vor Beginn mĂŒssen wir und
Erstellung einer Zip-Datei
acme-dns-route53 ist in GoLang geschrieben und unterstĂŒtzt Versionen ab 1.9.
Wir mĂŒssen eine Zip-Datei mit der BinĂ€rdatei acme-dns-route53 innen erstellen. Dazu mĂŒssen wir acme-dns-route53 aus dem GitHub-Repository mit dem Befehl go install:
$ env GOOS=linux GOARCH=amd64 go install github.com/begmaroman/acme-dns-route53Die BinĂ€rdatei wird im $GOPATH/bin Verzeichnis installiert. Beachten Sie, dass wir bei der Installation zwei Umgebungsvariablen festgelegt haben: GOOS=linux und GOARCH=amd64. Diese informieren den Go-Compiler ĂŒber die Notwendigkeit, eine BinĂ€rdatei zu erstellen, die fĂŒr das Linux-Betriebssystem und die amd64-Architektur geeignet ist â das ist das, was in AWS ausgefĂŒhrt wird.
AWS setzt voraus, dass unser Programm in einer Zip-Datei bereitgestellt wird, also lassen Sie uns acme-dns-route53.zip ein Archiv erstellen, das die gerade installierte BinÀrdatei enthÀlt:
$ zip -j ~/acme-dns-route53.zip $GOPATH/bin/acme-dns-route53Hinweis: Die BinÀrdatei sollte sich im Wurzelverzeichnis des Zip-Archivs befinden. Dazu verwenden wir -j das Flag.
Jetzt ist unsere Zip-Datei bereit fĂŒr die Bereitstellung, es bleibt nur noch, eine Rolle mit den erforderlichen Rechten zu erstellen.
Erstellung einer IAM-Rolle
Wir mĂŒssen eine IAM-Rolle mit den Rechten einrichten, die unsere Lambda wĂ€hrend ihrer AusfĂŒhrung benötigt.
Lassen Sie uns diese Richtlinie nennen lambda-acme-dns-route53-executor und ihr sofort die grundlegende Rolle AWSLambdaBasicExecutionRolezuweisen. Dies ermöglicht es unserer Lambda, auszufĂŒhren und Protokolle im AWS CloudWatch-Dienst zu schreiben.
ZunÀchst erstellen wir eine JSON-Datei, in der unsere Rechte beschrieben sind. Dies erlaubt im Wesentlichen den Lambda-Diensten, die Rolle lambda-acme-dns-route53-executor:
$ touch ~/lambda-acme-dns-route53-executor-policy.jsonzu verwenden. Der Inhalt unserer Datei ist wie folgt:
{
"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/*"
]
}
]
}Jetzt fĂŒhren wir den Befehl aus aws iam create-role um eine Rolle zu erstellen:
$ aws iam create-role --role-name lambda-acme-dns-route53-executor
--assume-role-policy-document ~/lambda-acme-dns-route53-executor-policy.jsonHinweis: merken Sie sich die Policy ARN (Amazon Resource Name) â diese benötigen wir in den nĂ€chsten Schritten.
Die Rolle lambda-acme-dns-route53-executor wurde erstellt, jetzt mĂŒssen wir Berechtigungen dafĂŒr angeben. Der einfachste Weg, dies zu tun, ist, den Befehl aws iam attach-role-policyauszufĂŒhren und die Policy ARN zu ĂŒbergeben AWSLambdaBasicExecutionRole folgendermaĂen ausfĂŒhren:
$ aws iam attach-role-policy --role-name lambda-acme-dns-route53-executor
--policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRoleHinweis: Die Liste der anderen Richtlinien finden Sie .
Erstellen einer Lambda-Funktion, die ausfĂŒhrt acme-dns-route53
Hurra! Jetzt können wir unsere Funktion auch mit dem Befehl bereitstellen aws lambda create-function. Die Lambda sollte konfiguriert werden, indem die folgenden Umgebungsvariablen verwendet werden:
AWS_LAMBDAâ zeigt an, acme-dns-route53 dass die AusfĂŒhrung innerhalb von AWS Lambda erfolgt.DOMAINSâ eine durch Kommas getrennte Liste von Domains.LETSENCRYPT_EMAILâ enthĂ€lt .NOTIFICATION_TOPICâ der Name des SNS-Benachrichtigungsthemas (optional).STAGINGâ wenn gesetzt,1wird die Staging-Umgebung verwendet.1024MB â der Speichergrenzwert, kann geĂ€ndert werden.900secs (15 min) â Timeout.acme-dns-route53â der Name unseres BinĂ€rarchivs, das im Archiv gespeichert ist.fileb://~/acme-dns-route53.zipâ der Pfad zum Archiv, das wir erstellt haben.
Jetzt bereitstellen:
$ 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://~/
{
"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"
}Erstellen eines CloudWatch-Timers, der die Funktion zweimal tÀglich auslöst.
Der letzte Schritt besteht darin, einen Cron zu konfigurieren, der unsere Funktion zweimal tÀglich aufruft:
- ein CloudWatch-Regel mit dem Wert zu erstellen
schedule_expression. - ein Ziel fĂŒr die Regel (was ausgefĂŒhrt werden soll) zu erstellen, indem die ARN der Lambda-Funktion angegeben wird.
- der Regel die Berechtigung zu geben, die Lambda-Funktion aufzurufen.
Unten habe ich meine Terraform-Konfiguration angehĂ€ngt, aber tatsĂ€chlich ist dies sehr einfach ĂŒber die AWS-Konsole oder die AWS-CLI zu erledigen.
# 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}"
}Jetzt sind auch bei Ihnen die automatische Erstellung und Aktualisierung von SSL-Zertifikaten eingerichtet.
Quelle: habr.com
