TracePass
Referenz

Zugangsbeschränkte Passdaten

Wie ein Partner oder eine Behörde zugangsbeschränkte Passfelder mit einer Zugangsberechtigung (pa_-Token) liest: ?access= oder Bearer, Rollenfilter, Caching.

Ein veröffentlichter Pass zeigt seine öffentlichen Felder jedem. Andere Felder sind auf die Parteien beschränkt, die sie brauchen: einen Reparaturbetrieb, einen Recycler, einen Käufer, eine Marktüberwachungsbehörde. Der Wirtschaftsakteur gibt einer solchen Partei eine Zugangsberechtigung, ein pa_-Token, und die Partei legt es beim Lesen des Passes vor. Diese Seite beschreibt, was der Inhaber sendet und was zurückkommt.

Einen Pass mit einer Berechtigung lesen

Senden Sie die Berechtigung an die eigene Adresse des Passes, die, auf die der QR-Code verweist, auf einem von zwei Wegen: als Authorization: Bearer pa_… oder als Query-Parameter ?access=pa_…. Der Bearer-Header passt für Programme, der Query-Parameter für einen Link, doch eine URL landet im Browserverlauf und in Server-Logs; bevorzugen Sie daher den Header, wo es geht. Die Berechtigung gilt für die Passseite sowie für die JSON-LD-, PDF-, EPCIS- und Datenansicht.

bash
curl -H "Authorization: Bearer pa_REDACTED_xxxxxxxxxxxx" \
  -H "Accept: application/ld+json" \
  https://id.tracepass.eu/01/99999999999997/21/6B27A0000001

Dieselbe Anfrage mit dem Query-Parameter:

text
https://id.tracepass.eu/01/99999999999997/21/6B27A0000001?access=pa_REDACTED_xxxxxxxxxxxx

Ein pa_-Token dient dem Lesen eines veröffentlichten Passes. Es authentifiziert keine Aufrufe von /api/v1, die einen tp_-API-Schlüssel oder OAuth verlangen. Eine Berechtigung, die unbekannt, abgelaufen, widerrufen ist oder diesen Pass nicht abdeckt, wird nicht abgewiesen: Die Anfrage erhält die öffentliche Ansicht, als wäre keine Berechtigung gesendet worden.

Was die Berechtigung sichtbar macht

Der Wirtschaftsakteur stellt jede Berechtigung auf eine benannte Rolle aus: Reparaturbetrieb, Wiederaufarbeiter, Betrieb für Umnutzung, Recycler, Abfallbehandler, Schulungszentrum, Käufer oder dessen Beauftragter, Behandlungsanlage für Altfahrzeuge oder Elektroaltgeräte, Marktüberwachung, benannte Stelle, Kommission, Zoll oder sonstige. Sie gilt für das gesamte Unternehmen, für ausgewählte Produkte oder ausgewählte Pässe. Behördenrollen sehen ihre gesamte Stufe.

Bei Batterien bestimmt die Rolle, welche Daten nach Anhang XIII der Inhaber sieht: Ein Reparaturbetrieb sieht die Ersatzteil- und Demontagedaten, ein Käufer die Daten der von ihm gekauften Batterie, und so weiter. Die Zuordnung folgt dem Entwurf des Durchführungsrechtsakts der Kommission nach Artikel 77 Absatz 9 der Batterieverordnung. Dieser Rechtsakt ist nicht angenommen, und der Entwurf kann sich ändern; betrachten Sie die Zuordnung daher als vorläufig.

Ein Feld, das die Rolle nicht abdeckt, wird nicht stillschweigend weggelassen. Die Passansicht zeigt es als „Nicht Teil dieser Zugangsberechtigung“ (in der Sprache der Ansicht), sodass der Inhaber ein durch die Berechtigung verborgenes Feld von einem Feld unterscheiden kann, das der Pass nicht enthält. Daten außerhalb der Felder, etwa Herkunftslinie, Servicehistorie und EPCIS-Ereignisse, folgen derselben Regel.

Laufzeit und Abruf-Protokoll

Eine Berechtigung läuft standardmäßig nach 12 Monaten ab. Die Berechtigung eines Käufers hat kein Ablaufdatum und endet, wenn ein Eigentümerwechsel der Batterie erfasst wird. Der Wirtschaftsakteur kann jede Berechtigung jederzeit widerrufen. Bei der Ausstellung werden der Zweck und die vom Wirtschaftsakteur geprüften Nachweise festgehalten. Diese Nachweise werden erfasst, nicht verifiziert: TracePass prüft nicht die Identität des Inhabers.

Jeder Abruf, der über eine Berechtigung Inhalte liefert, wird protokolliert und je Berechtigung, Pass, Kanal (Seite, JSON-LD, PDF, EPCIS, Daten) und Tag gezählt. Das Protokoll enthält keine IP-Adresse.

Caching

Eine Antwort auf eine Berechtigung hat Cache-Control: private, no-store mit Vary: Authorization. Legen Sie sie nicht in einem gemeinsam genutzten Cache ab und geben Sie sie nicht weiter: Sie enthält Daten, die die öffentliche Ansicht nicht enthält.