Skip to content

Latest commit

 

History

History
454 lines (339 loc) · 14.2 KB

LDAP_Attribute.adoc

File metadata and controls

454 lines (339 loc) · 14.2 KB

🗂️ LDAP-Attribute im gematik Verzeichnisdienst

1. Übersicht

Attribut 0..N Bezeichnung

Identifikatoren

telematikID

1..1

Telematik-ID

domainID

1..N

Sektor-ID

Namen

displayName

1..1

Anzeigename

cn

1..1

Name

otherName

0..1

Alternativer Name

organization

0..1

Organisation

givenName

0..1

Vorname

sn

0..1

Nachname

title

0..1

Titel

Adressdaten

streetAddress

1..1

Straße und Hausnummer

postalCode

1..1

PLZ

localityName

1..1

Ort

stateOrProvinceName

1..1

Bundesland oder Region

countryCode

1..1

Landeskürzel

Berufliche Informationen

professionOID

1..N

Berufsgruppe

specialization

1..N

Fachgebiet

entryType

1..1

Typ des Eintags

Anwendungsdaten

mail

0..N

KIM-Adresse

komLeData

0..N

KIM-Adresse mit Version

Zertifikate

userCertificate

0..N

Zertifikat

Systemdaten

dataFromAuthority

1..1

Verwaltet durch Kartenherausgeber?

personalEntry

1..1

Eintrag einer natürlichen Person?

changeDateTime

1..1

Geändert am

2. Identifikatoren

2.1. telematikID

Telematik-ID ist ein eindeutiger Identifikator einer Institution oder einer Person in der TI. Spezifiziert in gemSpec_PKI, Kapitel 4.7.

2.2. domainID

Die sektorspezifische Kennung einer Institution oder einer Person.

Per Eintag können mehrere Kennungen angeben werden. Im Gegensatz zu TelematikID sind die domainID nicht eindeutig können in mehreren Einträgen gleichzeitig vorkommen.

Die Nutzung für die Sektoren wird in Kapitel Attributtabellen von Dokument gemILF_Pflege_VZD beschrieben.

  • Kassenärztliche Vereinigungen (SMC-B-Eintrag): Betriebsstättennummer der Praxis

  • Kassenzahnärztliche Vereinigungen (SMC-B Eintrag): Abrechnungsnummer

  • SMC-B-Eintrag für Apotheken: Nicht verwendet

  • HBA-Eintrag für Apotheker: Spezifisches Kennzeichen der Apotheker. Kann mehrfach vorkommen (0..100).

  • Krankenhäuser (SMC-B-Eintrag): Betriebsstättennummer des Krankenhauses

  • Psychotherapeuten (HBA-Eintrag): Spezifisches Kennzeichen der Psychotherapeuten. Kann mehrfach vorkommen (0..100).

  • Ärzte (HBA-Eintrag): Spezifisches Kennzeichen der Ärzte. Kann mehrfach vorkommen (0..100).

  • Zahnärzte (HBA-Eintrag): Spezifisches Kennzeichen der Zahnärzte. Kann mehrfach vorkommen (0..100).

  • Gesetzlichen Krankenkassen (SMC-B-Eintrag): Institutionskennzeichen. Kann mehrfach vorkommen (0..100).

3. Namen

3.1. displayName

Dieses Attribut wird verwendet um vollen Namen einer Institution oder Person in GUI anzuzeigen.

Spezifiziert in RFC2798 Section 2.3

3.1.1. Personen (HBA)

Bei Personen wird displayName genutzt, um vollen Namen einer Person gegenüber dem Anwender darzustellen. Es wird empfohlen den Namen wie folgt anzugeben (Nachname, Vorname):

Dr. Mustermann, Manfred

3.1.2. Institutionen (SMC-B)

Bei Institutionen wird displayName genutzt, um den Namen einer Institution gegenüber dem Anwender darzustellen.

Praxis Dr. Sandra Meyer

3.2. cn

Eindeutiger Name einer Person oder Institution. LDAP unterstützt grundsätzlich mehrere Namen eines Objekts, in der TI wird jedoch meistens nur ein cn-Attribut verwendet, daher ist cn in der Regel identisch mit displayName.

Spezifiziert in RFC2256 Section 5.4

3.3. otherName

ℹ️
Es wird nicht mehr empfohlen dieses Attribut zu verwenden.

3.4. organization

Optionaler Name einer Organisation zu welcher diese Eintrag gehört.

Spezifiziert in RFC2256 Section 5.11

3.5. givenName

Alle Vornamen einer natürlicher Person. Vornamen sollen nur bei natürlichen Personen befüllt sein, bei Institutionen muss givenName leer bleiben.

Spezifiziert in RFC2256 Section 5.43

3.6. sn

Nachname eine natürlichen Person. Nachnamen sollen nur bei natürlichen Personen befüllt sein, bei Institutionen muss sn leer bleiben.

Spezifiziert in RFC2256 Section 5.5

3.7. title

Akademischer oder Adelstitel einer natürlichen Person.

Spezifiziert in RFC2256 Section 5.13

4. Adressdaten

Beispiel Attribute

Hallesches Ufer 21
88451 Dettingen
Baden-Württemberg
DE

streetAddress
postalCode localityName
stateOrProvinceName
countryCode

4.1. streetAddress

Straße und Hausnummer

Spezifiziert in RFC2256 Section 5.10

Kann als street abgekürzt werden

4.2. postalCode

Postleitzahl Spezifiziert in RFC2256 Section 5.18

4.3. localityName

Ort

Spezifiziert in RFC2256 Section 5.8

Kann als l abgekürzt werden

4.4. stateOrProvinceName

Bundesland oder Region

Spezifiziert ib RFC2256 Section 5.9

Kann als st abgekürzt werden

4.4.1. Gültige Werte für stateOrProvinceName in Deutschland:

  • Baden-Württemberg

  • Bayern

  • Berlin

  • Brandenburg

  • Bremen

  • Hamburg

  • Hessen

  • Mecklenburg-Vorpommern

  • Niedersachsen

  • Nordrhein-Westfalen

  • Rheinland-Pfalz

  • Saarland

  • Sachsen

  • Sachsen-Anhalt

  • Schleswig-Holstein

  • Thüringen

Zusätzliche KV-Regionen:
  • Nordrhein

  • Westfalen-Lippe

4.5. countryCode

Zweistelliger Landeskürzel aus dem Wertebereich ISO 3166-1 alpha-2

5. Berufliche Informationen

5.1. professionOID

Berufsgruppe oder Betriebsstätten-Typ innerhalb der Telematikinfrastruktur.

Spezifiziert in gemSpec_OID

Wertebereiche:

5.2. specialization

Der Wertebereich für specialization entspricht den in HL7 definierten und für ePA festgelegten Werten.

5.2.1. Personen (HBA)

Bildungsregel:
urn:as:{OID Codesystem}:{Code}

Beispiel für Facharzt Allgemeinmedizin:
urn:as:1.2.276.0.76.5.114:010

5.2.2. Institutionen (SMC-B)

Weitere Ressourcen:

Bildungsregel:
urn:psc:{OID Codesystem}:{Code}

Beispiel für Allgemeinmedizin:
urn:psc:1.3.6.1.4.1.19376.3.276.1.5.4:ALLG

5.3. entryType

Das Attribut wird automatisch aus professionOID berechnet. Werte werden primär durch ePA verwendet.

6. Anwendungsdaten

6.1. mail

Liste aller KIM-Adressen einer Person oder einer Institution. Zur Kompatibilität bleibt die KIM Mail Adresse in diesem Attribut zusätzlich zum Attribut komLeData erhalten.

mail: adresse1@anbieter.kim.telematik
mail: adresse2@anbieter.kim.telematik

6.2. komLeData

Liste von KIM-Adressen mit der zugehörigen KIM-Version

komLeData: 1.0,adresse1@anbieter.kim.telematik
komLeData: 1.5,adresse2@anbieter.kim.telematik

7. Zertifikate

7.1. userCertificate

X509-Zertifikate werden für Verschlüsselung der KIM-Nachrichten sowie bei der Berechtigungserteilung in der ePA verwendet.

Zertifikate werden als DER-kodierte Binary transportiert.

8. Systemdaten

8.1. holder

Enthält eine Liste von Organisationen, die für die Administration dieses Datensatzes berechtigt sind.

8.2. dataFromAuthority

Enthält TRUE wenn die Daten durch einen Kartenherausgeber eingestellt wurden.

8.3. personalEntry

Enthält TRUE wenn Eintrag eine natürliche Person beschreibt (einen Leistungsebringer) - d.h. einen HBA Empfänger. Enthält FALSE wenn es um einen Eintrag einer Institution handelt, d.h. SMC-B Empfänger.

8.4. changeDateTime

Zeitstempel der letzten Änderung. Wert wird bei jeder Aktualisierung durch VZD auf aktuelle Systemzeit gesetzt.

9. Beispiele

9.1. Darstellung von Personen und Institutionen in einer Liste

Typ Name Nachname Vorname Adresse PLZ Ort

🏥

Praxis Helga Freifrau Mondwürfel

Bahnhof Str. 13

91234

Nürnberg

👩‍⚕️

Oldenburg, Petra

Oldenburg

Petra

Hallesches Ufer 21

88451

Dettingen

personalEntry

displayName

sn

givenName

street

postalCode

localityName

10. Wer kann Attribute im LDAP VZD befüllen und ändern

LDAP-Directory Attribut Zertifikat Client KIM Anbieter

givenName

HBA

x

SMC-B

nicht verwendet

sn

HBA

x

SMC-B

Vom VZD als Kopie des Attributs displayName eingetragen

cn

HBA

Vom VZD als Kopie des Attributs displayName eingetragen

SMC-B

Vom VZD als Kopie des Attributs displayName eingetragen

displayName

HBA

x

SMC-B

x

streetAddress

HBA

x

SMC-B

x

postalCode

HBA

x

SMC-B

x

countryCode

HBA

x

SMC-B

x

localityName

HBA

x

SMC-B

x

stateOrProvinceName

HBA

x

SMC-B

x

title

HBA

x

SMC-B

nicht verwendet

organization

HBA

x

SMC-B

x

otherName

HBA

x

SMC-B

x

specialization

HBA

x

SMC-B

x

domainID

HBA

x

SMC-B

x

holder

HBA

x

SMC-B

x

maxKOMLEadr

HBA

x

SMC-B

x

personalEntry

HBA

x

SMC-B

x

dataFromAuthority

HBA

wird vom VZD eingetragen

SMC-B

wird vom VZD eingetragen

userCertificate

HBA

x

SMC-B

x

entryType

HBA

x

SMC-B

x

telematikID

HBA

x

x

SMC-B

x

x

professionOID

HBA

x

SMC-B

x

usage

HBA

x

SMC-B

x

description

HBA

x

SMC-B

x

mail

HBA

x

SMC-B

x

komLeData

HBA

x

SMC-B

x

changeDateTime

HBA

wird vom VZD eingetragen

SMC-B

wird vom VZD eingetragen

Erläuterungen zu den Spalten:

  • Zertifikat

    • Der Wert für das LDAP Attribut wird dem Zertifikat entnommen.

    • Bei Hinzufügen eines Zertifikats wird das LDAP Attribut aktualisiert.

  • Client

    • Der Wert für das LDAP Attribut wird durch den Client des Kartenherausgebers gepflegt.

  • KIM Anbieter

    • Der Wert für das LDAP Attribut wird durch den KIM-Abieter gepflegt.

Erläuterungen für spezielle Attribute:

  • personalEntry: Beim Löschen von Zertifikaten wird der Wert neu berechnet. Wenn alle Zertifikate gelöscht wurden, wird der Wert auf "FALSE" gesetzt.

  • Aus den Zertifikaten befüllte Attribute entryType, professionOID: Beim Löschen eines Zertifikats wird der Wert auf Basis aller verbleibender Zertifikate neu berechnet und gesetzt.

  • Alle aus den Zertifikaten befüllte Attribute (givenName, sn, personalEntry, telematikID, professionOID, entryType) werden beim Hinzufügen eines neuen Zertifikats aktualisiert bzw. ergänzt.

  • telematikID im VZD Basiseintrag: Wird aus dem Zertifikat befüllt. Kann in dem REST Interface zwar angegeben, aber nicht auf einen anderen Wert geändert werden.