Bevor Sie das Setup zum Installieren der d.3one-Integrationen ausführen, müssen Sie die zentralen Apps installieren. In diesem Kapitel erfahren Sie, welche Aspekte Sie beim Installieren und Konfigurieren beachten müssen, um anschließend alle weiteren Vorbereitungen für d.3one im Kontext von d.3ecm zu treffen. Informationen zum Installieren der zentralen Apps finden Sie im d.velop software manager-Handbuch. Informationen zum Konfigurieren der Infrastrukturkomponenten finden Sie im Konfigurationsleitfaden für d.velop-Infrastrukturkomponenten.

Siehe auch:

Für die ordnungsgemäße Ausführung der verschiedenen Integrationen von d.3one müssen im d.3-System bestimmte Voraussetzungen erfüllt werden. Zu den Voraussetzungen gehört die nahtlose Zusammenarbeit zwischen einem d.3-Repository und der d.3one-Integration, für die bestimmte Anforderungen erfüllt und Einstellungen festgelegt werden müssen. Dazu zählt z.B. Installation der aktuellen Version von d.3 server und bestimmte Einstellungen, die z.B. im Repository vorgenommen werden müssen.

In diesem Thema wird beschrieben, welche Maßnahmen Sie treffen sollten und wie Sie den Server mit d.3 server für die Ausführung von d.3one vorbereiten.

Wenn Sie bereits über ein d.3-System verfügen, sollten Sie als Erstes die Datenbanktabellen in d.3 server mittels des Updateskripts aktualisieren, so wie unter Ausführung des JPL-Updateskript beschrieben. Diesen Schritt können Sie bei einer Neuinstallation von d.3 server überspringen. Stellen Sie darüber hinaus sicher, dass d.3 server auf Port 3400 bidirektional erreichbar ist.

Optional können Sie die facettierte Suchfunktion für jede Kategorie in der d.3 Administration festlegen, um Ihren Anwendern eine einfache Möglichkeit zu bieten, in einer umfangreiche Ergebnisliste schnell zum Ziel zu gelangen. Erfahren Sie mehr im Kapitel Konfigurieren der facettierten Suchfunktion.

Siehe auch:

Der Server mit d.ecs license server verwaltet die Lizenzen aller von Ihnen erworbenen d.velop-Produkte. Weitere Informationen zu d.ecs license server und der Konfiguration finden Sie im Handbuch zu d.ecs license server. Die d.3one-Integrationen benötigen eine eigene Lizenz. Wenn Sie zusätzlich ein Sprachpaket erworben haben, geben Sie die Sprache auch in d.ecs license server an.

Siehe auch:

In diesem Kapitel erfahren Sie, wie Sie ohne die IIS-Rolle ein domänenweit gültiges Webserverzertifikat erstellen und das Webserverzertifikat inklusive des privaten Schlüssels exportieren können. Ein Zertifikat wird benötigt, um eine sichere HTTP-Verbindung (HTTPS) zu ermöglichen.

Der Vorteil eines domänenweit gültigen Zertifikats besteht darin, dass die Zertifikate auf den Computern aufgrund der Zertifikatkette innerhalb der Domäne immer verifiziert werden können. Jedem Computer, der zu einem späteren Zeitpunkt der Domäne beitritt, werden automatisch alle Domänenzertifikate der Zertifikatkette bereitgestellt.

Wenn Sie die d.3 mobile App auf einem mobilen Endgerät verwenden, benötigen Sie ein Zertifikat einer offiziellen Zertifizierungsstelle.

Die Zertifikaterstellung ist in zwei Aufgaben unterteilt.

Ein vorhandenes Zertifikat muss nur dann neu erstellt werden, wenn sich die Eigenschaften des Zertifikats geändert haben, da Sie dasselbe Zertifikat auf mehreren Computern nutzen können.

Erstellen der Zertifikatvorlage

Sobald die Zertifikatvorlage erstellt wurde, müssen Sie diese aktivieren.

Die Zertifikatvorlage wurde nur für diese Zertifizierungsstelle aktiviert.

Erstellen eines Zertifikats

In diesem Schritt erfahren Sie mehr zu allen notwendigen Aufgaben, um ein Webserverzertifikat zu erstellen, das Sie für d.ecs http gateway nutzen können.

Wenn Sie ein Zertifikat für Drittanbietersoftware erstellen, müssen Sie möglicherweise weitere Zertifikateigenschaften angeben.

In d.ecs http gateway werden bestimmte Zertifikateigenschaften angezeigt. Damit diese Zertifikateigenschaften angezeigt werden, müssen diese beim Erstellen des Zertifikats angeben werden. In der Übersicht finden Sie die Zuordnungen der Benennungen zwischen Terminologie von d.ecs http gateway und Microsoft.

Mit Registrieren starten Sie die Erstellung des Zertifikats. Nach Abschluss der Zertifikaterstellung muss das Zertifikat exportiert werden.

Sie müssen dieses Kennwort beim Importieren des Zertifikats in d.ecs http gateway angeben. Es ist empfehlenswert, das Kennwort an keiner anderen Stelle zu verwenden.

Das erstellte Zertifikat wird beim Installieren von d.3one im Setup ausgewählt.

Siehe auch:

Die Kommunikation zwischen der Integration sowie dem Browser und der d.ecs http gateway-App ist generell über HTTPS verschlüsselt. Allerdings kommunizieren die d.ecs http gateway-App und die Instanz einer App unverschlüsselt über HTTP. Eine Ausnahme bilden die Apps, die in Internetinformationsdienste (IIS) gehostet werden, da die Kommunikation bereits mithilfe von TLS (Transport Layer Security-Protokoll) verschlüsselt ist. Sie haben die Möglichkeit, die Kommunikation zwischen d.ecs http gateway-App und den App-Instanzen ebenfalls mit einem Zertifikat zu verschlüsseln, das das TLS-Protokoll nutzt.

In diesem Kapitel finden Sie eine Anleitung, welche Schritte durchgeführt werden müssen, um die Kommunikation zu verschlüsseln. Das verwendete Protokoll entspricht dem aktuellen Sicherheitsstandard, wobei SSL (Secure Socket Layer) synonym zu TLS verwendet wird.

Selbstsignierte Zertifikate gelten generell als unsicher und dürfen nicht verwendet werden, wenn Sie eine sichere Verbindung konfigurieren möchten.

So geht's

Zunächst müssen Sie in den jeweiligen Apps TLS aktivieren und der App einen festen Port zuweisen. Gehen Sie wie folgt vor:

Aktivieren von TLS in den Apps d.ecs repo, d.ecs process portal, d.ecs identity tunnel, d.ecs file container, d.ecs pdf:

Im nächsten Schritt benötigen Sie den Hashwert des zu verknüpfenden Zertifikats. Sie können dasselbe Zertifikat verwenden, das Sie auch in IIS nutzen. Gehen Sie wie folgt vor:

Wenn Sie ein anderes Zertifikat verwenden möchten, können Sie über die Eigenschaften des Zertifikats den Hashwert (Fingerabdruck) ermitteln. Entfernen Sie unbedingt alle Leerzeichen.

Neben diesem Hashwert wird eine Anwendungskennung (appid) benötigt. Sie können als Anwendungskennung jede gültige GUID im Format "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" verwenden.

Mithilfe dieser beiden Werte können Sie jetzt das Zertifikat mit dem Port der App verknüpfen. Gehen Sie wie folgt vor:

Die Befehle können in etwa folgendermaßen aussehen:

netsh http show sslcert ipport=0.0.0.0:3401
netsh add urlacl url=https://*:4000/ user=SYSTEM
url=https://*:4000/ user=SYSTEM
netsh http add sslcert ipport=0.0.0.0:4000 
certhash=e31c06568e4b222a92c8434eaa770b26f09a31a3 appid={2131f4cd-d05b-4308-9af1-9caa44b2c74a}

Starten Sie die betreffenden Apps neu, um sicherzustellen, dass die Apps sich mit HTTPS statt mit HTTP bei der d.ecs http gateway-App registrieren.

In der d.ecs http gateway-Administration können Sie überprüfen, wie sich die Apps bei der d.ecs http gateway-App registriert haben. Gehen Sie wie folgt vor:

Das Freigeben von Ports für die Apps ist für Sie relevant, wenn Sie die produktspezifischen Apps und die zentralen Apps, z.B. d.ecs http gateway, auf unterschiedlichen Servern installieren.

Sie haben die Möglichkeit und es ist empfehlenswert, jeder produktspezifischen App einen festen Port zuzuweisen.

Wenn Sie sich entscheiden, feste Ports in der Firewall freizugeben, müssen Sie den d.3one-Apps d.ecs repo, d.ecs process portal, d.ecs identity tunnel, d.ecs file container und d.ecs pdf eine feste Portnummer zuweisen.

So geht's

Bei den Apps, die in IIS gehostet werden, wird der Port beim Installieren von d.3one festgelegt.

Weitere Informationen zum Zuweisen von Port für die zentralen Apps finden Sie in den jeweiligen Produkthandbüchern.

Siehe auch: