Der Web-Client verbindet sich mit dem REST-Dienst des Password Depot Enterprise Servers, standardmäßig über Port 8714. Dieser Port gilt ausschließlich für den Web-Client bzw. die REST-API – die nativen Anwendungen (Windows-, macOS-, Linux-, Android- und iOS-Clients) nutzen den Server-Port 25019 (TCP+UDP).
Port ändern (ab Version 19)
Ab Version 19 ändern Sie den REST-Port direkt im Server-Manager:
Öffnen Sie Verwalten → Servereinstellungen.
Wechseln Sie auf die Registerkarte Allgemein in den Bereich REST-Server.
Passen Sie das Feld Portnummer an und bestätigen Sie mit OK.
Geben Sie den neuen Port in der Firewall des Servers frei (und entfernen Sie die alte Freigabe).
Benutzer geben beim Anmelden im Web-Client den neuen Port an. Beim selbst gehosteten Web-Client 2.0 können Sie ihn über das Feld
defaultPortin derconfig.jsonvorbelegen.
Bis Version 18 erfolgte die Änderung über die Einstellungsdatei pdserver.ini: bei gestopptem Server-Dienst den Wert PortREST=8714 anpassen, speichern und den Dienst neu starten.
HTTPS und Zertifikat
Der REST-Dienst akzeptiert ausschließlich HTTPS; unverschlüsselte HTTP-Verbindungen werden nicht unterstützt. Ein gültiges SSL-Zertifikat ist seit Version 18 zwingend erforderlich:
Zertifikat einer anerkannten Zertifizierungsstelle (empfohlen): Clients verbinden sich ohne Zertifikatswarnung; der Common Name bzw. Subject Alternative Name muss zum Domainnamen oder zur IP-Adresse des Servers passen.
Selbstsigniertes Zertifikat: lässt sich mit dem Zertifikat-Assistenten im Server-Manager erstellen; die Endgeräte müssen dem Zertifikat dann explizit vertrauen.
Der Web-Client 2.0 baut Verbindungen zur API grundsätzlich über https:// auf; ein Herabstufen auf HTTP ist nicht möglich.
Funktionstest: Rufen Sie https://<IHR_SERVER>:8714/v2.0/databases ohne Anmeldung auf. Eine JSON-Antwort mit Fehlercode 401 bestätigt, dass der REST-Dienst läuft und erreichbar ist.
Hinweis: Das frühere Feld Ursprungs-URL im Bereich REST-Server wurde mit Version 19.1.0 entfernt. Cross-Origin-Zugriffe des Web-Clients beantwortet der Server seitdem automatisch; eine manuelle Eintragung ist nicht mehr nötig.
Verwandte Themen: