ACME klient Lego

ACME klient Lego je je nezávislý, bezplatný open-source projekt psaný v jazyce Go. Je ideální pro vlastní integraci a skriptování a získává širokou podporu registrátorů domén a poskytovatelů DNS. Lego je flexibilní ACME klient, který lze snadno integrovat do vlastních systémů a skriptů.

Návod připravujeme...

Návod používá syntaxi ověřenou na Lego 5.2.2. Lego v5 změnilo některé parametry oproti starším verzím, proto při chybě typu flag provided but not defined ověřte správnou syntaxi pomocí lego accounts register --help, lego run --help nebo lego --help.

Základní pojmy

• ACME – protokol pro automatizované vydávání a obnovu SSL/TLS certifikátů.
• Lego – ACME klient napsaný v Go. Umí DNS validaci přes mnoho DNS providerů (seznam podporovaných DNS providerů).
• DNS-01 – validace přes DNS TXT záznam _acme-challenge. Je nutná pro WildCard certifikáty.
• EAB kid + hmac – External Account Binding (EAB) údaje od certifikační autority. Propojují Certbot s účtem nebo produktem.
• VEDOS WAPI – API rozhraní VEDOS, přes které Lego vytváří a maže DNS TXT záznamy.
• Systemd služba - soubor s nastavením, který systému Linux říká, jak má aplikaci spouštět a udržovat ji běžící i po restartu serveru.

Ve všech uvedených příkladech nahraďte doménu example.com vlastní doménou.

Instalace Lego

apt update
apt install -y curl tar

cd /tmp
LEGO_URL=$(curl -s https://api.github.com/repos/go-acme/lego/releases/latest | sed -n 's/.*"browser_download_url": "\(.*linux_amd64.tar.gz\)".*/\1/p' | head -n1)
echo "$LEGO_URL"
curl -L -o lego.tar.gz "$LEGO_URL"
tar -xzf lego.tar.gz
install -m 0755 lego /usr/local/bin/lego
lego --version

Příkaz / hodnota	Co dělá / čím nahradit
apt update	Aktualizuje seznam balíčků.
apt install -y curl tar	Nainstaluje nástroje pro stažení a rozbalení Lego.
LEGO_URL=...	Zjistí URL posledního Linux amd64 release balíčku.
curl -L -o lego.tar.gz	Stáhne archiv Lego.
tar -xzf lego.tar.gz	Rozbalí archiv.
install -m 0755 lego /usr/local/bin/lego	Nainstaluje Lego jako spustitelný systémový příkaz.
lego --version	Ověří nainstalovanou verzi Lego.

---

Kam dál?

• ACME protokol
• ACME klient Lego (WildCard + API DNS)
• ACME klient Certbot
• SSL certifikát - vše co potřebujete vědět