Beschreibung und Bedienungsanleitung. Inhaltsverzeichnis: Abbildungsverzeichnis: Demo-Behörde und Fremd-bPK. Dipl.-Ing.

Transkript

1 Telefon: ++43 (316) Fax: ++43 (316) Inffeldgasse 16a / 8010 Graz / Austria Beschreibung und Bedienungsanleitung Demo-Behörde und Fremd-bPK Dipl.-Ing. Mario Ivkovic Graz, am 15. Februar 2007 Inhaltsverzeichnis: 1 Allgemeines Begriffsbestimmungen Dokumentenaustausch mit SZRB-Abfrage Bedienungsanleitung Konfiguration Lizenz und Source Code... 8 Abbildungsverzeichnis: Abb. 1.1: Szenario: Dokumentenaustausch mit SZRB-Abfrage... 4 Abb. 2.1: Demo-Behörde und Fremd-bPKs... 5 Abb. 2.2: Eintrag hinzufügen... 5

2 1 Allgemeines Dieses Dokument dient einerseits der Beschreibung der kostenlos vom EGIZ zur Verfügung gestellten Applikation Demo-Behörde und Fremd-bPKs, als auch einer allgemeinen Beschreibung der Rolle von Fremd-bPKs und verschlüsselten bpks beim Dokumentenaustausch. Zur Erstellung von Fremd-bPKs werden Zertifikate bzw. die darin enthaltenen öffentlichen Schlüssel benötigt. Diese Zertifikate können mit dem Fremd-bPK-CA Tool 1, welches ebenfalls kostenlos zur Verfügung gestellt wird, erzeugt und an die Stammzahlenregisterbehörde SZRB gesendet werden. 1.1 Begriffsbestimmungen Bereichsspezifisches Peronenkennzeichen bpk Auszug aus E-GovG 2 : 9. (1) Das bereichsspezifische Personenkennzeichen wird durch eine Ableitung aus der Stammzahl der betroffenen natürlichen Person gebildet. Die Identifikationsfunktion dieser Ableitung ist auf jenen staatlichen Tätigkeitsbereich beschränkt, dem die Datenanwendung zuzurechnen ist, in der das Personenkennzeichen verwendet werden soll (bereichsspezifisches Personenkennzeichen, bpk). Die Zurechnung einer Datenanwendung zu einem bestimmten staatlichen Tätigkeitsbereich ergibt sich - soweit sie nicht unter 17 Abs. 2 Z 1 bis 3 oder Abs. 3 fällt - aus ihrer Registrierung im Datenverarbeitungsregister oder aus der Standard- und Musterverordnung gemäß 17 Abs. 2 Z 6 DSG Das bpk ist somit ein eindeutiges Kennzeichen einer natürlichen Person für einen bestimmten Tätigkeitsbereich. Es ist technisch nicht möglich aus dem bpk einer Person Rückschlüsse auf deren Stammzahl vorzunehmen. Weiters ist es nicht möglich aus einem gegebenen bpk, das bpk für einen anderen Tätigkeitsbereich zu berechnen. Bei einer bereichsübergreifenden Kommunikation von Behörden ist es, für eine eindeutige Identifikation der Person, notwendig, das bpk des fremden Bereiches mitanzugeben. Da es, wie schon oben erwähnt, einer Behörde jedoch nicht möglich ist ein bpk für den anderen Bereich zu berechnen, wurde das verschlüsselte Fremd-bPK eingeführt. Fremd-bPK Auszug aus E-GovG: 13. (2) Ist es zum Zweck der eindeutigen Identifikation eines Betroffenen gemäß 10 Abs. 2 zulässig, von der Stammzahlenregisterbehörde ein bereichsspezifisches Personenkennzeichen anzufordern, ist dieses, sofern es sich um ein Fremd-bPK handelt - das ist ein bpk aus einem Bereich, in dem der Anfordernde nicht zur Vollziehung berufen ist - von der Stammzahlenregisterbehörde nur verschlüsselt zur Verfügung zu stellen. Die Verschlüsselung ist so zu gestalten, dass 1. nur derjenige entschlüsseln kann, in dessen Datenanwendung das bpk in entschlüsselter Form zulässigerweise verwendet werden darf (Abs. 3), und 2. durch Einbeziehung von zusätzlichen, dem Anfordernden nicht bekannten variablen Angaben in die Verschlüsselungsbasis das bpk auch in verschlüsselter Form keinen personenbezogenen Hinweis liefert Bundesgesetz über Regelungen zur Erleichterung des elektronischen Verkehrs mit öffentlichen Stellen (E-Government- Gesetz - E-GovG) 2

3 Eine Behörde kann sich von der SZRB, mit Hilfe der ihr bekannten Personendaten und der dazugehörigen bpk, ein Fremd-bPK für einen fremden Bereich berechnen lassen. Da dieses Fremd-bPK nur verschlüsselt zur Verfügung gestellt wird kann die Behörde daraus nicht das bpk der betreffenden Person für den fremden Bereich extrahieren. Die Behörde aus dem anderen Tätigkeitsbereich kann aber mit dem nur Ihr bekannten privaten Schlüssel das verschlüsselte Fremd-bPK entschlüsseln und somit das bpk extrahieren. In diesem Dokument ist mit Fremd-bPK stets die verschlüsselte Variante gemeint, da ja ohnehin nur solche von der SZRB zur Verfügung gestellt werden. Verschlüsseltes bpk Das verschlüsselte bpk ist, rein technisch gesehen, gleich aufgebaut wie das oben beschriebene verschlüsselte Fremd-bPK, mit dem einzigen Unterschied das es für den eigenen Bereich erstellt wurde und nicht wie üblich für einen fremden Bereich. Somit erhält man als Resultat der Entschlüsselung wieder das bereichsspezifische Personenkennzeichen für den eigenen Bereich. Für die Berechnung eines verschlüsselten bpks wird in der Regel keine Kommunikation mit der SZRB benötig, da ja alle für die Berechnung notwendigen Komponenten der jeweiligen Behörde bekannt sind. Wofür verschlüsselte bpks benötigt werden, wird anhand eines Beispieles im folgenden Kapitel näher erläutert. 1.2 Dokumentenaustausch mit SZRB-Abfrage In diesem Abschnitt wird die Verwendung von Fremd-bPKs und verschlüsselten bpks anhand eines praxisbezogenen Beispiels näher erläutert. Angenommen Behörde A möchte der Behörde B ein personenbezogenes Dokument anonymisiert zusenden. In diesem Fall bedeutet anonymisiert dass niemand außer diesen beiden Behörden aus den übertragenen Daten feststellen kann auf welche natürliche Person sich das übermittelte Dokument bezieht und dass keine der beiden Behörden das bpk der Person für den jeweils anderen Bereich erfährt. 3

4 SZRB Fremd-bPK B Fremd-bPK B bpk B 2. privater Schlüssel-B Behörde A 5. Dokument Fremd-bPK B Verschlüsseltes-bPK A 3. Behörde B 6. Dokument Verschlüsseltes-bPK A bpk A Verschlüsseltes-bPK A privater Schlüssel-A Abb. 1.1: Szenario: Dokumentenaustausch mit SZRB-Abfrage Ablauf: 1. Behörde A stellt, mit den Personendaten und der Ihr bekannten bpk für Ihren Bereich, eine Anfrage an das SZRB für ein Fremd-bPK für die Behörde B. Der Source-Code, des in diesem Dokument beschriebenen Werkzeuges, wird kostenlos vom EGIZ zur Verfügung gestellt und zeigt beispielhaft eine solche SZRB-Abfrage. 2. Behörde A bekommt, vorausgesetzt Sie besitzt genügend Rechte für diese Anfrage, das FremdbPK für Behörde B. Die Behörde A darf die erhaltene Fremd-bPK für mögliche weitere Kommunikationen mit der Behörde B auch speichern, womit eine SZRB Abfrage für diese Person in Zukunft entfallen kann. 3. Behörde A sendet das Dokument zusammen mit dem Fremd-bPK und dem verschlüsselten bpk an die Behörde B. 4. Behörde B kann das erhaltene Fremd-bPK mit ihrem privaten Schlüssel entschlüsseln, das bpk extrahieren und so das Dokument einer Person zuordnen. In einigen Fällen wird an dieser Stelle die Kommunikation abgebrochen. Falls jedoch die Behörde B das Dokument nur ergänzt oder möglicherweise Fragen dazu hat, muss Sie das Dokument wieder an die Behörde A zurücksenden. 5. Behörde B sendet das Dokument zusammen mit dem zuvor erhaltenen verschlüsselten bpk wieder an die Behörde A. Ohne dieses verschlüsselte bpk könnte die Behörde A das Dokument, vorausgesetzt es befinden sich keine Personendaten im Dokument, keiner Person zuordnen. 6. Behörde A kann das verschlüsselte bpk mit ihrem privaten Schlüssel entschlüsseln, das bpk extrahieren und so das Dokument wieder der ursprünglichen Person zuordnen. 2 Bedienungsanleitung In diesem Abschnitt wird kurz die Bedienung der Applikation Demo-Behörde und Fremd-bPKs beschrieben. 4

5 Abb. 2.1 zeigt die Applikation nach dem Starten. In diesem Beispiel wurden bereits einige Personen hinzugefügt um die Applikation mit typischen Werten darstellen zu können. Abb. 2.1: Demo-Behörde und Fremd-bPKs Jeder Eintrag in der Tabelle repräsentiert eine natürliche Person wobei zumindest die Felder Vorname, Nachname und Geburtsdatum ausgefüllt sein müssen. Das Feld bpk enthält, sofern vorhanden, das bpk der Person für den eigenen Bereich. Der eigene Bereich wird in Klammer neben der Spaltenbeschriftung bpk angezeigt (in diesem Beispiel T1). Das Feld Fremd-bPK enthält das Fremd-bPK der Person für den in Klammer angezeigten Bereich (in diesem Beispiel T2). Ein Klick mit der rechten Maustaste öffnet ein Kontext-Menü und zeigt aller zur Verfügung gestellten Funktionen: Eintrag hinzufügen: Mit dieser Funktion kann eine neue Person in die Datenbank aufgenommen werden. Abb. 2.2 zeigt das Dialogfenster welches für das Einfügen verwendet wird, wobei nur die ersten drei Felder zwingend ausgefüllt werden müssen. Das bpk kann vorerst leer gelassen werden. Abb. 2.2: Eintrag hinzufügen Einträge löschen: Mit dieser Funktion können eine oder mehrere Personen unwiderruflich aus der Datenbank gelöscht werden. bpk über SZRB berechnen: 5

6 Mit dieser Funktion wird mittels einer Anfrage an das SZRB das bpk der jeweiligen Person berechnet. Kann zu dieser Person ein eindeutiger Eintrag im ZMR gefunden werden wird das bpk berechnet und anschließend in der Datenbank gespeichert. Fremd-bPK über SZRB berechnen: Mit dieser Funktion wird das Fremd-bPK, mittels SZRB Anfrage, von der jeweiligen Person für den fremden Bereich ermittelt. Der Bereich wird mittels Konfigurations-Datei eingestellt. Verschlüsseltes-bPK berechnen: Mit dieser Funktion wird das verschlüsselte bpk berechnet. Da diese Berechnung von dem Werkzeug selbst durchgeführt werden kann es wird nur ein Zertifikat und das bpk für den eigenen Bereich benötigt wird keine Anfrage an die SZRB geschickt. Source-Code für die Berechnung von verschlüsselten bpks und Fremd-bPKs wird vom EGIZ kostenlos zur Verfügung gestellt. Import von BKU: Falls eine BKU vorhanden ist, kann mit dieser Funktion die Pesonenbindung über die SecurityLayer Schnittstelle abgefragt werden und daraus die, für einen Import benötigten, Personendaten ausgelesen und das bpk berechnet werden. 6

7 Export in eine XML Datei: Mit dieser Funktion wird ein XML Dokument erzeugt, welches für jede ausgewählte Person ein Element mit drei Kind-Elementen (RegisterEntryData, Fremd-bPK und Verschlüsseltes-bPK) enthält. Dieses Dokument symbolisiert ein solches wie es in Abb. 1.1 beschrieben wurde. Das Element RegisterEntryData enthält bei diesem Beispiel nur die Nummer des Eintrages in der Datenbank. Bei einem echten Dokumentenaustausch befinden sich hier die Informationen die ausgetauscht werden sollen. Die Elemente Fremd-bPK und Verschlüsseltes-bPK enthalten bereits solche Werte, wie Sie auch in einem realen Szenario verwendet werden würden. 3 Konfiguration Die beiden wichtigsten Konfigurationsdateien sind DemoClient.properties und pvp.1_8.xml im Unterverzeichnis resources. Die folgende Tabelle beschreibt alle über die Datei DemoClient.properties konfigurierbaren Werte. Feld Beschreibung Wert own_target Tätigkeitsbereich der Behörde. String foreign_target foreign_vkz encrypted_bpk_cert use_szr szr_url szr_keystore szr_keystore_pwd szr_truststore szr_pvp_file jdbc_url Tätigkeitsbereich für den Fremd-bPK ausgestellt werden. VKZ welches für die Fremd-bPK Berechnung verwendet wird. Zertifikat das benutzt wird um verschlüsselte bpks zu erstellen. Gibt an ob die SZRB genutzt werden soll. Wenn false kann keine bpk oder FremdbPK Berechnung über die SZRB erfolgen. Adresse unter der die SZRB zu erreichen ist. Der Keystore der das Zertifikat und den privaten Schlüssel enthält um sich gegenüber der SZRB zu authentifizieren. Das Passwort das benötigt wird um den Keystore zu entschlüsseln. Der Keystore der die vertrauenswürdigen Zertifikate der SZRB enthält. Wird für die SSL Verbindung mit der SZRB benötigt. Die Datei welche die PvP-Header enthält. Adresse unter der die Datenbank zu erreichen ist. Dieser Wert sollte in der Regel nicht verändert werden. String String Relativer oder absoluter Pfad der Datei. true oder false URL Relativer oder absoluter Pfad der Datei. String Relativer oder absoluter Pfad der Datei. Relativer oder absoluter Pfad der Datei. URL 7

8 Die hier beschrieben Applikation verwendet für die Kommunikation mit der SZRB den vom BMI kostenlos zur Verfügung gestellten Client 3. Mit der Datei pvp.1_8.xml wird der Client konfiguriert. Nähere Informationen zur Konfiguration des Clients entnehmen Sie bitte der beigefügten Datei SZRClient_readme.txt. Weitere Konfigurationsdateien sind DB.conf und log4j.config welche sich auch im Unterverzeichnis resources befinden. DB.conf ist die Konfigurationsdatei für die intern verwendete Mckoi Datenbank und sollte in der Regel nicht geändert werden. Mit der Datei log4j.config kann das Log-Verhalten der Applikation angepaßt werden 4. 4 Lizenz und Source Code Das hier beschriebene Werkzeug und der dazugehörige Source Code werden vom Bundeskanzleramt (BKA) und der Technischen Universität Graz (TU Graz) sowohl Organisationen der öffentlichen Verwaltung als auch der Privatwirtschaft kostenfrei zur Verfügung gestellt. Lizenzrechtlich kommt dabei die Open-Source-Lizenz der Apache Software Foundation in der Version 2.0 zur Anwendung. Dabei sind folgende Randbedingungen zu beachten: Die Open-Source-Lizenz bezieht sich allein auf jene Teile, an denen das BKA die Rechte hält. Das beschriebene Werkzeug verwendet Bibliotheken bzw. Module Dritter, die teils wiederum unter freien Software-Lizenzen stehen, oder auch kostenpflichtig sein können. Der Lizenznehmer hat für den Erhalt allfälliger Rechte selbst zu sorgen. Für den Betrieb in der eigenen Organisation sowie für eine eventuell notwendige Anpassung der Software an spezielle Randbedingungen und die Inbetriebnahme hat der Lizenznehmer selbst zu sorgen. Es wird darauf hingewiesen, dass es sich bei der zur Verfügung gestellten Software lediglich um einen Demonstrator handelt, der einer für den Produktionseinsatz erforderlichen Qualitätssicherung nicht unterzogen wurde. Die Software wird daher ohne Gewährleistung, Zusicherung von Eigenschaften oder Haftung zur Verfügung gestellt. 3 Kann über die Seite heruntergeladen werden. 4 Siehe dazu 8