Standardmäßig wird der WSDL-Server per HTTP ohne Zertifikat betrieben. In diesem Kapitel ist beschrieben wie der Betrieb per HTTPS und die Erstellung eines Zertifikats entweder per existierenden oder oder selbstsignierten (neuen) SSL-Zertifikat erfolgt.
Bei Verwendung von HTTPS ist die Authentifizierung per konfigurierbaren Benutzer erforderlich, diese wird auch beschrieben.
Hinweise
In diesem Beispiel wird ein selbst signiertes SSL-Zertifikat mit privatem Schlüssel für einen Server mit Namen "DATENBANKSERVER" erstellt.
Beachten Sie, dass bei mehreren Schritten die jeweiligen Parameter an Ihren Servernamen angepasst werden müssen.
Zertifikate können in der Windows Managementkonsole angesehen und gewartet werden. Dazu gehen Sie wie folgt vor:
...
Anleitung
...
| Info | ||
|---|---|---|
| ||
New-SelfSignedCertificate -Subject "CN=<Computername>,DC=<Domäne>,O=<Organisation>,OU=<Organisationseinheit>" -DnsName "<Computername>.<Domäne>" -FriendlyName "AdvokatWSDL" -KeyUsage "DigitalSignature", "DataEncipherment", "KeyEncipherment" -CertStoreLocation "cert:\LocalMachine\My" -KeySpec "KeyExchange" -KeyExportPolicy "Exportable" -NotAfter (Get-Date).AddMonths(60) -HashAlgorithm "SHA256" |
Das Zertifikat wird im Zertifikatspeicher unter "Zertifikate (Lokaler Computer)/Eigene Zertifikate/Zertifikate" abgelegt.
| Info | ||
|---|---|---|
| ||
New-SelfSignedCertificate -Subject "CN=DATENBANKSERVER,DC=test.local,O=Max Mustermann GmbH,OU=IT Abteilung" -DnsName "DATENBANKSERVER.test.local" -FriendlyName "AdvokatWSDL" -KeyUsage "DigitalSignature", "DataEncipherment", "KeyEncipherment" -CertStoreLocation "cert:\LocalMachine\My" -KeySpec "KeyExchange" -KeyExportPolicy "Exportable" -NotAfter (Get-Date).AddMonths(60) -HashAlgorithm "SHA256" |
...
Führen Sie folgende zwei Befehle im Windows PowerShell aus um den Schlüssel für das Signieren (PrivateKey) und das Zertifikat zur Installation (PublicKey) zu erzeugen.
| Info | ||
|---|---|---|
| ||
|
Das Kennwort ist frei wählbar und sollte möglichst komplex sein. Stellen Sie sicher, dass das Kennwort sicher verwahrt wird.
Den Fingerprint finden Sie in der Managementkonsole (siehe Absatz Hinweise) beim zuvor erstellten Zertifikat. Dieses per Doppelklick öffnen und im Reiter "Details" beim Feld "Fingerabdruck" nachsehen.
| Info | ||
|---|---|---|
| ||
|
Führen Sie folgenden Befehl im Windows PowerShell aus um das SSL-Zertifikat zusätzlich als Zertifikat unter "Vertrauenswürdige Stammzertifizierungsstellen" zu speichern.
Dieser Schritt ist erforderlich, damit die Vertrauensstellung aktiviert wird und das SSL-Zertifikat als vertrauenswürdig eingestuft wird.
| Info | ||
|---|---|---|
| ||
Import-Certificate -CertStoreLocation 'Cert:\LocalMachine\Root' -FilePath "<Dateipfad>" |
Der Dateipfad entspricht jenem Pfad, welcher unter Schritt 2 beim Export des Zertifikats (PublicKey) verwendet wurde. Den Fingerprint ermitteln Sie wie unter Schritt 2 beschrieben.
| Info | ||
|---|---|---|
| ||
Import-Certificate -CertStoreLocation 'Cert:\LocalMachine\Root' -FilePath "C:\Certificate.cer" |
...
Führen Sie folgende zwei Befehle im Windows PowerShell aus um die URL inklusive Port des WSDL-Server zu reservieren.
Dabei handelt es sich um einen sogenannten URL-Reservierungseintrag (Uniform Resource Locator). Mehr Informationen finden Sie in diesem Microsoft Artikel.
| Info | ||
|---|---|---|
| ||
|
Anmerkung: Handelt es sich um ein englischsprachiges Betriebssystem, so muss der Text "Jeder" durch "Everyone" ersetzt werden.
...
Führen Sie folgenden Befehl im Windows Befehlszeilenkommando (CMD) aus um jenes unter Schritt 1 erstellte SSL-Zertifikat an den URL-Reservierungseintrag zu binden.
| Info | ||
|---|---|---|
| ||
|
Den Fingerprint finden Sie in der Managementkonsole (siehe Absatz Hinweise) beim zuvor erstellten Zertifikat. Dieses per Doppelklick öffnen und im Reiter "Details" beim Feld "Fingerabdruck" nachsehen.
Die AppID kann bei Bedarf geändert werden, wir empfehlen die Verwendung der vorgeschlagenen AppID laut dieser Dokumentation.
| Info | ||
|---|---|---|
| ||
|
...
Im Feld "Parameter" ergänzen Sie den Parameter "-usehttps" wie im Beispiel ersichtlich.
...
...
Im Fenster "AdvoAll" markieren Sie den Listeneintrag "ADVOKAT_WSDL_Datenaustausch" und wählen Menüpunkt "Bearbeiten" > "Konfiguration bearbeiten."
Im Fenster "Xml-Einstellungen bearbeiten" muss die Konfiguration angepasst werden, diese sieht beispielsweise wie folgt aus:
| Info | ||
|---|---|---|
| ||
<WSDLServerConfig SB="ADM" SERVERURL="http://datenbankserver:3000/AdvWSDLServer" LOGLEVEL="2" WSDL="False" DEBUGINFO="True" UseHttps="False"/> |
...
- Beim vorhandenen Parameter "SERVERURL" ist das Protokoll von http auf https zu ändern.
- Beim vorhandenen Parameter "UseHttps" ist der Wert von False auf True zu ändern.
In einer neuen Zeile beginnend mit <User.../> sind die Parameter "Name" und "Password" zu ergänzen.
- Der Name entspricht dem Benutzer laut vorhandenen Feld "SB" und Kennwort jenem laut Schritt 9.
In der Zeile <WSDLServerConfig.../> ist der Slash am Ende zu entfernen, sodass die Zeile <WSDLServerConfig...> lautet.
In einer neuen Zeile wird </WSDLServerConfig> eingefügt.
Info title Beispiel (nachher) <WSDLServerConfig SB="ADM" SERVERURL="https://datenbankserver:3000/AdvWSDLServer" LOGLEVEL="2" WSDL="False" DEBUGINFO="True" UseHttps="True">
<User Name="ADM" Password="DLxmEfVUC9CAmjiNyVphWw=="/>
</WSDLServerConfig>
...
| ← Zurück zu 10. ADVOKAT WSDL-Server | |
Weitere Seiten in diesem Bereich
|