Änderungshistorie:

Allgemein

Sobald das Audit erfolgreich abgeschlossen ist und Sie die Zertifizierung erhalten haben, können Sie die Schnittstelle final in die Produktivumgebung Ihrer Software oder Plattform integrieren.

• Hierzu stellt Ihnen die kv.digital einen Zugangslink zur Produktivumgebung sowie die erforderlichen Zugangsdaten bereit (OAuth2 mit dem Client‑Credential‑Flow).

• Für die Nutzung ist außerdem eine VPN‑Verbindung zwischen den vertrauenswürdigen Umgebungen der Client‑ und der Server‑Systeme erforderlich, die zur sicheren Speicherung des Schlüsselmaterials Client‑seitig in Hardware ausgelegt ist.

Anschließend können Sie Termine aus der Produktivumgebung des 116117 Terminservice über Ihr System vermitteln.

Voraussetzungen für die Anbindung an das Produktivsystem

• Erfolgreich abgeschlossenes Audit
• Gültige Zertifizierung (gilt nur für die Schnittstelle gemäß § 370a Absatz 2 SGB V)
• Bereitschaft zur VPN-Anbindung (inkl. sicherer Hardware für Schlüsselmaterial)
• OAuth2-Authentifizierung (Client-Credentials-Flow)

Hinweis

Die Kommunikation erfolgt ausschließlich im Ticket-System der kv.digital. 

Darüber hinaus wird die Plattform Cryptshare (https://tausch.kbv.de) genutzt für

• den Versand der Zugangsdaten 
• den Empfang des CSRs für die VPN-Verbindung 

Schritt 1: Anmeldung zur Integration

Bitte erstellen Sie im Serviceportal im Projekt "Integrationsportal 116117 Terminservice" ein Ticket und geben Sie bitte folgendes an:

1. Zusammenfassung: Produktivgang <Name Ihrer Organisation> / <Schnittstelle> 
2. Beschreibung: Name des Ansprechpartners für Produktivgang
   • E-Mail-Adresse für Kommunikation inkl. Austausch signiertes Zertifikat
3. Auswahl der Schnittstelle, für die die Integration beantragt wird 
4. Angabe des geplanten Produktivgangs
5. optional: Unter Anfrageteilnehmer können Sie weitere Personen aus Ihrer Organisation hinzufügen. Registrierung vorausgesetzt.

Wichtig: Planen Sie mindestens 20 Arbeitstage für die Anbindung ein. 

Im Anschluss prüft das Team Anwendungen & Support die Angaben auf Richtigkeit und Vollständigkeit:

• Vollständige Angaben → Weiterbearbeitung
• Unvollständige Angaben → Rückfrage zur Ergänzung
• Kein Audit/Zertifizierung → Ticket wird geschlossen

Schritt 2: Bereitstellung der Zugangsdaten

Nach erfolgreicher Prüfung erstellt das Team Anwendungen & Support die Zugangsdaten und sendet diese,nach Hinterlegung im 116117 Terminservice an die angegebene Adresse über die Plattform Cryptshare (https://tausch.kbv.de) vom Audit-Postfach (audit@kv.digital) zu. Die Hinterlegung kann einige Tage in Anspruch nehmen. Des Weiteren wird das Passwort für den Abruf auf Cryptshare an die angegebene Adresse gesendet. Eine Anleitung zur Benutzung der Plattform finden Sie hier.

Wichtig: Die Zugangsdaten sind erst nach erfolgreicher VPN-Einrichtung nutzbar.

Schritt 3: VPN-Anbindung

Für den Zugriff auf die Produktivumgebung ist eine sichere VPN-Verbindung erforderlich.

So gehen Sie vor:

1. Sie erhalten vom Support-Team eine Aufforderung

2. Erstellen Sie einen CSR (Certificate Signing Request)

3. Senden Sie den CSR über Cryptshare an audit@kv.digital:

4. Senden Sie zusätzlich per E-Mail an audit@kv.digital:

   • das gewählte Passwort
   • die Tracking-ID

5. Sie erhalten anschließend Ihr signiertes Zertifikat

Alle weiteren Informationen für die VPN-Anbindung finden Sie unter 116117 Terminservice Schnittstellen - Anbindung via VPN.