Steg 5 av 8 · Linux

Linux-servrar

Serviceagenten för Linux är en systemd-tjänst. Den hämtar certifikat från appliancen och installerar dem på servern. Ni ansluter servern med en rad som ni kopierar från appliancen.

Innan ni börjar

Ni behöver:

En x86_64- eller arm64-server med systemd, till exempel Ubuntu, Debian, Red Hat Enterprise Linux, Rocky Linux eller AlmaLinux.
Root-åtkomst till servern, eller ett konto med sudo.
Att servern når appliancen direkt över HTTPS, eller når sslbrain.com och cloud.sslbrain.com på port 443. Står servern någon annanstans än appliancen, se Servrar utanför ert nätverk.

Anslut servern

Sidan Installera serviceagent visar en Linux-rad när appliancen har Linux-agenten 0.7.0. Tills dess står det Linux-servrar kan läggas till med nästa Linux-agent. under Linux.

Öppna Servrar › Installera serviceagent i sslbrain och välj Linux. Sidan visar en öppen installationskod eller skapar själv en.

Kopiera raden under Linux. Den ser ut så här:

curl -fsSL https://<appliance>/agent.sh | sudo sh -s -- --code <kod> --server https://<appliance>

Klistra in raden i en terminal på servern och tryck Enter.

agent.sh hämtar det senaste agentpaketet från samma adress, kontrollerar dess SHA-256 och installerar agenten med koden. Paketet väljer arkitektur själv. Efter en minut eller två står servern under Servrar.

Agenten installeras så att den kan installera certifikat och läsa in tjänster på nytt. Samma kod kan användas på så många servrar ni vill, tills ni stänger den under Installationskoder på samma sida, eller till den sista dag ni har gett den.

Använder appliancen sitt eget självsignerade certifikat hämtar raden agent.sh från sslbrain.com i stället, och agenten ansluter sedan direkt till appliancen. Ge appliancen ett riktigt certifikat, så hämtas agenten från appliancen själv (Gratis namn).

Anslut via sslbrain Cloud

Når servern inte appliancen direkt, öppna Servern når inte appliancen direkt och använd raden där:

curl -fsSL https://sslbrain.com/agent.sh | sudo sh -s -- --code <kod>

Agenten hittar appliancen genom sslbrain Cloud med koden. Cloud kan varken läsa eller ändra det som appliancen och agenten skickar till varandra (Servrar utanför ert nätverk).

Avsnittet finns på fliken Linux när appliancen har Linux-agenten 0.7.0.
Avsnittet visas bara när Tillåt agentkommunikation via Cloud är påslagen under Inställningar › Säkerhet.
Alla licenser kan ansluta via Cloud. Omfattar licensen inte Cloud-anslutning, står servern som Blockerad under Servrar och får inga uppgifter förrän den byts till direkt anslutning eller licensen uppgraderas (Servrar utanför ert nätverk).

Flera servrar på en gång

Kör raden på varje server, till exempel med Ansible eller ett annat verktyg för konfigurationshantering. Den kräver ingen fil och inget svar under tiden.

Servern dyker upp

En server som ansluter med koden är godkänd och står under Servrar. sslbrain letar själv efter Nginx och Apache på servern och visar det den hittar under Tjänster.

En server som ser ut som en ominstallation av en server som redan är ansluten väntar i stället under Servrar som väntar på godkännande på Installera serviceagent.

Jämför Agentnyckel med nyckeln som agenten har skrivit i sin logg på servern (Loggfiler).
Klicka på Godkänn.

Nästa steg

Visa att domänen är er, så att sslbrain kan få certifikat för den: Visa att domänen är er.

Om det inte fungerar

agent.sh skriver “specify —code or —server”: raden saknar koden. Kopiera den igen från Installera serviceagent.
agent.sh skriver “does not match its checksum”: paketet byttes ut medan det hämtades. Kör raden igen.
agent.sh skriver “no verified Linux agent package”: appliancen har ännu inte hämtat agenten från sslbrain Cloud. Den hämtar den varje natt kl. 03:15. Försök igen senare; raden via sslbrain Cloud kräver samma paket.
curl skriver “SSL certificate problem”: servern litar inte på appliancens certifikat. Ge appliancen det gratis namnet (Gratis namn).
install.sh skriver “this package has no protocol core”: servern är varken x86_64 eller arm64.
Ett verktyg saknas: agenten kräver bash 4.4 eller senare, openssl, tar, curl eller wget, flock, timeout, base64, find, od och sed.
Servern har inte systemd: lägg till --mode cron på raden.
Servern står som Blockerad: den är ansluten via sslbrain Cloud och licensen omfattar inte det. Öppna servern och klicka på Byt till direkt (Servrar utanför ert nätverk).
Servern dyker inte upp: läs agentens logg (Loggfiler) och kontrollera att servern når appliancen (Agenten hör inte av sig).
Certifikatet installeras inte: Installationen misslyckas.

Loggfiler

Agenten skriver till journalen:

systemctl status sslbrain-agent.service
journalctl -u sslbrain-agent.service -n 50 --no-pager

Med --mode cron står loggen i /var/lib/sslbrain/state/agent.log.

Val för agent.sh och install.sh

agent.sh skickar sina val vidare till install.sh i paketet.

Val	Betydelse
`--code <kod>`	Installationskoden från Installera serviceagent. Med `--server` ansluter agenten direkt och har sslbrain Cloud som failover. Utan går den via sslbrain Cloud
`--server <adress>`	Appliancens adress. Utan `--code` väntar servern tills en administratör godkänner den. Används bara vid första kontakten, därefter styr appliancen adresserna
`--cloud-deny`	Agenten kontaktar aldrig sslbrain Cloud, oavsett vad appliancen skickar
`--profile deploy`	Kör som root, installerar certifikat och läser in tjänster på nytt. Standard
`--profile scoped`	Skriver bara i de certifikatmappar ni ger åtkomst till och läser in tjänsten på nytt via en hook som root äger. Kräver lokal konfiguration
`--profile inventory`	Hittar och övervakar certifikat men installerar inga
`--mode systemd\|timer\|cron`	Hur agenten körs. Standard är `systemd`
`--code-file <fil>`	Läs koden från en fil, eller `-` för standard input, i stället för `--code`

En av --code och --server krävs. Körs installationen igen utan --profile behåller agenten sin profil. Agenten ligger i /usr/local/lib/sslbrain/sslbrain-agent, inställningarna i /etc/sslbrain/agent.conf och tillståndet i /var/lib/sslbrain/state.