Simple-ACME (win-acme): komplett Windows-guide

Innan du startar simple-acme behöver du skapa EAB-uppgifter i FairSSL kontrollpanelen. EAB (External Account Binding) kopplar ACME-certifikat till ert FairSSL-konto, så alla certifikat, klienter och förnyelser är synliga och övervakade.

simple-acme.exe --register ^
  --baseuri https://fairssl.dk/acme/ ^
  --eab-key-identifier ERT_KEY_ID ^
  --eab-key ER_HMAC_KEY ^
  --eab-algorithm HS256 ^
  --emailaddress er@email.se ^
  --accepttos

För automatisering och CI/CD använder du CLI-argument istället för den interaktiva menyn. Nedan finns de vanligaste scenarierna.

IIS-site med FairSSL AutoDNS

Wildcard + apex-domän, validerat via DNS-01 med FairSSL AutoDNS. Inga DNS API-nycklar nödvändiga. --siteid 1 installerar certifikatet på IIS site 1 och binder det automatiskt till de värdnamn i siten som matchar certifikatets namn.

simple-acme.exe ^
  --baseuri https://fairssl.dk/acme/ ^
  --source manual ^
  --host "*.ditt-doman.se,ditt-doman.se" ^
  --validationmode dns-01 ^
  --validation acme-dns ^
  --csr ec ^
  --store certificatestore ^
  --installation iis ^
  --siteid 1 ^
  --accepttos

DNS-validering med egen DNS-leverantör och extra PEM + PFX (pluggable)

Om ni inte använder AutoDNS och istället har direkt API-åtkomst till er DNS-leverantör (kräver pluggable-versionen). Detta exempel validerar via Cloudflare API, sparar certifikatet i Windows Certificate Store, som PEM-filer och som PFX, och installerar på IIS site 1:

simple-acme.exe ^
  --baseuri https://fairssl.dk/acme/ ^
  --source manual ^
  --host www.ditt-doman.se,ditt-doman.se ^
  --validationmode dns-01 ^
  --validation cloudflare ^
  --cloudflareapitoken ER_CF_TOKEN ^
  --csr ec ^
  --store certificatestore,pemfiles,pfxfile ^
  --pemfilespath C:\certs\ditt-doman.se ^
  --pfxfilepath C:\certs\ditt-doman.se ^
  --pfxpassword LOSENORD ^
  --installation iis ^
  --siteid 1 ^
  --accepttos

Lagringsalternativ (store)

Simple-acme kan spara certifikat på flera sätt. Kombinera dem med komma i --store.

--store certificatestore

--store pemfiles ^
--pemfilespath C:\certs\

--store pfxfile ^
--pfxfilepath C:\certs\ ^
--pfxpassword LOSENORD

Kombinera lagringstyper: --store certificatestore,pemfiles sparar i Windows Certificate Store och exporterar PEM-filer samtidigt.

Post-förnyelse-script

Kör ett script efter att förnyelsen har genomförts, t.ex. för att aktivera certifikatet på nätverksutrustning eller starta om en tjänst:

simple-acme.exe ^
  --baseuri https://fairssl.dk/acme/ ^
  --source manual ^
  --host rdp.ditt-doman.se ^
  --validationmode dns-01 ^
  --validation acme-dns ^
  --csr ec ^
  --store pemfiles ^
  --pemfilespath C:\certs\rdp ^
  --installation script ^
  --script "C:\scripts\deploy-cert.ps1" ^
  --scriptparameters "'{CertThumbprint}' '{StoreType}'" ^
  --accepttos

Simple-acme stöder RSA och ECDSA-nycklar. Valet påverkar handshake-hastighet, bandbredd och framtidssäkerhet.

Simple-acmes standard är P-384 för EC, som vi rekommenderar. Om ni behöver ändra nyckeltyp kan det göras via settings.json:

{
  "CSR": {
    "EC": {
      "CurveName": "secp384r1"
    }
  }
}

Simple-acme skapar en Windows Task Scheduler-uppgift vid första certifikatet. Uppgiften körs dagligen och förnyar certifikat som närmar sig utgång.

Viktigt: Scheduled task och settings.json måste stämma överens. Körningstidpunkt, slumpmässig fördröjning och sökvägar måste matcha på båda ställena. Om ni ändrar inställningar på det ena stället måste det andra uppdateras. Avvikelser mellan de två är en av de vanligaste orsakerna till att förnyelse misslyckas i tysthet.

"ScheduledTask": {
  "StartBoundary": "05:00:00",
  "RandomDelay": "01:00:00"
}

Kort certifikatlivslängd (47 dagar från 2029)

Med 47-dagars certifikatlivslängd från mars 2029 måste förnyelse köras oftare och pålitligt. Simple-acme med ARI hanterar detta automatiskt. CA:n bestämmer det optimala förnyelsetillfället, och klienten följer det. Vi rekommenderar att testa er uppsättning noggrant nu, medan certifikat fortfarande har 200 dagars livslängd, så att ni är redo för de kortare livslängderna.