{"type":"doc","content":[{"type":"paragraph","content":[{"text":"In diesem Beispiel wird ein selbst signiertes SSL-Zertifikat mit privatem Schlüssel für einen Server mit Namen \"DATENBANKSERVER\" erstellt.","type":"text"},{"type":"hardBreak"},{"text":"Beachten Sie, dass bei mehreren Schritten die jeweiligen Parameter an Ihren Servernamen angepasst werden müssen.","type":"text"}]},{"type":"paragraph","content":[{"text":"Zertifikate können in der Windows Managementkonsole angesehen und gewartet werden. Dazu gehen Sie wie folgt vor:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Start -> Ausführen -> \"mmc\" aufrufen, die Managementkonsole startet. Menüpunkt \"Datei\" > \"Snap-In hinzufügen / entfernen\" auswählen.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In der linken Spalte wählen Sie den Eintrag \"Zertifikate\" aus und klicken auf Hinzufügen, anschließend auf OK. ","type":"text"},{"type":"hardBreak"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Erscheint das Fenster \"Zertifikat Snap-In\" so wählen Sie den Eintrag \"Computerkonto\" > \"Weiter\" > \"Lokalen Computer (Computer, auf dem diese Konsole ausgeführt wird)\".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":801,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":801,"alt":"Screenshot_Zertifikate.png","id":"be2a652f-532a-4c4e-aebc-8482b8fad1ba","collection":"contentId-45194621","type":"file","height":296}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In der Managementkonsole (MMC) in der linken Spalte \"Konsolenstamm\" beim Eintrag \"Zertifikate (Lokaler Computer) zu \"Eigene Zertifikate\"> \"Zertifikate\" navigieren.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Anleitung","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Verbinden Sie sich per Remotedesktop mit dem AdvoAll-Benutzerkonto auf jenes Gerät wo die AdvoAll-Anwendung \"ADVOKAT_WSDL_Datenaustausch\" im Einsatz ist.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Starten Sie Windows PowerShell mit administrativen Rechten. Erstellen Sie ein selbst signiertes SSL-Zertifikat durch Verwendung folgenden Befehls: ","type":"text"}]},{"type":"codeBlock","attrs":{"language":"powershell"},"content":[{"text":"New-SelfSignedCertificate -Subject \"CN=,DC=,O=,OU=\" -DnsName \".\",\"\",\"IPv4-Adresse\" -FriendlyName \"AdvokatWSDL\" -KeyUsage \"DigitalSignature\", \"DataEncipherment\", \"KeyEncipherment\" -CertStoreLocation \"cert:\\LocalMachine\\My\" -KeySpec \"KeyExchange\" -KeyExportPolicy \"Exportable\" -NotAfter (Get-Date).AddMonths(60) -HashAlgorithm \"SHA256\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Das Zertifikat wird im Zertifikatspeicher unter \"Zertifikate (Lokaler Computer)/Eigene Zertifikate/Zertifikate\" abgelegt.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Beispiel","type":"text"}]},{"type":"codeBlock","attrs":{"language":"powershell"},"content":[{"text":"New-SelfSignedCertificate -Subject \"CN=DATENBANKSERVER,DC=test.local,O=Max Mustermann GmbH,OU=IT Abteilung\" -DnsName \"DATENBANKSERVER.test.local\",\"DATENBANKSERVER\",\"192.168.0.1\" -FriendlyName \"AdvokatWSDL\" -KeyUsage \"DigitalSignature\", \"DataEncipherment\", \"KeyEncipherment\" -CertStoreLocation \"cert:\\LocalMachine\\My\" -KeySpec \"KeyExchange\" -KeyExportPolicy \"Exportable\" -NotAfter (Get-Date).AddMonths(60) -HashAlgorithm \"SHA256\"","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"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.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"codeBlock","attrs":{"language":"powershell"},"content":[{"text":"$CertPassword = ConvertTo-SecureString -String \"\" -Force -AsPlainText\nExport-PfxCertificate -Cert cert:\\LocalMachine\\My\\ -FilePath \"C:\\PrivateKey.pfx\" -Password $CertPassword\nExport-Certificate -Cert Cert:\\LocalMachine\\My\\ -FilePath C:\\Certificate.cer","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Das Kennwort ist frei wählbar und sollte möglichst komplex sein. Stellen Sie sicher, dass das Kennwort sicher verwahrt wird.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"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.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Beispiel","type":"text"}]},{"type":"codeBlock","attrs":{"language":"powershell"},"content":[{"text":"$CertPassword = ConvertTo-SecureString -String \"\" -Force -AsPlainText\nExport-PfxCertificate -Cert cert:\\LocalMachine\\My\\f3fee11c9b81b6c6032bf4f411fee93c38398ce1 -FilePath \"C:\\PrivateKey.pfx\" -Password $CertPassword\nExport-Certificate -Cert Cert:\\LocalMachine\\My\\f3fee11c9b81b6c6032bf4f411fee93c38398ce1 -FilePath C:\\Certificate.cer","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Führen Sie folgenden Befehl im Windows PowerShell aus um das SSL-Zertifikat zusätzlich als Zertifikat unter \"Vertrauenswürdige Stammzertifizierungsstellen\" zu speichern.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"codeBlock","attrs":{"language":"powershell"},"content":[{"text":"Import-Certificate -CertStoreLocation 'Cert:\\LocalMachine\\Root' -FilePath \"\"\n(Get-ChildItem -Path Cert:\\LocalMachine\\Root\\).FriendlyName = \"AdvokatWSDL\"","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Dieser Schritt ist erforderlich, damit die Vertrauensstellung aktiviert wird und das SSL-Zertifikat als vertrauenswürdig eingestuft wird.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"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.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Beispiel","type":"text"}]},{"type":"codeBlock","attrs":{"language":"powershell"},"content":[{"text":"Import-Certificate -CertStoreLocation 'Cert:\\LocalMachine\\Root' -FilePath \"C:\\Certificate.cer\"\n(Get-ChildItem -Path Cert:\\LocalMachine\\Root\\f3fee11c9b81b6c6032bf4f411fee93c38398ce1).FriendlyName = \"AdvokatWSDL\"","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Führen Sie folgenden Befehl im Windows PowerShell aus um die URL inklusive Port des WSDL-Server zu reservieren.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"codeBlock","attrs":{"language":"powershell"},"content":[{"text":"netsh http add urlacl url=https://+:3000/ user=\\Jeder","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Dabei handelt es sich um einen sogenannten URL-Reservierungseintrag (Uniform Resource Locator). Mehr Informationen finden Sie in diesem Microsoft ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"Artikel","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"link","attrs":{"href":"https://docs.microsoft.com/de-DE/windows-server/networking/technologies/netsh/netsh-http#add-urlacl"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Anmerkung: Handelt es sich um ein englischsprachiges Betriebssystem, so muss der Text \"Jeder\" durch \"Everyone\" ersetzt werden.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Führen Sie folgenden Befehl im Windows Befehlszeilenkommando (CMD) aus um jenes unter Schritt 1 erstellte SSL-Zertifikat an den URL-Reservierungseintrag zu binden.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"codeBlock","attrs":{"language":"powershell"},"content":[{"text":"netsh http add sslcert ipport=0.0.0.0:3000 certhash= appid={9FC7BC9D-6697-4880-BE8B-23BC848272E0}","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"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.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Die AppID kann bei Bedarf geändert werden, wir empfehlen die Verwendung der vorgeschlagenen AppID laut dieser Dokumentation.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Beispiel","type":"text"}]},{"type":"codeBlock","attrs":{"language":"powershell"},"content":[{"text":"netsh http add sslcert ipport=0.0.0.0:3000 certhash=f3fee11c9b81b6c6032bf4f411fee93c38398ce1 appid={9FC7BC9D-6697-4880-BE8B-23BC848272E0}","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Navigieren Sie zu \"","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"C:\\Program Files (x86)\\Advokat","type":"text","marks":[{"type":"em"}]},{"text":"\" und starten Sie \"","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"AdvoAll.exe","type":"text","marks":[{"type":"em"}]},{"text":"\".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Beenden Sie die AdvoAll Anwendung indem Sie diese markieren und Rechtsklick \"Beenden\" auswählen.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Verwenden Sie die Funktion \"Beenden erzwingen\" nur, wenn nach Nutzung von \"Beenden\" und einer Wartezeit von 5 Minuten nichts passiert ist.","type":"text"},{"type":"hardBreak"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Im Fenster \"AdvoAll\" markieren Sie den Listeneintrag \"ADVOKAT_WSDL_Datenaustausch\" und wählen Menüpunkt \"Bearbeiten\" > \"Ändern\".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Im Feld \"Parameter\" ergänzen Sie den Parameter \"-usehttps\" wie im Beispiel ersichtlich.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Beispiel (vorher)","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"-advoall -ini:\"S:\\ADVOKAT\\Daten\\Advokat.ini\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Beispiel (nachher)","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"-advoall -usehttps -ini:\"S:\\ADVOKAT\\Daten\\Advokat.ini\"","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Im Fenster \"AdvoAll\" markieren Sie den Listeneintrag \"ADVOKAT_WSDL_Datenaustausch\" und wählen Menüpunkt \"Bearbeiten\" > \"Konfiguration bearbeiten.\"","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Im Fenster \"Xml-Einstellungen bearbeiten\" muss die Konfiguration angepasst werden, das erfolgt per Schritt 9 und 10.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Beispiel (vorher)","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":" ","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Kontaktieren Sie die ADVOKAT Individualprogrammierung per ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"Helpdesk","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"link","attrs":{"href":"https://advokat.atlassian.net/servicedesk/customer/portal/5/group/5/create/30"}}]},{"text":" (Ticketsystem) oder per E-Mail unter ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"service@advokat.at","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"link","attrs":{"href":"mailto:service@advokat.at"}}]},{"text":" um das Kennwort zwecks Authentifizierung verschlüsseln zu lassen.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Das Kennwort ist frei wählbar und sollte möglichst komplex sein. Stellen Sie sicher, dass das Kennwort sicher verwahrt wird. Es sollte sich vom Kennwort laut Schritt 1 unterscheiden.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In diesem Beispiel wird das Kennwort (Password) \"Test1234\" gewählt, welches verschlüsselt dem Wert \"DLxmEfVUC9CAmjiNyVphWw==\" entspricht.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Im Fenster \"Xml-Einstellungen bearbeiten\" laut Schritt 8 sind folgende Anpassungen wie im Beispiel ersichtlich vorzunehmen:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Beim vorhandenen Parameter \"SERVERURL\" ist das Protokoll von ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"http","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"em"}]},{"text":" auf ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"https","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"em"}]},{"text":" zu ändern.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Beim vorhandenen Parameter \"UseHttps\" ist der Wert von ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"False","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"em"}]},{"text":" auf ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"True","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"em"}]},{"text":" zu ändern.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In einer neuen Zeile beginnend mit sind die Parameter \"Name\" und \"Password\" zu ergänzen. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Der Name entspricht dem Benutzer laut vorhandenen Feld \"SB\" und Kennwort jenem laut Schritt 9.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In der Zeile ist der Slash am Ende zu entfernen, sodass die Zeile lautet.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In einer neuen Zeile wird eingefügt.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Beispiel (nachher)","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Stellen Sie sicher, dass das Zertifikat \"Certificate.cer\" (PublicKey) laut Schritt 2 auf allen Geräten eingerichtet ist, welche mit dem WSDL-Server kommunizieren.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Das Zertifikat kann manuell auf die Geräte übertragen und dann per Zertifikatsassistenten installiert oder alternativ per GPO oder Drittsoftware ausgeliefert werden.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Wie eine Zertifikatsinstallation oder eine Auslieferung per GPO/Drittsoftware erfolgt ist seitens ADVOKAT nicht beschrieben.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Starten Sie die AdvoAll Anwendung indem Sie diese markieren und Rechtsklick \"Starten\" auswählen.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]}]}],"version":1}

Browser nicht unterstützt