Serverseitige Einrichtung

Die Kommunikation zwischen Client und Server ist grundsätzlich symmetrisch verschlüsselt. Die meisten unserer Kunden betreiben SmartNotes "on premise" im eigenen Firmennetzwerk. Für dieses Szenario ist diese Art der Verschlüsselung ausreichend.

Als weitere Möglichkeit für Kunden mit einem SmartNotes Server außerhalb des eigenen Firmennetzwerks haben wir nun die Verschlüsselung per SSL implement.

Für die Kommunikation wird ein Keypaar zwischen dem SmartNotes Server und dem SmartNotes Client ausgetauscht.

40%

60%

Für die Erstellung des Zertifikats auf dem SmartNotes Server starten Sie zunächst die Microsoft Management Console (Ausführen -> mmc).

Im nun geöffneten Fenster öffnen Sie den Reiter „Datei und klicken auf „Snap-In hinzufügen/entfernen“.

40%

60%

Wählen Sie hier den Punkt „Zertifikate" aus und fügen diesen über den mittleren Button hinzu.

40%

60%

Nun wählen Sie das Computerkonto aus und schließen im nächsten Schritt die Einrichtung des Zertifikates ab.

40%

60%

Nun sehen Sie in der Baumstruktur links den neuen Punkt „Eigene Zertifikate“. Klicken Sie mit einem rechten Mausklick auf diesen Menüpunkt und wählen Sie „Neues Zertifikat anfordern“.

40%

60%

Fahren Sie nun mit der Erstellung des Zertifikats fort, bis Sie die Registrierungsrichtlinie erhalten. Wählen Sie nun den Punkt „Computer“ aus, klappen diesen über „Details" auf und öffnen die Eigenschaften.

40%

60%

Unter dem Punkt „Privater Schlüssel“ muss das Häkchen bei „Privaten Schlüssel exportierbar machen“ gesetzt werden. Danach kann die Änderung übernommen und der Schlüssel registriert werden.

40%

60%

Das neu erstellte Zertifikat sollten Sie nun in der Übersicht sehen können. Da SmartNotes einen eindeutigen Namen des Zertifikats verlangt, können sie zusätzlich einen Alias vergeben. Dieser Schritt ist optional und muss nur ausgeführt werden, falls mehrere Zertifikate mit demselben Namen existieren. Den Alias können Sie mit einem Rechtsklick auf das Zertifikat unter den Eigenschaften hinterlegen.

40%

60%

Nun kann das Zertifikat exportiert werden. Dieses Zertifikat muss in den nächsten Schritten auf den einzelnen Clients hinterlegt werden.

40%

60%

Damit das Zertifikat auf den Clients hinterlegt werden kann, muss das Exportieren des privaten Schlüssels aktiviert werden. Das Zertifikat sollte im nächsten Schritt als PKCS #12 (.PFX) erstellt werden.

40%

60%

Das Exportieren des Zertifikats erfordert die Eingabe eines Passworts. Das Server-Zertifikat muss im Nachgang auf allen Clients eingespielt werden, die eine Verbindung zum SmartNotes Server erhalten sollen.

Clientseitige Einrichtung

40%

60%

Im nächsten Schritt muss noch ein Zertifikat auf der Clientseite erstellt werden. Die Schritte verlaufen ähnlich zur Zertifikatserstellung auf dem Server. Für die Erstellung des Zertifikats auf dem SmartNotes Server starten Sie bitte die Microsoft Management Console (Ausführen -> mmc).

Im nun geöffneten Fenster öffnen Sie bitte den Reiter Datei und klicken auf „Snap-In hinzufügen/entfernen“.

Es genügt dabei, das Zertifikat auf einem Client zu erstellen und im Nachgang auf allen Servern zu hinterlegen.

40%

60%

Wählen Sie hier bitte den Punkt Zertifikate aus und fügen diesen über den mittigen Button hinzu.

40%

60%

Nun wählen Sie bitte das Eigene Benutzerkonto aus und schließen im nächsten Schritt die Einrichtung des Zertifikates auf.

40%

60%

Nun sehen Sie in der Baumstruktur links den neuen Punkt „Eigene Zertifikate“. Klicken Sie Rechts auf diesen Menüpunkt und wählen Sie „Neues Zertifikat anfordern“.

40%

60%

Fahren Sie nun mit der Erstellung des Zertifikats fort, bis Sie die Registrierungsrichtlinie erhalten. Wählen Sie nun den Punkt „Benutzer“ aus, klappen diesen auf und öffnen die Eigenschaften.

40%

60%

Unter dem Punkt „Privater Schlüssel“ muss das Häkchen bei „Privaten Schlüssel exportierbar machen“ gesetzt werden. Danach kann die Änderung übernommen und der Schlüssel registriert werden.

40%

Das neu erstellte Zertifikat sollten Sie nun in der Übersicht sehen können. Da SmartNotes einen eindeutigen Namen des Zertifikats verlangt, können sie zusätzlich einen Alias vergeben. Dieser Schritt ist optional und muss nur ausgeführt werden, falls mehrere Zertifikate mit dem selben Namen existieren. Den Alias können Sie mit einem Rechtsklick auf das Zertifikat unter den Eigenschaften hinterlegen.

40%

60%

Nun kann das Zertifikat exportiert werden. Dieses Zertifikat muss auf den einzelnen Clients hinterlegt werden.

40%

60%

Damit das Zertifikat auf den Clients hinterlegt werden kann, muss das Exportieren des privaten Schlüssels aktiviert werden. Das Zertifikat sollte im nächsten Schritt als PKCS #12 (.PFX) erstellt werden.

40%

60%

Das Exportieren des Zertifikats erfordert die Eingabe eines Passworts. Das Client-Zertifikat muss im Nachgang auf dem SmartNotesServer, sowie allen Clients eingespielt werden, die eine Verbindung zum SmartNotes Server erhalten sollen.

Konfiguration des Servers

40%

60%

Bitte hinterlegen Sie das exportierte Client-Zertifikat nun auf Ihrem Server. Dazu muss dieses einfach über Doppelklick geöffnet werden. Wählen Sie für den Import den Lokalen Computer aus.

Sollten Sie mehrere Client-Zertifikate erstellt haben, müssen Sie diese ebenfalls auf dem Server hinterlegen.

40%

60%

Klicken Sie durch die Installation und geben Sie im folgenden Prozess das Kennwort ein. Den Zertifikatsspeicher im letzten Punkt können Sie auf automatisch belassen.

40%

60%

Nun müssen Sie im letzten Schritt noch die Konfiguration des Servers anpassen. Hierzu stehen Ihnen verschiedene Parameter zur Verfügung. Die Anpassungen müssen in der Server-Konfigurationsdatei vorgenommen werden. Im Standard ist der Server unter C:\Program Files (x86)\Amana Consulting\SmartNotesServer installiert. Stoppen Sie vor Anpassung der Konfigurationsdatei bitte den Server.

40%

60%

Im Bereich <appSettings>…</appSettings> in dieser Datei müssen Sie nun die folgenden Parameter pflegen.

<add key="UseSslForEncryption" value="true" /> - Dieser Wert muss auf true gesetzt werden, um die Verschlüsselung einzuschalten.
Sobald dieser Wert auf True gesetzt wurde, ist der Zugriff nur noch über Zertifikate gestattet. Sollten Sie die Zertifikate nicht richtig hinterlegt oder installiert haben, ist der Zugriff nicht möglich.
<add key="SslServerAuthenticationX509CertificateSubjectName" value="SmartNotesServer" /> - Dieser Wert beinhaltet den Subject Name des hinterlegten Server-Zertifikats. Den Namen finden Sie in Ihrem Zertifikatsspeicher im Reiter „Ausgestellt für“
<add key="SslClientAuthenticationX509CertificateSubjectName" value="SmartNotesClient" /> - Dieser Wert beinhaltet den Subject Name des hinterlegten Client-Zertifikats. Den Namen finden Sie in Ihrem Zertifikatsspeicher im Reiter „Ausgestellt für“
<add key="SslServerAuthenticationX509CertificateFriendlyName" value="xyz" /> - Sofern ein Anzeigename für das Server-Zertifikat angelegt wurde, muss dieser über diesen Parameter angegeben werden.
<add key="SslClientAuthenticationX509CertificateFriendlyName" value="xyz" /> - Sofern ein Anzeigename für das Client-Zertifikat angelegt wurde, muss dieser über diesen Parameter angegeben werden.
<add key="X509CertificateStoreLocation" value="LocalMachine" /> - Über diesen Eintrag kann der Speicherort der Zertifikate geändert werden. Sofern die Zertifikate im Computerkonto gespeichert wurden, können Sie diesen Eintrag auslassen. Nur bei einer Speicherung im Benutzerkonto muss dieser Eintrag auf CurrentUser gesetzt werden.

40%

60%

Nach der Hinterlegung der Parameter können Sie den Serverdienst wieder neu starten. Die Verschlüsselung über den Server ist nun aktiviert.

Beachten Sie bitte, dass nach der Aktivierung der SSL-Verschlüsselung der Server nur erreichbar ist, wenn diese client- und serverseitig hinterlegt sind. Sofern die Konfiguration nicht auf beiden Seiten korrekt angelegt ist, kann die Verbindung eventuell gestört sein.

Konfiguration des Clients

40%

60%

Bitte hinterlegen Sie das exportierte Server-Zertifikat nun auf Ihrem Client. Dieser Schritt muss für alle Clients wiederholt werden, die Zugriff auf den Server erhalten sollen.

Dazu muss dieses einfach über Doppelklick geöffnet werden. Wählen Sie für den Import den aktuellen Benutzer aus.

40%

60%

Klicken Sie durch die Installation und geben Sie im folgenden Prozess das Kennwort ein. Den Zertifikatsspeicher im letzten Punkt können Sie auf automatisch belassen.

40%

60%

Nun müssen Sie im letzten Schritt noch die Konfiguration des Clients anpassen. Hierzu stehen Ihnen verschiedene Parameter zur Verfügung.

Beachten Sie bitte, dass die Anpassung der Client-Konfigurationsdatei auf jedem Client durchgeführt werden muss. Natürlich können Sie die die identische Konfigurationsdatei für alle User verwenden.

Im Standard ist der Server unter C:\Program Files (x86)\Amana Consulting\SmartNotesClient installiert. Schließen Sie vor Änderungen an dieser Datei immer Ihren aktiven SmartNotesClient.

40%

60%

Im Bereich <appSettings>…</appSettings> in dieser Datei müssen Sie nun die folgenden Parameter pflegen.

<add key="UseSslForEncryption" value="true" /> - Dieser Wert muss auf true gesetzt werden, um die Verschlüsselung einzuschalten.
Sobald dieser Wert auf True gesetzt wurde, ist der Zugriff nur noch über Zertifikate gestattet. Sollten Sie die Zertifikate nicht richtig hinterlegt oder installiert haben, ist der Zugriff nicht möglich.
<add key="SslServerAuthenticationX509CertificateSubjectName" value="SmartNotesServer" /> - Dieser Wert beinhaltet den Subject Name des hinterlegten Server-Zertifikats. Den Namen finden Sie in Ihrem Zertifikatsspeicher im Reiter „Ausgestellt für“
<add key="SslClientAuthenticationX509CertificateSubjectName" value="SmartNotesClient" /> - Dieser Wert beinhaltet den Subject Name des hinterlegten Client-Zertifikats. Den Namen finden Sie in Ihrem Zertifikatsspeicher im Reiter „Ausgestellt für“
<add key="SslServerAuthenticationX509CertificateFriendlyName" value="xyz" /> - Sofern ein Anzeigename für das Server-Zertifikat angelegt wurde, muss dieser über diesen Parameter angegeben werden.
<add key="SslClientAuthenticationX509CertificateFriendlyName" value="xyz" /> - Sofern ein Anzeigename für das Client-Zertifikat angelegt wurde, muss dieser über diesen Parameter angegeben werden.
<add key="X509CertificateStoreLocation" value="CurrentUser" /> - Über diesen Eintrag kann der Speicherort der Zertifikate geändert werden. Da die Zertifikate auf dem Server unter dem aktuellen Benutzerkonto gespeichert sind, muss diese Option zwingend gesetzt sein.

CloudClient Server SSL Encryption