Brug Windows-certifikatlageret til Devolutions Gateway
Det er muligt at bruge Windows-certifikatlageret som kilde til TLS-certifikatet. I stedet for en fil kan De gemme og administrere certifikaterne med Windows. I skrivende stund er denne funktion ikke tilgængelig i konfigurationskonsollens brugergrænseflade til Devolutions Gateway. For at konfigurere skal De enten redigere filen gateway.json direkte eller bruge modulet Devolutions.PowerShell.
Med den nye funktion er der nogle yderligere parametre til at konfigurere kilden til certifikatet.
TlsCertificateSource (string): Kilde til TLS-certifikatet. Mulige værdier er vist nedenfor.
External (standard): Hent et certifikat, der er gemt i filsystemet. Se indstillingerne
TlsCertificateFile,TlsPrivateKeyFileogTlsPrivateKeyPassword.System: Hent certifikatet, der administreres af systemets certifikatlager. Se indstillingerne
TlsCertificateSubjectName,TlsCertificateStoreNameogTlsCertificateStoreLocation.
TlsCertificateSubjectName (string): Emnenavn på certifikatet til TLS, når kilden System bruges.
TlsCertificateStoreName (string): Navn på det systemcertifikatlager, der skal bruges til TLS (standard er My).
TlsCertificateStoreLocation (string): Placering af det systemcertifikatlager, der skal bruges til TLS. Mulige værdier er vist nedenfor.
CurrentUser (standard)
CurrentService
LocalMachine
Import af certifikatet til Windows-certifikatlageret
Importér først certifikatet til Windows-certifikatlageret. Windows understøtter følgende certifikatformater:
X.509-certifikat - *.cer, *.crt
Personal Information Exchange - *.pfx, *.p12
Microsoft Serialized certificate Store - *.sst
PKCS #7-certifikater - *.spc, *.p7b
Konvertering af et X.509-certifikat
Devolutions Gateway kræver en privat nøgle sammen med TLS-certifikatet, og De kan derfor få brug for at kombinere den offentlige nøgle med dens private nøgle. Her er to metoder: Remote Desktop Manager og det indbyggede Windows-værktøj certutil.
Brug af Remote Desktop Manager
Posten X.509-certifikat kan bruges til at importere certifikatet og eksportere det i flere forskellige formater, herunder PFX.
I Remote Desktop Manager skal De klikke på Ny post – Administration af legitimationsoplysninger – Generelt – X.509-certifikat.
Vælg certifikatet, og klik på Åbn.
Klik på Næste.
Klik på ellipsen, og vælg den private nøgle.
Klik på Åbn.
Klik på Afslut.
Udfyld oplysningerne, og klik derefter på Tilføj.
Vælg posten, og klik på Gem certifikat som (findes også i genvejsmenuen ved højreklik).
Vælg Personlig informationsudveksling (pfx) i feltet Eksportformat.
Vælg, hvor filen skal gemmes, ved at klikke på ellipsen.
Angiv en stærk adgangskode, og klik derefter på Eksportér.
Brug af Windows-værktøjet certutil
Brug det indbyggede Windows-værktøj certutil til at kombinere en certifikatfil (.crt eller .cer) og dens private nøgle (.key). Begge filer skal have samme navn. certutil -MergePFX file.crt file.pfx
Import af certifikatet
Når De har certifikatet og filen med den private nøgle, skal De importere det i Windows.
Installér certifikatet:
Hvis Windows automatisk registrerer certifikatet, skal De dobbeltklikke på det og vælge Installer certifikat..., eller
Åbn
certmgr.msctil den tilsigtede lagerplacering (LocalMachineellerCurrentUser), højreklik på den ønskede placering (f.eks. Personlige/Certifikater), og vælg Alle opgaver – Importér.
Vælg en af følgende indstillinger, og klik på Næste:
Vælg automatisk certifikatlageret ud fra certifikattypen, eller
Placer alle certifikater i følgende lager, og klik på Gennemse... for at vælge en mappe.
Fuldfør importen ved at klikke på Afslut.
Giv tjenesten Devolutions Gateway læsetilladelse til certifikatets private nøgle
Som standard kører Devolutions Gateway sin tjeneste med kontoen Network Service. For at bruge et certifikat fra det lokale certifikatlager skal De sikre, at kontoen Network Service har læsetilladelser til certifikatets private nøgle.
Åbn det lokale certifikatlager, og gå til certifikatet.
Højreklik på certifikatet, og vælg Alle opgaver – Administrer private nøgler.
Klik for at tilføje et brugernavn.
Skriv "NETWORK SERVICE" i feltet objektnavne, og klik derefter på OK.
Vælg det nye brugernavn NETWORK SERVICE, og giv det tilladelsen Læs.
Klik på Anvend, og klik derefter på OK.
Konfiguration af Windows-certifikatlageret via gateway.json
Standardplaceringen for filen gateway.json er mappen %ProgramData%\Devolutions\Gateway.
Kontrollér, at filen er gyldig .json, ved at teste den med:
Dette virker med PowerShell 5.1 og nyere versioner (den anbefalede version er PowerShell 7.x).
En typisk konfiguration er vist nedenfor. Deres værdier kan afvige, især emnenavnet, fordi det afspejler det domænenavn, Devolutions Gateway svarer på. De vigtige værdier, der skal ændres, er:
TlsCertificateSource-SystemTlsCertificateSubjectName-gateway.ad.it-help.ninjaTlsCertificateStoreName-MyTlsCertificateStoreLocation-LocalMachine
Et eksempel på hele konfigurationsfilen:
Kør scriptet ovenfor.
Åbn
services.msc.Højreklik på Devolutions Gateway Service, og vælg Genstart.
Kontrollér, at Devolutions Gateway kører korrekt, ved at gå til
https://{FQDN}:7171/jet/health(erstat{FQDN}med DNS-adressen for Deres gateway) i en webbrowser.
Konfiguration af Windows-certifikatlageret via PowerShell
Devolutions Gateway kan også konfigureres med PowerShell-kommandoer. PowerShell-modulet til Devolutions Gateway viser mange kommandoer til at konfigurere den. En installation af Devolutions Gateway indeholder som standard modulet i installationsmappen. Importér modulet på følgende måde:
En anden måde at gøre modulet let tilgængeligt på er at installere det på følgende måde:
Når det er importeret, kan De se den aktuelle konfiguration med følgende kommando:
Brug følgende kommando for at få Devolutions Gateway til at bruge Windows-certifikatlageret:
Genstart tjenesten, for at konfigurationen træder i kraft.
Kontrollér, at Devolutions Gateway kører korrekt, ved at gå til https://{FQDN}:7171/jet/health i en webbrowser.
Sidst opdateret
Var dette nyttigt?