DigiCert återkallar tre ECC-mellancertifikat från RapidSSL, Thawte och GeoTrust onsdag 2026-11-18 kl. 19:00. Certifikat utfärdade från dem ska utfärdas på nytt innan dess.Läs mer →
Svensk support på svenska, vardagar 10:00-16:00 +46 10 101 03 34 info@fairssl.se

SSL-certifikat på NetScaler / Citrix ADC via ACME

NetScaler kan inte själv hämta ACME-certifikat. simple-acme på en Windows-server hämtar certifikatet och för över det via NITRO API.

Så fungerar det

  1. Förbered Windows-servern Packa upp FairSSL-versionen av simple-acme till C:\simple-acme.
  2. Skapa NITRO-användare och AutoDNS Skapa en automationsanvändare på NetScaler, spara dess lösenord i simple-acmes vault och skapa CNAME-vidarebefordran till FairSSL AutoDNS.
  3. Utfärda och installera Kör wacs.exe med EAB-nycklarna. Install-NetScalerCert.ps1 för över certifikatet via NITRO API och binder det till vald SSL vServer.
  4. Kontrollera Under Traffic Management, SSL, Certificates i NetScalers webbgränssnitt ska det nya certifikatet vara uppladdat och i bruk.

← Alla guider

NetScaler kan inte själv hämta ACME-certifikat. I stället kör en Windows-server simple-acme och ett färdigt PowerShell-skript som överför certifikatet via NITRO API. Hela flödet, inklusive förnyelser, körs utan manuella steg.

Versioner som stöds

NetScaler ADCVersionerGuiden sätter ingen versionsgränsKörs påWindows Server 2012 eller senareACME-klientsimple-acme 2.4.0+ (FairSSL-utgåvan, .NET 10 ingår) + NITRO API

Så är lösningen uppbyggd

  • ✓ En Windows Server (gärna en befintlig administrationsserver) kör simple-acme.
  • ✓ simple-acme hämtar certifikatet från FairSSL via AutoDNS-validering. Inga API-nycklar till DNS-leverantören behövs.
  • ✓ Install-NetScalerCert.ps1 körs som installationsskript och överför certifikatet till NetScaler via NITRO REST API över HTTPS.
  • ✓ Skriptet binder certifikatet till en eller flera SSL vServrar (eller global VPN-bindning) och sparar konfigurationen.
  • ✓ Den dagliga schemalagda aktiviteten från simple-acme förnyar certifikatet automatiskt när ARI, eller den inbyggda reserven sju dagar före utgång, utlöser en förnyelse.

Konfiguration

Steg 1: Installera simple-acme

Hämta FairSSL-utgåvan av simple-acme (förkonfigurerad med ACME-adress och förnyelseinställningar, med Install-NetScalerCert.ps1 i mappen Scripts). Packa upp den till C:\simple-acme. Använder du i stället klienten från simple-acme.com konfigurerar du själv ACME-adress och förnyelseinställningar och kopierar Install-NetScalerCert.ps1 från FairSSL-versionens Scripts-mapp till Scripts-mappen i din simple-acme/win-acme-installation.

Steg 2: Spara NetScaler-lösenordet

Skriptet loggar in på NetScaler med ett konto som måste få använda NITRO API för att ladda upp SSL-filer, skapa eller uppdatera SSL cert-key-par, binda certifikat och spara konfigurationen. Använd en dedikerad automationsanvändare om du har en. Kör kommandot från C:\simple-acme som administratör och ersätt YOUR_PASSWORD med kontots lösenord. simple-acme sparar det krypterat på servern. Lösenordet får inte innehålla en apostrof (') eller ett citattecken (").

# PowerShell, Run as Administrator

.\wacs.exe `
--baseuri "https://fairssl.dk/acme" `
--vaultstore `
--vaultkey vault://json/netscaler `
--vaultsecret 'YOUR_PASSWORD'

Steg 3: Konfigurera AutoDNS

Skapa via din FairSSL-kontrollpanel en CNAME-post för _dnsauth.<din-domän> som pekar på FairSSLs DNS-server. Det görs en gång. Se den fullständiga AutoDNS-guiden.

Steg 4: Utfärda och installera

Kör kommandot från C:\simple-acme som administratör med dina egna värden i stället för DIN_EAB_KID, DIN_EAB_HMAC, ns.exempel.se, YOUR_NS_HOST, YOUR_ADC_CERTKEY_NAME och YOUR_VSERVER_NAME, och ändra nsadmin till NetScaler-kontot från steg 2. Om du förnyar ett certifikat som redan är bundet ska du ange det befintliga cert-key-namnet i -certName. -nsHost kan vara hostname, IP-adress eller fullständig URL med port.

.\wacs.exe `
--verbose `
--baseuri "https://fairssl.dk/acme" `
--eab-key-identifier DIN_EAB_KID `
--eab-key DIN_EAB_HMAC `
--accepttos `
--source manual `
--host "ns.exempel.se" `
--validation none `
--store pemfiles `
--pemfilespath "C:\simple-acme\Certificates" `
--pemfilesname "ns-exempel-se" `
--installation script `
--script ".\Scripts\Install-NetScalerCert.ps1" `
--scriptparameters "-StorePath 'C:\simple-acme\Certificates' -FilePrefix 'ns-exempel-se' -nsHost 'YOUR_NS_HOST' -certName 'YOUR_ADC_CERTKEY_NAME' -vServerName 'YOUR_VSERVER_NAME' -UserName 'nsadmin' -Password '{vault://json/netscaler}'" `
--friendlyname "fairssl-ns-cert"

Lösenord i klartext i stället för steg 2: ersätt {vault://json/netscaler} med lösenordet. simple-acme sparar det då i sina förnyelseinställningar och sin logg på servern, och ett $ eller ` i det måste ha ett ` framför. Det får inte heller innehålla ' eller ".

Standard är -DeploymentMode Auto, som väljer SSL cert-key bundle på versioner som stöder det och klassisk cert-key annars. Använd -DeploymentMode Classic om enheten kräver den äldre metoden.

Steg 5: Vanliga varianter

  • Flera vServrar: använd -vServerName 'VS1,VS2'
  • SNI-bindningar: lägg till -SniCert
  • Citrix Gateway / global VPN: ta bort -vServerName och lägg till -BindGlobalVpn
  • Betrott managementcertifikat: lägg till -ValidateManagementCertificate
  • NITRO över HTTP: lägg till -UseHttp, men bara på ett isolerat managementnätverk, eftersom inloggningsuppgifterna och den privata nyckeln skickas okrypterat.

Install-NetScalerCert.ps1 visar ett kommando som kör skriptet igen utan att beställa ett nytt certifikat. Behöver NetScaler-delen justeras ändrar du parametrarna i det kommandot och kör det. När det fungerar lägger du in de ändrade parametrarna i --scriptparameters i kommandot från steg 4 och kör det igen, så att förnyelser använder dem.

Steg 6: Verifiera

I NetScalers webbgränssnitt kontrollerar du under Traffic Management > SSL > Certificates att det nya certifikatet är uppladdat och att den valda SSL vServern eller VPN-bindningen använder det. Är tjänsten publik testar du värdnamnet med FairSSLs SSL-skanner.

Mer om vad skriptet gör står överst i skriptet. Visa det med det här kommandot från C:\simple-acme:

powershell -NoProfile -ExecutionPolicy Bypass -Command "Get-Help .\Scripts\Install-NetScalerCert.ps1 -Full"

Vad simple-acme rapporterar till FairSSL efter varje körning, och hur du stänger av det, står i C:\simple-acme\fairssl-readme.txt.

Felsökning

Skriptet når inte NetScalers managementgränssnitt

Windows-servern måste nå NetScalers managementadress på TCP/443 (eller TCP/80 om -UseHttp är satt, vilket inte rekommenderas). Kontrollera brandväggsreglerna, att managementadressen är tillgänglig över HTTPS och att kontot kan logga in på NITRO API.

NITRO returnerar 401 Unauthorized

Användarnamnet i -UserName eller lösenordet från steg 2 stämmer inte, eller kontot har inte tillräckliga behörigheter. Har lösenordet ändrats på NetScaler kör du steg 2 igen med det nya. NetScaler-användaren ska kunna läsa versionen och befintlig cert-key, ladda upp systemfiler, skapa och uppdatera SSL cert-key eller SSL cert-key bundle, binda certifikat till SSL vServer eller global VPN och spara konfigurationen. Tilldela användaren en command policy som omfattar de här NITRO-anropen.

Certifikatet laddas upp men binds inte

Kontrollera att -vServerName matchar det exakta namnet på SSL vServern. Kom ihåg -SniCert om du använder SNI. För global VPN-bindning används -BindGlobalVpn i stället för -vServerName.

SSL-certifikat på många servrar och appliances

Ett offentligt SSL-certifikat får vara giltigt i högst 199 dagar nu, 99 dagar senast 2027-03-15 och 46 dagar senast 2029-03-15. Varje certifikat måste då bytas minst två gånger om året nu och minst åtta gånger om året från 2029, på varje server, brandvägg och lastbalanserare där det används. sslbrain från FairSSL körs som en appliance i ert eget nätverk och förnyar och installerar certifikaten från ett ställe, även på utrustning utan agent.

Så förnyar och installerar sslbrain certifikat på NetScaler(öppnar sslbrain.com i en ny flik)

Vanliga frågor

Hitta svar på de vanligaste frågorna om SSL-certifikat och FairSSL.

I den här lösningen hämtar ADC-enheten inte själv certifikatet. En Windows-server hämtar det med simple-acme och överför det till NetScaler via NITRO API. Samma mönster används för F5 BIG-IP, FortiGate (äldre versioner), KEMP och andra enheter. Har du NetScaler Console med ACME eller Zero Touch är det en separat modell som guiden inte täcker.
Båda. Install-NetScalerCert.ps1 har ett Auto-läge som frågar enheten om versionen och väljer SSL cert-key bundle när ADC-versionen stöder det och det inte redan finns en klassisk cert-key med samma namn. Äldre enheter och global VPN-bindning använder klassisk SSL cert-key eftersom bundles bara kan bindas till SSL vServrar. Använd -DeploymentMode Classic om du vill tvinga den äldre metoden.
Nej. Windows-servern som kör simple-acme behöver bara nå NetScalers managementadress över HTTPS. Ingen publik åtkomst krävs. FairSSL AutoDNS sköter all ACME-validering, så NetScaler behöver varken exponera port 80 eller ha åtkomst till ett DNS-API.
Skriptet accepterar som standard självsignerade managementcertifikat, eftersom det är vanligast. Lägg till -ValidateManagementCertificate i parametrarna om Windows-servern litar på NetScalers managementcertifikat och du vill ha fullständig TLS-validering.
Ja. Använd -vServerName "VS1,VS2,VS3" i skriptets parametrar. Skriptet binder samma certifikat till alla angivna vServrar och sparar sedan konfigurationen.
Ta bort -vServerName och lägg till -BindGlobalVpn. Global VPN-bindning använder alltid klassisk SSL cert-key (inte bundles), så skriptet väljer automatiskt rätt format.
simple-acme skapar automatiskt en daglig schemalagd aktivitet. När ARI, eller den inbyggda reserven sju dagar före utgång, utlöser en förnyelse hämtas ett nytt certifikat, Install-NetScalerCert.ps1 körs igen och certifikatet på NetScaler byts ut utan manuella steg.

Redo att automatisera NetScaler-certifikat?

Skapa ett gratis konto och beställ ditt första certifikat. Ett DV-certifikat utfärdas på under 2 minuter.