Příspěvek popisuje kroky k automatizaci správy certifikátů SSL z pomocí и AWS.
je nástroj, který nám umožní tuto funkci implementovat. Umí pracovat s SSL certifikáty z Let's Encrypt, ukládat je do Amazon Certificate Manager, využívat Route53 API k implementaci DNS-01 výzvy a nakonec odesílat upozornění na SNS. V acme-dns-route53 K dispozici je také vestavěná funkce pro použití uvnitř AWS Lambda, a to je to, co potřebujeme.
Tento článek je rozdělen do 4 částí:
- vytvoření souboru zip;
- vytvoření role IAM;
- vytvoření lambda funkce, která běží acme-dns-route53;
- vytvoření časovače CloudWatch, který spouští funkci 2krát denně;
Poznámka: Než začnete, musíte nainstalovat и
Vytvoření souboru zip
acme-dns-route53 je napsán v GoLang a podporuje verzi ne nižší než 1.9.
Musíme vytvořit soubor zip s binárním souborem acme-dns-route53 uvnitř. Chcete-li to provést, musíte nainstalovat acme-dns-route53 z úložiště GitHub pomocí příkazu go install:
$ env GOOS=linux GOARCH=amd64 go install github.com/begmaroman/acme-dns-route53Binární soubor je nainstalován v $GOPATH/bin adresář. Vezměte prosím na vědomí, že během instalace jsme specifikovali dvě změněná prostředí: GOOS=linux и GOARCH=amd64. Kompilátoru Go jasně dávají najevo, že potřebuje vytvořit binární soubor vhodný pro OS Linux a architekturu amd64 – to je to, co běží na AWS.
AWS očekává, že náš program bude nasazen v souboru zip, takže pojďme tvořit acme-dns-route53.zip archiv, který bude obsahovat nově nainstalovaný binární soubor:
$ zip -j ~/acme-dns-route53.zip $GOPATH/bin/acme-dns-route53Poznámka: Binární soubor by měl být v kořenovém adresáři zip archivu. K tomu používáme -j vlajka.
Nyní je naše zip přezdívka připravena k nasazení, zbývá pouze vytvořit roli s potřebnými právy.
Vytvoření role IAM
Musíme nastavit roli IAM s právy požadovanými naší lambda během jejího provádění.
Říkejme tomu politika lambda-acme-dns-route53-executor a hned jí dát základní roli AWSLambdaBasicExecutionRole. To umožní naší lambdě spouštět a zapisovat protokoly do služby AWS CloudWatch.
Nejprve vytvoříme soubor JSON, který popisuje naše práva. To v podstatě umožní službám lambda používat roli lambda-acme-dns-route53-executor:
$ touch ~/lambda-acme-dns-route53-executor-policy.jsonObsah našeho souboru je následující:
{
"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/*"
]
}
]
}Nyní spusťte příkaz aws iam create-role vytvořit roli:
$ aws iam create-role --role-name lambda-acme-dns-route53-executor
--assume-role-policy-document ~/lambda-acme-dns-route53-executor-policy.jsonPoznámka: zapamatujte si politiku ARN (Amazon Resource Name) – budeme ji potřebovat v dalších krocích.
Role lambda-acme-dns-route53-executor vytvořen, nyní pro něj musíme zadat oprávnění. Nejjednodušší způsob, jak toho dosáhnout, je použít příkaz aws iam attach-role-policy, předávání zásad ARN AWSLambdaBasicExecutionRole takto:
$ aws iam attach-role-policy --role-name lambda-acme-dns-route53-executor
--policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRolePoznámka: lze nalézt seznam s dalšími zásadami .
Vytvoření funkce lambda, která běží acme-dns-route53
Hurá! Nyní můžete naši funkci nasadit do AWS pomocí příkazu aws lambda create-function. Lambda musí být nakonfigurována pomocí následujících proměnných prostředí:
AWS_LAMBDA- dává jasno acme-dns-route53 že ke spuštění dochází uvnitř AWS Lambda.DOMAINS— seznam domén oddělených čárkami.LETSENCRYPT_EMAIL- obsahuje .NOTIFICATION_TOPIC— název tématu oznámení SNS (nepovinné).STAGING- na hodnotě1se používá inscenační prostředí.1024MB - limit paměti, lze změnit.900s (15 min) – časový limit.acme-dns-route53— název naší dvojhvězdy, která je v archivu.fileb://~/acme-dns-route53.zip— cesta k archivu, který jsme vytvořili.
Nyní nasadíme:
$ 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"
}Vytvoření časovače CloudWatch, který spouští funkci 2krát denně
Posledním krokem je nastavení cronu, který volá naši funkci dvakrát denně:
- vytvořte pravidlo CloudWatch s hodnotou
schedule_expression. - vytvořte cíl pravidla (co by se mělo provést) zadáním ARN funkce lambda.
- povolte pravidlu volat funkci lambda.
Níže jsem připojil svou konfiguraci Terraform, ale ve skutečnosti se to dělá velmi jednoduše pomocí konzoly AWS nebo 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}"
}Nyní jste nakonfigurováni pro automatické vytváření a aktualizaci certifikátů SSL
Zdroj: www.habr.com