Agents

En agent i sslbrain er et sæt scripts, der automatiserer installationen af et certifikat på en given platform. Når sslbrain deployer et certifikat til en server, er det en agent der udfører selve arbejdet: importerer certifikatet, konfigurerer webserveren og genstarter services efter behov.

Indbyggede agenter

sslbrain leveres med agenter til de mest udbredte platforme. Alle indbyggede agenter vedligeholdes af FairSSL og testes mod hver nye version af sslbrain før udgivelse.

Community-agenter

Community-agenter er skrevet af brugere og delt med alle sslbrain-installationer. Hver community-agent er:

1. Indsendt af en bruger
2. Gennemgået af FairSSL for sikkerhed og kvalitet
3. Signeret med FairSSLs ECDSA P-384-nøgle
4. Gjort tilgængelig for alle sslbrain-installationer

Community-agenter understøtter platforme, der ikke findes blandt de indbyggede agenter, f.eks. Postfix, HAProxy, Tomcat, Synology eller specifikke cloud-tjenester.

Du finder community-agenter i sslbrain under Agents > Community. Installér dem med ét klik.

Del en community agent

Har du udviklet en agent, der kan gavne andre? Så kan du dele den med fællesskabet:

1. Åbn din brugerdefinerede agent i sslbrain
2. Klik Del med community
3. Agenten sendes til FairSSL til gennemgang

Når agenten er godkendt og signeret, bliver den tilgængelig for alle sslbrain-installationer via Agents > Community.

Brugerdefinerede agenter

Har du en platform der hverken er understøttet af de indbyggede eller community-agenter, kan du bygge din egen.

En brugerdefineret agent består af en YAML-definition og scripts i Bash, PowerShell eller Python. Se eksemplet nedenfor.

Agent YAML-format

En agent er defineret i en agent.yml-fil. Her ses et simpelt eksempel på kopiering af certifikat og nøgle til en server efterfulgt af genstart af en service:

name: my-custom-agent
description: Installerer certifikat for min applikation
platform: linux

steps:
  - name: Kopiér certifikat
    action: write_file
    path: /etc/myapp/tls/cert.pem
    content: "{{ certificate_pem }}"
    mode: "0644"

  - name: Kopiér privat nøgle
    action: write_file
    path: /etc/myapp/tls/key.pem
    content: "{{ private_key_pem }}"
    mode: "0600"

  - name: Genstart applikation
    action: run_command
    command: systemctl restart myapp

verify:
  - name: Tjek TLS-forbindelse
    action: tls_check
    host: localhost
    port: 443

Variabler som {{ certificate_pem }} og {{ private_key_pem }} erstattes automatisk af sslbrain under deployment.

Tilgængelige variabler

sslbrain injicerer variabler som miljøvariabler i agent-scripts. Hvilke certifikatvariabler der er tilgængelige afhænger af agentens konfigurerede format.

Standard

PEM-format

PFX-format

JKS-format

Derudover kan du definere egne variabler på global-, server-, endpoint- eller plan-niveau i sslbrain. De injiceres automatisk sammen med standardvariablerne.

Tilgængelige handlinger

Brugerdefinerede agenter uploades til sslbrain under Agents > Custom.

Kodesignering

Sikkerhed er altafgørende for agenter, da de eksekveres med administrative rettigheder på dine servere.

Alle agenter er signeret, uanset om de er indbyggede, community eller custom:

Egne agenter signeres med din installations lokale nøgle og kan kun køre på servere tilsluttet din sslbrain.