AlwinPro Care Modul Schnittstelle TV-Steuerung

Transkript

1 AlwinPro Care Modul Schnittstelle TV-Steuerung Beschreibung AlwinPro Care bietet die Möglichkeit TV für tageweise abzurechnen und stellt für die Freischaltung der Leistung einen Authentifizierungsserver bereit. Dabei kann zwischen verschiedenen TV-Diensten (Spartenkanälen) unterschieden werden. TV-Server können über den Authentifizierungsserver die freigeschalteten TV-Dienste für einzelne Patienten abfragen. Der TV-Server muss dafür sorgen, dass die dem Patienten zugeordneten TV- Geräte entsprechend freigeschaltet werden und die Leistung bereitgestellt wird. Dies kann zum Beispiel über die Decodierung des TV-Signals über die SetTopBox oder Freischaltung des Audio-Signals am Patiententelefon ermöglicht werden. Bitte beachten Sie, dass der TV-Server nicht Bestandteil von AlwinPro ist. Für die Kommunikation mit dem TV-Server stellt der AlwinPro Care Authentifizierungsserver zwei Schnittstellen zur Verfügung: 1. Über das RADIUS Protokoll nach RFC 2865/2866 können unterschiedliche TV-Dienste, die für eine Smartcard-ID freigeschaltet sind, authentifiziert werden. Der RADIUS-Parameter für den Benutzernamen wird für die Übermittlung der Smartcard-ID verwendet. Für die Kennung der unterschiedlichen TV-Dienste wird ein AVP Wertepaar verwendet. Der Typ ist über die Konfigurationsdatei einstellbar. 2. Für die Abfrage der freigeschalteten TV-Dienste stellt der Authentifizierungsserver einen Webservice zur Verfügung (siehe Schnittstellenbeschreibung). Die Zuordnung der TV-Geräte zu den Patienten wird in AlwinPro Care verwaltet und über die Smartcard-ID aufgelöst. Die Smartcard-ID wird als Eigenschaft an der physikalischen Nebenstelle im AlwinPro Organigramm beim Einrichten des Systems eingetragen (Smartcard-ID ist lediglich der Name des Eigenschaftsfeldes in AlwinPro und kann eine beliebige Kennung sein). Somit ist eine eindeutige Zuordnung der TV-Geräte zu den Patienten über deren physikalischen Nebenstelle möglich. AlwinPro Care Modul Schnittstelle TV-Steuerung Stand 06/2012 aurenz GmbH Alle Rechte vorbehalten Seite 1 von 7

2 Über die Grundeinstellungen können Kostenartikel für die TV-Dienste definiert werden, die bei der Buchung abgerechnet werden. Bei der Definition der Kostenartikel erfolgt über eine eindeutige Kennung (Produkt-ID) die Zuordnung zu den TV-Diensten des TV-Servers. Die TV-Dienste können bequem über die Patientenverwaltung in AlwinPro Care freigeschaltet und abgerechnet werden. Dazu wird der gewünschte TV-Dienst bei den Patienteneigenschaften aktiviert. Nach erfolgreicher Abbuchung der dafür fälligen Tagesgebühr (Kostenartikel) wird der TV-Dienst über den Authentifizierungsserver freigeschaltet. AlwinPro Care Modul Schnittstelle TV-Steuerung Stand 06/2012 aurenz GmbH Alle Rechte vorbehalten Seite 2 von 7

3 Lizenzierung Das Modul wird auf Teilnehmerebene lizenziert. Demnach richtet sich der Modulpreis nach den in AlwinPro Care freigeschalteten Teilnehmern. Eine Lizenz für x Teilnehmer bedeutet für den Authentifizierungsserver x gleichzeitig gültige TV-Zugänge. Der Authentifizierungsserver kann auf einem separaten Rechner installiert werden. Es gelten hierfür die gleichen System-Mindestvoraussetzungen wie für AlwinPro Care. Bedienung und Konfiguration über Weboberfläche Übersicht über aktuell angelegte TV-Zugänge und TV-Dienste Manuelles Anlegen, Löschen, Verlängern von TV-Zugängen und TV-Diensten Konfiguration sämtlicher Einstellparameter (IP-Adressen, TV-Dienste etc.) Log-Fenster für Unterstützung bei der Fehlersuche AlwinPro Care Modul Schnittstelle TV-Steuerung Stand 06/2012 aurenz GmbH Alle Rechte vorbehalten Seite 3 von 7

4 Leistungsbeschreibung RADIUS Server für die Authentifizierung der TV-Zugänge und Dienste nach RFC 2865/2866 WebService für das Abfragen gültiger TV-Zugänge und Dienste Verwendung nur in Verbindung mit AlwinPro Care möglich Installation des Authentifizierungsservers als Service Lizenzierung gemäß der AlwinPro Care Teilnehmer Voraussetzung AlwinPro Care Modul Internet-Authentifizierungsserver AlwinPro Care Modul Schnittstelle TV-Steuerung Stand 06/2012 aurenz GmbH Alle Rechte vorbehalten Seite 4 von 7

5 Schnittstellenbeschreibung Webservice Übertragungsprotokoll Die Verbindung zwischen TV-Server und dem Authentifizierungsserver ist eine Client/Server-Verbindung. Dabei tritt der TV-Server immer in der Rolle des Client auf. Befehle und Antworten werden in XML codiert und über HTTP übertragen. Dabei wird für jede Anfrage eine neue HTTP-Verbindung erzeugt, eine einzige XML-Anfragedatei gesendet und in der gleichen Verbindung eine einzige XML-Ergebnisdatei empfangen (SOAP). Zur verschlüsselten Übertragung wird SSL angeboten. Authentifizierung Die Verbindung ist nicht Status orientiert. Daher muss bei jeder Anfrage eine neue Authentifizierung erfolgen. Die Authentifizierung erfolgt durch die in der Anfrage mit gesendeten Anwender-Daten. Fehlerbehandlung Die Fehlerbehandlung erfolgt teilweise auf HTTP Ebene, teilweise in den XML Antworten. Auf HTTP Ebene gibt es folgende Fehlerbehandlung: 400 Bad Request Die Anfrage ist ungültig. Der XML-Befehl ist syntaktisch falsch oder enthält keine bekannten Elemente. Funktion ListByServiceType Diese Funktion dient dem Abfragen der vorhandenen User mit den aktivierten Artikel-Nummern eines bestimmten Service. Parameter ServiceType Username Password (Typ des Service, für welchen die Daten abgefragt werden. Z.B. 1 = TV) Parameter der Rückgabe User (Daten eines Users) ID (Kennung des Users, z.b. die Smartcard-ID bei TV) ArticleNumber (Freigeschaltete Artikel-Nummer) AlwinPro Care Modul Schnittstelle TV-Steuerung Stand 06/2012 aurenz GmbH Alle Rechte vorbehalten Seite 5 von 7

6 ResultCode 0 = Abfrage erfolgreich 9000 = Allgemeiner Fehler 9001 = Fehler in der XML-Struktur 9100 = Authentifizierung (Username und Password ungültig. Ggf. auch IP-Adresse nicht zulässig) 9101 = ServiceType ungültig 9xxx = Fehlercodes, die nicht dem Format 9xxx entsprechen, sind interne Fehler. Diese werden hier nicht weiter aufgeschlüsselt. Funktion Authenticate Diese Funktion dient zum Authentifizieren (Test, ob ein User einen bestimmten Service nutzen darf). Parameter: ServiceType (Typ des Service, für welchen die Daten abgefragt werden. Z.B. 1 = TV) ID (z.b. die Smartcard-ID) ArticleNumber (Artikel, der authentifiziert werden soll. Dieser kann für manche Service-Typen entfallen nicht bei TV) Username Passwort AlwinPro Care Modul Schnittstelle TV-Steuerung Stand 06/2012 aurenz GmbH Alle Rechte vorbehalten Seite 6 von 7

7 Parameter der Rückgabe / ResultCode 0 = Authentifizierung erfolgreich 9000 = Allgemeiner Fehler 9001 = Fehler in der XML-Struktur 9100 = Authentifizierung (Username und Password ungültig. Ggf. auch IP-Adresse nicht zulässig) 9101 = ServiceType ungültig 9102 = Artikel nicht frei geschaltet 9xxx = Fehlercodes, welche nicht dem Format 9xxx entsprechen, sind interne Fehler, welche hier nicht weiter aufgeschlüsselt werden: AlwinPro Care Modul Schnittstelle TV-Steuerung Stand 06/2012 aurenz GmbH Alle Rechte vorbehalten Seite 7 von 7