Konfiguration

[Optional] Ports ändern

Falls einer oder mehrere der erforderlichen Ports für KIM4charly bereits belegt sind, konfigurieren Sie diese um:

How-to

Hinweis: Sofern keine neuere charly-Version vorliegt, aktualisiert der charly-Updater ausschließlich den charly-Java-Server und nimmt dabei die Port-Änderungen vor. Falls eine neuere charly-Version verfügbar ist, aktualisiert der charly-Updater zusätzlich die charly-Version.

Voraussetzungen

  • Der charly-Updater liegt auf dem charly-Server (Download Windows bzw. Download macOS).
  • Der charly-Server verfügt über eine Internetverbindung.

  • Das Ausführen des charly-Updaters ist vorbereitet:

    1. Schalten Sie alle charly-Arbeitsplätze (Clients) aus.
    2. Schließen Sie auf dem charly-Server alle Programme.
    3. Führen Sie auf dem charly-Server eine Datensicherung durch.
    4. Starten Sie den charly-Server neu.
    5. Melden Sie sich mit Administratorrechten am charly-Server an.
    6. Deaktivieren Sie auf dem charly-Server den Virenscanner für den Zeitraum des Updates.

Vorgehensweise

  1. Starten Sie den charly-Updater.
  2. Folgen Sie den Anweisungen des charly-Updater-Assistenten bis zu der Maske für die Konfiguration der Ports für den SSL-Proxy sowie für den messaging-Service.
  3. Ändern Sie den bzw. die Ports.

  4. Folgen Sie weiter den Anweisungen des charly-Updater-Assistenten.

    • Der charly-Updater führt die Port-Änderungen für die Services durch.
  1. Öffnen Sie auf dem Server folgendes Verzeichnis:
    <charly-Installationspfad>\Solutio\Server\ncjs\
  2. Legen Sie in diesem Verzeichnis das Verzeichnis „conf2“ und darin das Verzeichnis „messaging“ an:
    <charly-Installationspfad>\Solutio\Server\ncjs\conf2\messaging\
  3. Legen Sie in dem Verzeichnis „messaging“ eine Textdatei an und benennen Sie diese mit „application.yml“.

  4. Kopieren Sie die folgende Einstellung in die application.yml:

    de.solutio.ncjs.messaging.broker.stomp.port:14712

  5. Ändern Sie den Port.

  6. Damit der messaging-Service die fertig bearbeitete application.yml verwendet, muss der messaging-Service gestoppt und anschließend wieder gestartet werden:

    • Windows

      1. Öffnen Sie die Administrator-Kommandozeile und geben Sie folgende Befehle ein:

        cd <charly-Installationspfad>\Solutio\Server\ncjs

      2. Stoppen Sie den messaging-Service:

        acd.bat stop messaging

      3. Starten Sie den messaging-Service:

        acd.bat start messaging

    • macOS

      1. Öffnen Sie das Terminal und geben Sie folgende Befehle ein:

        cd <charly-Installationspfad>/Solutio/Server/ncjs

      2. Stoppen Sie den messaging-Service:

        sudo ./acd.sh stop messaging

      3. Starten Sie den messaging-Service:

        sudo ./acd.sh start messaging

  7. Prüfen Sie in charly-Web in der Perspektive Administration > Systemstatus > Komponenten ob der messaging-Service gestartet ist.

 

In charly-Client: Telematikinfrastruktur (TI) einrichten

Hinweis: Die Anleitung setzt voraus, dass die Telematikinfrastruktur in der Praxis bereits eingerichtet und in charly der Konnektor sowie die Aufrufkontexte konfiguriert sind. Siehe Voraussetzungen und Konfiguration.
Hinweis: Entsprechend der Anforderungen der IT-Sicherheitsrichtlinie empfiehlt die solutio GmbH & Co. KG die Konfiguration mittels TLS mit Zertifikatsprüfung.

Konfiguration des Konnektors sowie der Aufrufkontexte testen

In charly können Sie in dem Fenster Konnektor-Operationen verschiedene Operationen durchführen, um die Konfiguration der Telematikinfrastruktur zu testen.

Über die Status-Ampel E-Health-Service Status können Sie erkennen, ob der E-Health-Service erreichbar ist.

  • Status-Ampel: ●

    Der E-Health-Service ist erreichbar und es können Konnektor-Operationen durchgeführt werden.

  • Status-Ampel: ●

    Es erscheint ein Hinweis, dass der E-Health-Service nicht erreichbar ist oder einen Fehler meldet. Es können keine Konnektor-Operationen durchgeführt werden. Im Log-Bereich werden weitere Informationen gelistet.

Über den Button Konnektorstatus testen können Sie den TI-Status sowie den SI-Status testen:

TI-Status Der TI-Status zeigt, ob der Konnektor über den VPN-Zugangsdienst (VPN = Virtual Private Network) eine sichere Verbindung zu der zentralen Telematikinfrastruktur aufbauen kann. Der Weg in die TI wird dabei „getunnelt“.
SI-Status Der SI-Status zeigt an, ob der optionale Dienst „Sicherer Internet Service“ (SIS) für den geschützten Zugriff auf das Internet verfügbar ist. Ein Zugriff auf das Praxisnetzwerk über eingehende Verbindungen ist hierbei technologisch ausgeschlossen.

Der TI-Status und der SI-Status kennen jeweils die folgenden Zustände:

Offline Im Offline-Modus des Konnektors kann keine Verbindung zum VPN-Zugangsdienst aufgebaut werden (z.B. weil die WAN- Schnittstelle nicht angeschlossen oder die Verbindung gestört ist).
Online Im Online-Modus des Konnektors besteht eine VPN-Verbindung zur zentralen Telematikinfrastruktur oder es wird davon ausgegangen, dass diese Verbindung jederzeit aufgebaut werden kann. Der Online-Modus ist eine wichtige Voraussetzung für die Verwendung von KIM4charly.

Über den Button Dienstverzeichnis neu verbinden werden die Fachdienste, die auf dem Konnektor laufen, neu geladen und anschließend mit den Fachdienst-Namen und den Versionen im Log-Bereich gelistet.

Wenn Sie die Checkbox Details zeigen aktivieren, werden neben den Fachdienst-Namen und den Versionen der Fachdienste zusätzliche Informationen angezeigt.

Über den Button Verfügbare Kartenterminals listen werden die verfügbaren Kartenterminals mit zusätzlichen Informationen im Log-Bereich gelistet.

Über den Button Gesteckte Karten listen werden sämtliche Karten mit zusätzlichen Informationen gelistet, die in den Kartenterminals gesteckt sind.

 

  1. Gehen Sie in die Menüleiste unter Hilfe > Konnektor-Operationen (TI).

    • Ein Fenster öffnet sich.
  2. Wählen Sie aus der Dropdownliste Konnektoren den Konnektor, für den Sie den Test durchführen möchten.

  3. Wählen Sie aus der Dropdownliste Aufrufkontexte den Aufrufkontext, für den Sie den Test durchführen möchten.

  4. Klicken Sie auf den gewünschten Button im Bereich Operationen.

    • Der Status wird im Log-Bereich ausgegeben.

 

KIM-Clientmodul installieren und konfigurieren

Hinweis: Das KIM-Clientmodul erhalten Sie von Ihrem KIM-Provider. Installieren Sie das KIM-Clientmodul auf dem charly-Server. Für die Installation und Konfiguration des KIM-Clientmoduls lesen Sie bitte die Dokumentation Ihres KIM-Providers.

Ports

Für das Empfangen und Senden von Nachrichten über das KIM-Clientmodul, müssen in KIM4charly bei der Konfiguration eines KIM-Kontos entsprechend die URLs für POP3 sowie SMTP eingegeben werden.

Hinweis: Unter macOS können Ports mit einer Portnummer < 1024 vom KIM-Cientmodul nicht aufgerufen werden (auch nicht mit Admininstrator-Rechten). Bitte ändern Sie die Ports im KIM-Clientmodul für POP3 und SMTP auf eine freie Portnummer > 1024.

 

In KIM4charly: KIM-Konto erstellen

Hinweis: Die Einrichtung und Verwaltung der KIM-Konten erfolgt inzwischen komfortabler in charly-Web.

Wir empfehlen, neue KIM-Konten ausschließlich in charly-Web anzulegen und Änderungen an bestehenden KIM-Konten nur noch in charly-Web vorzunehmen.

Der Abruf der KIM-Postfächer und der Versand von Nachrichten erfolgt aktuell weiterhin im charly-Client über die Menüleiste > Bearbeiten > KIM4charly.

Weitere Informationen finden Sie unter: KIM-Konto.

Tipp: Für möglichst automatisierte Abläufe im Praxisalltag, empfiehlt es sich, mindestens ein Praxiskonto in KIM4charly einzurichten. Durch die Verknüpfung des Praxiskontos mit dem Praxisausweis (SMC-B), werden die folgenden Aktionen für dieses Praxiskonto i.d.R. ohne weiteres Zutun des Praxispersonals durchgeführt:
  • Synchronisierung der Postfächer
  • Entschlüsselung eingehender KIM-Nachrichten mit der SMC-B-Karte
  • Verschlüsselung ausgehender KIM-Nachrichten mit der SMC-B-Karte
  • Optionale Signierung von Anhängen mit der nonQES der SMC-B-Karte
  • Automatischer Versand von eAU und EBZ-Nachrichten, sofern das Praxiskonto bei der eAU-Erstellung für den Versand gewählt wurde.

Die automatisierten Abläufe sind mit einem Praxiskonto möglich, da der verknüpfte Praxisausweis (SMC-B) i.d.R. dauerhaft im Kartenterminal steckt. Durch die (fast) täglichen eGK-Einlesungen befindet sich der SMC-B im Status „verified“ und erfüllt damit die Voraussetzungen für die Funktionalitäten im Praxiskonto.

FAQ

Clientmodule

Hinweis: Verwenden Sie bei der Clientmodul-Konfiguration immer die feste IP-Adresse des Hostsystems, auf dem das KIM-Clientmodul installiert ist. Nicht empfohlen ist die Verwendung von localhost oder 127.0.0.1.
  Clientmodul POP3 mit TLS Clientmodul SMTP mit TLS
AKQUINET pop3s://<IP-Adresse des KIM-Clientmodul-Hostsystems>:995 smtps://<IP-Adresse des KIM-Clientmodul-Hostsystems>:465
Arvato
T-Systems
CGM pop3s://<IP-Adresse des KIM-Clientmodul-Hostsystems>:8995 smtps://IP-Adresse des KIM-Clientmodul-Hostsystems>:8465

Provider

  POP3 SMTP
AKQUINET mail.akquinet.kim.telematik:995 mail.akquinet.kim.telematik:465
Arvato mail.arv.kim.telematik:995 mail.arv.kim.telematik:465
CGM <spezifische-mail-domain>:995 <spezifische-mail-domain>:465
T-Systems 100.102.1.169:995 100.102.1.169:465
Hinweis: Bei neueren Versionen des KIM-Clientmoduls von T-Systems kann es erforderlich sein, statt der IP-Adresse den Servernamen (FQDN) zu verwenden. Bitte prüfen Sie die Dokumentation Ihres Clientmoduls oder stimmen Sie dies mit Ihrem Provider ab.

Beispielkonfiguration (T-Systems):

  • POP3: lb-mail.eqxffm.tsi.kim.telematik:995
  • SMTP: lb-mail.eqxffm.tsi.kim.telematik:465

Das Protokoll der URL ist abhängig von der Clientmodul- bzw. Provider-Konfiguration:

TLS Protokoll
ohne

pop3

smtp

mit

pop3s

smtps

 

How-to-Zusammenfassung

Ports ändern

Hinweis: Sofern keine neuere charly-Version vorliegt, aktualisiert der charly-Updater ausschließlich den charly-Java-Server und nimmt dabei die Port-Änderungen vor. Falls eine neuere charly-Version verfügbar ist, aktualisiert der charly-Updater zusätzlich die charly-Version.

Voraussetzungen

  • Der charly-Updater liegt auf dem charly-Server (Download Windows bzw. Download macOS).
  • Der charly-Server verfügt über eine Internetverbindung.

  • Das Ausführen des charly-Updaters ist vorbereitet:

    1. Schalten Sie alle charly-Arbeitsplätze (Clients) aus.
    2. Schließen Sie auf dem charly-Server alle Programme.
    3. Führen Sie auf dem charly-Server eine Datensicherung durch.
    4. Starten Sie den charly-Server neu.
    5. Melden Sie sich mit Administratorrechten am charly-Server an.
    6. Deaktivieren Sie auf dem charly-Server den Virenscanner für den Zeitraum des Updates.

Vorgehensweise

  1. Starten Sie den charly-Updater.
  2. Folgen Sie den Anweisungen des charly-Updater-Assistenten bis zu der Maske für die Konfiguration der Ports für den SSL-Proxy sowie für den messaging-Service.
  3. Ändern Sie den bzw. die Ports.

  4. Folgen Sie weiter den Anweisungen des charly-Updater-Assistenten.

    • Der charly-Updater führt die Port-Änderungen für die Services durch.
  1. Öffnen Sie auf dem Server folgendes Verzeichnis:
    <charly-Installationspfad>\Solutio\Server\ncjs\
  2. Legen Sie in diesem Verzeichnis das Verzeichnis „conf2“ und darin das Verzeichnis „messaging“ an:
    <charly-Installationspfad>\Solutio\Server\ncjs\conf2\messaging\
  3. Legen Sie in dem Verzeichnis „messaging“ eine Textdatei an und benennen Sie diese mit „application.yml“.

  4. Kopieren Sie die folgende Einstellung in die application.yml:

    de.solutio.ncjs.messaging.broker.stomp.port:14712

  5. Ändern Sie den Port.

  6. Damit der messaging-Service die fertig bearbeitete application.yml verwendet, muss der messaging-Service gestoppt und anschließend wieder gestartet werden:

    • Windows

      1. Öffnen Sie die Administrator-Kommandozeile und geben Sie folgende Befehle ein:

        cd <charly-Installationspfad>\Solutio\Server\ncjs

      2. Stoppen Sie den messaging-Service:

        acd.bat stop messaging

      3. Starten Sie den messaging-Service:

        acd.bat start messaging

    • macOS

      1. Öffnen Sie das Terminal und geben Sie folgende Befehle ein:

        cd <charly-Installationspfad>/Solutio/Server/ncjs

      2. Stoppen Sie den messaging-Service:

        sudo ./acd.sh stop messaging

      3. Starten Sie den messaging-Service:

        sudo ./acd.sh start messaging

  7. Prüfen Sie in charly-Web in der Perspektive Administration > Systemstatus > Komponenten ob der messaging-Service gestartet ist.

Telematikinfrastruktur (TI) einrichten

  1. Gehen Sie in die Menüleiste unter Hilfe > Konnektor-Operationen (TI).

    • Ein Fenster öffnet sich.
  2. Wählen Sie aus der Dropdownliste Konnektoren den Konnektor, für den Sie den Test durchführen möchten.
  3. Wählen Sie aus der Dropdownliste Aufrufkontexte den Aufrufkontext, für den Sie den Test durchführen möchten.

  4. Klicken Sie auf den gewünschten Button im Bereich Operationen.

    • Der Status wird im Log-Bereich ausgegeben.

KIM-Konto erstellen

Hinweis: Die Einrichtung und Verwaltung der KIM-Konten erfolgt inzwischen komfortabler in charly-Web.

Wir empfehlen, neue KIM-Konten ausschließlich in charly-Web anzulegen und Änderungen an bestehenden KIM-Konten nur noch in charly-Web vorzunehmen.

Der Abruf der KIM-Postfächer und der Versand von Nachrichten erfolgt aktuell weiterhin im charly-Client über die Menüleiste > Bearbeiten > KIM4charly.

Weitere Informationen finden Sie unter: KIM-Konto.