KfL - ubtue/tuefind GitHub Wiki
Diese Seite dient der Dokumentation der Prozesse rund um das Kompetenzzentrum für Lizensierung (KfL).
Grundprinzip
Das KfL stellt Zugänge für freigeschaltete Lizenzen über einen Reverse Proxy zur Verfügung, siehe HAN-Server.
Hinweis: Das KfL stellt mehrere Arten von Lizenzen zur Verfügung (z.B. auch Nationallizenzen). Der hier beschriebene Workflow gilt nur für FID-bezogene (=Community?-)Lizenzen.
Zugangsbeschränkung
Speziell für die Tübinger FIDs gilt, dass die Authentifizierung direkt über das TueFind-Benutzerkonto erfolgt. Hierfür wurden verschiedene Anpassungen durchgeführt. Ein separater Login auf der KfL-Seite ist dadurch nicht mehr notwendig. Bei Zugriffen übergibt TueFind eine anonymisierte Benutzer-ID an den HAN-Server, über den im Zweifelsfall (auf manuelle Anfrage des KfL mit Angabe der Guid) auf unserer Seite ein Benutzer zugeordnet und im Bedarfsfall für den Zugriff gesperrt werden kann (erfolgt direkt in der DB über user.tuefind_license_access_locked = 1). Dem Benutzer wird dann der Zugriff verweigert und es wird eine entsprechende Fehlermeldung angezeigt.
Notwendige Informationen für TueFind
Datenfluss
Metadaten werden vom KfL in FIDELIO bereitgestellt. Die Metadaten werden durch das BSZ in den K10plus eingespielt. Wir erhalten die Datensätze mit den regulären Abzügen vom BSZ.
Konfiguration
Eine Lizenz kann entweder für einen einzelnen Titel (z.B. einzelnes E-Book) oder auch für mehrere Titel (z.B. E-Book-Paket) gültig sein. Die Lizenz muss vorab durch das KfL manuell im HAN-Server freigeschaltet werden. Wir benötigen pro Lizenz mindestens 2 Informationen:
- Lizenz-ID, z.B. "rx-hdr"
- Entitlement (geheimer Lizenzschlüssel). Kann beliebig lang sein z.B. "123456789123456789"
- (Außerdem haben wir vom KfL bereits einen Encryption Key erhalten. Dieser gilt übergreifend für alle Lizenzen, muss also nicht pro Lizenz neu angefordert werden.)
- Optional: Bei uns intern kann festgelegt werden ob der Zugriff nur für Benutzer aus dem DACH-Raum freigeschaltet werden soll. Die Prüfung erfolgt gegen die Länderangabe im Benutzerkonto.
Da Entitlement + Encryption Key geheim sind, sind diese nicht auf GitHub zu finden. Sie liegen direkt auf den entsprechenden Servern im local_overrides-Verzeichnis. Die entsprechende Datei wird je nach System in der entsprechenden config/vufind/tuefind.ini eingebunden.
Metadaten
| PICA | MARC21 | Beschreibung | Beispiel |
|---|---|---|---|
| 7133 | LOK 85640 | URL auf den HAN-Server inkl. Lizenz-ID. Notwendig für die Zuordnung innerhalb von TueFind, welche Lizenz für den Zugriff auf diesen Titel verwendet wird. | Ist die Lizenz nur für 1 Monografie gültig kann sie kurz ausfallen: http://proxy.fid-lizenzen.de/han/rx-hdr/ Gilt die Lizenz für mehrere Titel (z.B. bei eBook-Paketen) muss das einzelne Dokument identifiziert werden können, z.B. http://proxy.fid-lizenzen.de/han/rx-ebookcentral/ebookcentral.proquest.com/lib/fidreli/detail.action?docID=4397556 |
Zugriffs-URL von außen
Sind Metadaten + Lizenz korrekt hinterlegt, so wird in der Volltitelanzeige ein entsprechender Zugriffslink angezeigt. Beim Öffnen des Links wird eine Login-Prüfung durchgeführt.
Es ist möglich, von außen direkt zu dieser Seite zu springen, z.B. mit folgendem URL-Schema (Beispiel RelBib): https://relbib.de/redirect-license/1677766123
Statt der K10plus-PPN kann auch eine andere ID verwendet werden, sofern ein Präfix angegeben wird: https://relbib.de/redirect-license/(DE-599)ZDB2985306-0
Das gilt potentiell für alle IDs mit Präfix die im Datensatz unter MARC21 035a angegeben sind, insb. auch (EBP) falls vorhanden.
Besonderheiten der FID-Systeme
IxTheo
Lizenz-Präfix: Noch nicht definiert
Für IxTheo wurde der Prozess noch nicht aufgesetzt.
RelBib
Lizenz-Präfix: "rx-"
Hinweise zum Datenfluss:
- Vor der Einspielung in FIDELIO wird vom KfL in den Titeldaten ein spezifischer Proxy‑Link ergänzt, zudem werden die Daten durch Kennzeichen wie etwa das Produktsigel und das FID‑Kennzeichen (hier: FID‑REWI‑DE‑21) angereichert.
- Das BSZ spielt die FIDELIO-Datensätze der PDA-Ebooks in den K10plus-Hauptbestand ein und reichert sie mit unserem TUIXTH-Exemplarsatz an: Dieser enthält den buchspezifischen Proxy-Link in PICA-Feld 7133
[http://proxy.fid-lizenzen.de/han/rx-ebookcentral/ebookcentral.proquest.com/lib/fidreli/detail.action?docID=<ID>]und das Abrufzeichen rwpq in PICA-Feld 8012. Außerdem sollten in den Titeldaten noch die PICA-Felder 0575 mteo und 5056 0 (ehemaliges SSG-Kennzeichen) ergänzt werden.
Für RelBib ist die Lizenz bereits für das Handbuch der Religionen aktiv: https://relbib.de/Record/1677766123
Es waren bereits weitere Lizenzen für E-Book-Pakete im Gespräch, wobei die Lizenzverhandlungen aktuell noch andauern.
KrimDok
Lizenz-Präfix: "kx-"
Für KrimDok sind bereits Lizenzen aktiv, z.B. für die E-Book-Pakete von Nomos (Strafrecht und Kriminologie) sowie von Duncker & Humbloth. Die Vorgehensweise unterscheidet sich von RelBib, da bei KrimDok primär Backlist-Titel eine Rolle spielen. Die Titel wurden vom E-Book-Pool (EBP) über den K10plus nach KrimDok ausgespielt.
Hinweise zum Datenfluss:
- Sollte möglichst analog zu RelBib sein
- Das lokale Abrufzeichen in Feld 8012 verwenden wir (Religionswissenschaft) hauptsächlich, um damit eine Möglichkeit zu erhalten die Sammlung als Ganzes aufzurufen. Theoretisch ginge das auch mit dem Paketsigel. Da vieles aber schon über lokale Abrufzeichen bei uns läuft, würde es auch nicht schaden, dieses zu vergeben. Das müsste nur mit Martina Kellmeyer vorab abgestimmt werden (sie prüft dann, ob das Abrufzeichen noch „frei“ ist). Auch die Belegung der Felder 0575 und 5056 wird beim FID Kriminologie entsprechend angepasst werden müssen, da sie ja andere Kennungen verwenden als wir.
Sonstiges
- Die KfL-IDs werden bei uns in Solr indexiert, d.h. man kann z.B. mittels "kfl:*" nach allen Titeln suchen in denen entsprechende Metadaten hinterlegt sind.