ViREQHandbuch
Start › Mirth Connect Plugins

Mirth Connect (CE) - SSL Plugin

17 Abschnitte · zuletzt aktualisiert 2022-11-21

ViREQ SSL Plugin (CE)#

Einführung

Das SSL-Plugin bietet die Möglichkeit, Nachrichten verschlüsselt zu übertragen. Dazu werden die Connector um SSL-Optionen erweitert. Für die Verwaltung von Schlüsseln und Zertifikaten erweitert das Plugin den Einstellungsbereich im "Mirth Connect Administrator“ um einen Reiter namens „SSL Manager “.

Verwaltungsmanager (SSL-Manager)

Der Verwaltungsmanager (SSL-Manager) dient der Verwaltung von Schlüsseln und Zertifikaten. Die Schlüssel und Zertifikate werden im Mirth Keystore gespeichert.

Mit dem SSL-Manager ist es möglich, selbstsignierte Zertifikate zu erstellen, sodass eine externe CA nicht erforderlich ist. Darüber hinaus kann der SSL-Manager auch als Zertifizierungsstelle verwendet werden, für die ein CA-Zertifikat erstellt werden muss. Dieses CA-Zertifikat muss im verwendeten Unternehmen als vertraulich eingestuft und ggf. als vertrauenswürdig hinterlegt werden oder in den entsprechenden Client-Zertifikatspeichern gespeichert werden.

Aus diesem Grund wird der CSR-Prozess im SSL-Manager wie folgt unterstützt:

Folgende Funktionen sind mit dem SSL Manager möglich:

  • Erstellen Sie Schlüssel für die Java-Verschlüsselung (AES)
  • Erstellen von RSA-, DSA-Schlüsselpaaren in Verbindung mit einem Zertifikat (Public Key)
  • Erstellen von CA-Zertifikaten zum Signieren anderer Zertifikate
  • Erstellen von SSL-Zertifikaten für die Verschlüsselung Anzeigen von Zertifikatsinformationen
  • Importieren von Zertifikaten (einschließlich CSR-Antworten)
  • Exportieren von Schlüsseln und Zertifikatsdateien
  • Löschen von Zertifikaten aus dem Mirth-Schlüsselspeicher
  • CSR basierend auf vorhandenem Zertifikat erstellen
  • Erstellen Sie ein Zertifikat (CSR-Antwort) basierend auf einer
  • CSR Sicherung des Mirth-Schlüsselspeichers
  • Wiederherstellung des Mirth Keystore

Wie installiert man das SSL Plugin?#

Schritt 1

Nachdem das Plugin heruntergeladen wurde, muss dieses installiert werden.

Klicke auf die Schaltfläche "Extensions" unter "Mirth Connect" um eine Übersicht der installierten Plugins zu erhalten.

Auswahl des Pfads#

Schritt 2

Am Ende der Tabelle kann der Pfad des Plugins direkt eingegeben werden oder manuell mit der "Browse" Schaltfläche im Dateiexplorer gesucht werden.

Auswahl des Plugins#

Schritt 3

Die Schaltfläche "browse" öffnet ein Fenster in welchen das gewünschte Plugin ausgewählt werden kann. Die Auswahl wird mit der "Open / Öffnen" Schaltfläche bestätigt.

Der Pfad entspricht dem Ort, an dem die Datei nach dem Download gespeichert wurde.

Installation#

Schritt 4

Nachdem das gewünschte Plugin ausgewählt wurde, muss auf die "Install / Installieren" Schaltfläche geklickt werden um das Plugin zu installieren.

Neustart des Servers und des Clients#

Schritt 5

Wenn das Plugin erfolgreich importiert wurde, muss der Mirth Connect Server und der Mirth Connect Administrator neugestartet werden, damit die Plugins aktiviert werden.

Überprüfung der Installation#

Schritt 6

Nach dem Neustart sollte das Plugin in der "Installed Plugins" Liste auftauchen. Diese kann als Tabelle im Untermenü von "Extensions" gefunden werden.

Glückwunsch, Sie haben das ViREQ Connect - SSL Plugin erfolgreich installiert.

Übersicht SSL Manager#

Übersicht SSL Manager Einstellungen

Im Reiter SSL Manager werden alle Zertifikate des "Mirth Keystore" in einer Tabelle angezeigt. Diese besteht aus den folgenden Einträgen:

FeldBeschreibung
AliasAlias unter welchen der Schlüssel oder das Zertifikat im Keystore gespeichert wird.
SubjectName des Zertifikats:
Des Weiteren wird der Status des Zertifikates mit einem Farbigen Punkt dargestellt

• grün = gültig
• rot = ungültig
• blau = gültig
IssuerName der CA welche das Zertifikat ausgestellt hat.
Valid fromDatum und Zeit ab welchem das Zertifikat gültig ist.
Valid toDatum und Zeit bis zu welchem das Zertifikat gültig ist.
Creation DateDatum und Zeit wann das Zertifikat im Keystore gespeichert wurde.

Zertifikatdetails anzeigen#

Durch einen Doppelklick auf ein Zertifikat um ein Informationsfenster zu öffnen, dort werden die Zertifikatsdetails angezeigt.

Neue Schlüssel / Zertifikate erstellen#

Mit der Schaltfläche "New" kann ein neuer Schlüssel oder ein Schlüsselpaar erstellt werden. Die folgenden Felder müssen je nach Einstellungen ausgefüllt werden:

FeldBeschreibung
AliasAlias unter welchen der Schlüssel oder das Zertifikat im Keystore gespeichert wird.
Key-SettingsSchlüssel Algorithmus und Schlüssellänge
Certificate typeZertifikatarten:

• Keins = Es wird kein Zertifikat erstellt, nur ein AES Schlüssel
• CA = Ein CA Zertifikat wird erstellt
• SSL = Ein SSL Zertifikat wird erstellt.
Signature AlgorithmAlgorithmus zum Signieren des Zertifikates
Valid fromDatum und Zeit ab welchem das Zertifikat gültig ist.
Valid DurationZeit wie lange das Zertifikat gültig ist. Wird genutzt um "Valid to" zu berechnen.
Valid toDatum und Zeit bis zu welchem das Zertifikat gültig ist.
SubjectName des Zertifikats
Alternate NamesAlternative Namen für das Zertifikat.
DNS, IP usw. müssen für "machine" Zertifikate eingegeben werden.
Diese Zertifikate werden für die Host Name Verteilung genutzt.
Signature TypeSpezifiziert wie das Zertifikat unterschrieben werden soll.

• self = Ein Selbst unterschriebenes Zertifikat
• Signature by = wähle ein Zertifikat mit welchem das Zertifikat unterschrieben wird

Importieren von Zertifikaten#

Die "Import" Schaltfläche kann genutzt werden um Zertifikate oder CSR-Antwortzertifikate zu importieren.

Die folgenden Zertifikat Formate werden unterstützt

  • .der - Zertifikat (DER X.509)
  • .crt - Zertifikat (DER X.509)
  • .cer - Zertifikat (DER X.509)
  • .p7b - Zertifikat (PKCS #7)
  • .p7c - Zertifikat (PKCS #7)
  • .pem - Zertifikat

Wenn ein Eintrag ausgewählt ist, wird das existierende Zertifikat überschrieben. Bevor der Import beginnt, wird überprüft ob der Privatschlüssel und die öffentlichen Schlüssel des zu importierenden Schlüssels übereinstimmen. Wenn der Schlüssel falsch ist, ist der import unter diesem Alias nicht möglich. Jedoch kann das Zertifikat unter einem neuen Alias wieder importiert werden. Wenn kein Privatschlüssel vorhanden ist, kann das Zertifikat nur für die Verifizierung genutzt werden.

Exportieren von Schlüsseln / Zertifikaten#

Zur Exportierung ist ein besonderes Fenster zum Exportieren verfügbar. Die folgenden Felder müssen ausgewählt oder je nach Einstellungen Gesetz werden:

FeldBeschreibung
ExportAuswahl welche Inhalte exportiert werden sollen:

• Key = nur der AES Schlüssel
• Certificate = nur das Zertifikat
• Key and Certificate = Zertifikat und AES Schlüssel
LocationOrt wo der Export gespeichert werden soll, entweder beim Client oder auf dem Server.
FormatLegt das Format für den Export fest.
to FileLegt den Dateinamen entweder auf dem Server oder auf dem Client fest.
PasswordFür den Export muss ein Passwort vergeben werden.
Confirm PasswordBestätigung des vorher festgelegten Passworts.

Backups#

Keystore Backup

Die Option "Backup" ist im Navigationsbereich links unter "ViREQ SSL Plugin" verfügbar. Die Schaltfläche wird genutzt, um den Keystore in das Anwendungsverzeichnis (Appl. Directory) zu sichern.

Der Keystore wird kopiert und mit einem Zeitstempel versehen.

Keystore wiederherstellen

Wiederherstellen ist links unter dem Reiter "ViREQ SSL Plugin" enthalten. Durch einen Klick auf die "Restore" Schaltfläche erscheint ein Fenster in welchem man ein Backup auswählen und wiederherstellen kann.

Im Appl. Directory werden alle keystore Backups mit einem Zeitstempel in ihrem Namen werden zur Auswahl bereitgestellt

Wenn die Backups archiviert sind, muss sichergestellt werden dass das Passwort des Keystores gespeichert ist. Das momentane Passwort der mirth Konfiguration wird immer für Backup und Wiederherstellung genutzt.

Möglicherweise muss das Passwort nach einer Wiederherstellung in der Mirth Konfiguration neu vergeben werden.

Ein abgelaufenes Zertifikat updaten

Wenn ein bereits existierendes Zertifikat aufgrund seines alters ausläuft, muss ein neues erstellt mit dem CSR Prozess unterschrieben werden.

Löschen eines Zertifikats#

Nutzen Sie die "delete" Schaltfläche um das Zertifikat zu löschen

Mit dieser Schaltfläche wird die ausgewählte Zeit / das ausgewählte Zertifikat gelöscht.

CSR Optionen#

CSR erstellen

Die Schaltfläche "Create CSR" erstellt einen CSR für den ausgewählten Eintrag. Das CSR wird im PEM Format erstellt und in einem Antwort-Fenster angezeigt.

CSR Antwort erstellen

Die "Manage CSR" Schaltfläche wird genutzt um eine neue CSR Antwort, und ein neues Zertifikat zu erstellen. Dazu öffnet sich ein Konfigurators-dialog. In diesem müssen die CSR Datei, der Unterschreibungs-Algorithmus und die Gültigkeitsperiode angegeben werden.

Als Resultat wird ein neues Zertifikat inklusive des Zertifikations-Pfades in eine neue Datei geschrieben. Auch die Ausgangsdatei muss im Dialog Fenster angegeben werden. Das Ergebnis kann danach mithilfe der "import" Funktion importiert werden.

Connectors und Audits#

Connectors

Diese Einstellungen werden in "Settings" / "Your Channel" / Source gefunden.

Dieses Plugin fügt den "Connectors" SSL Funktionalität hinzu.

Liste der Connectors welche mit SSL Funktionen erweitert werden:

  • TCP Listener
  • HTTP Listener
  • Web Service Listener
  • TCP Sender

SSL audits

Die verfügbaren SSL Checks sind unten aufgelistet:

  • .PKIX validations Überprüfe ob der "Public Key" des Ausstellers in der Liste der vertrauten Zertifikate auftaucht. Diese Liste muss bei jedem Connector neu angegeben werden.
  • .certificate / hostname validation
  • Überprüft ob der hostname der Verbindung (Server oder Client) in der Liste der alternativen Namen für SSL Zertifikate auftaucht.
  • .certificate validity Überprüft ob die Nutzer Zertifikate der Connectors immer noch gültig sind

Einstellungen - Listener

Die Einstellungen des Listeners können im "Source" Reiter der Channel Konfiguration gefunden werden.

Einerseits muss die Auswahl "use SSL" angeklickt sein, um festzulegen ob SSL benutzt wird oder nicht.

Einstellungen im SSL-Konfigurationsfenster

EinstellungBeschreibung
Enabled ProtocolsAuswahl möglicher SSL-Protokolle
Enabled Cipher SuitesAuswahl möglicher Cipher Suites
Use Cipher Suites OrderAnordnung der Cipher Suites beim verbindungsaufbau beachten ?
Client AuthenticationWelche Client-Authentifizierung soll genutzt werden ?

• Keine = keine, das Server-Zertifikat wird benutzt (default)
• Need = Client Zertifikat muss benutzt werden
• Want = Client Zertifikat kann benutzt werden
Key CertificatePrivate key und Zertifikate welche für die Verbindung genutzt werden.
Trust CertificateZertifikate welche als vertrauenswürdige Zertifikate für die Verbindung genutzt werden sollen.
Certificate ValidationAktiviert / Deaktiviert die Zertifkat-Überprüfung (PKIX)
Hostname ValidationAktiviert / Deaktiviert die Hostname Überprüfung
Allow Expired CertificateAktiviert / Deaktiviert die Ablaufüberprüfung von Zertifikaten

Einstellungen - Transmitter

Im "Destinations" Reiter der Channel-Konfiguration können die SSL-Einstellungen für jede Destination unabhängig eingestellt werden.

Die Auswahl "use SSL" muss angeklickt sein, um festzulegen ob SSL benutzt wird oder nicht.

Diese SSL-Einstellungen sind verfügbar:

EinstellungBeschreibung
Enabled ProtocolsAuswahl möglicher SSL-Protokolle
Enabled Cipher SuitesAuswahl möglicher Cipher Suites
Use Cipher Suites OrderAnordnung der Cipher Suites beim verbindungsaufbau beachten ?
Key CertificatePrivate key und Zertifikate welche für die Verbindung genutzt werden.
Trust CertificateZertifikate welche als vertrauenswürdige Zertifikate für die Verbindung genutzt werden sollen.
Certificate ValidationAktiviert / Deaktiviert die Zertifkat-Überprüfung (PKIX)
Hostname ValidationAktiviert / Deaktiviert die Hostname Überprüfung
Allow Expired CertificateAktiviert / Deaktiviert die Ablaufüberprüfung von Zertifikaten, Erlaubt / verbietet es abgelaufene Zertifikate zu verwenden.

Einrichtung des Web Zertifikats#

Einrichtung des Web Zertifikats

Mit dem SSL-Manager kann das Webzertifikat ausgetauscht werden, das der Mirth Server zur Verschlüsselung verwendet. Dazu müssen das Zertifikat und der private Schlüssel unter dem Alias „mirthconnect“ im Keystore bereitgestellt werden.

Der Alias kann nicht geändert werden! Wenn beim Starten des Mirth-Servers kein Alias „mirthconnect“ im Keystore gefunden wird, wird vom Server ein neues Standardzertifikat erstellt.

Bitte beachten Sie bei der Verwendung von selbstsignierten Zertifikaten, dass das CA-/Signatur Zertifikat im Keystore des Clients (Zertifikatsverwaltung) enthalten ist, auf dem der Mirth Administrator ausgeführt werden soll.