Wie Kundenportal-Links Ablaufen

Ein Kundenportal-Link ist eine feste URL, die ein bestimmter Kunde ohne Anmeldung nutzen kann, um jede Rechnung und jedes Angebot zu durchsuchen, das Sie ihm geschickt haben. Anders als ein einmaliger Freigabelink, der an ein einzelnes Dokument gebunden ist, bleibt ein Portallink unbegrenzt nützlich, bis er abläuft oder Sie ihn widerrufen — weshalb es sich lohnt, die Ablaufmechanik genau zu verstehen, da sie das ist, was zwischen dem fortgesetzten Zugang eines Kunden und einem Link steht, den Sie als vorübergehend gedacht hatten.

Was Tatsächlich Erstellt Wird

Das Erstellen eines Portallinks erzeugt eine Zeile, die einen Kundendatensatz mit einem zufällig generierten Token verknüpft — 24 Byte aus einer kryptografisch sicheren Zufallsquelle, hexadezimal kodiert zu einer 48 Zeichen langen Zeichenfolge — sowie einen Ablaufzeitstempel, berechnet aus einer von Ihnen bei der Erstellung gewählten Anzahl von Tagen. Dieses Token ist die gesamte URL; es gibt keinen zusätzlichen Anmeldeschritt obendrauf. Jeder, der die URL besitzt, kann sie öffnen, weshalb nicht ein Passwort, sondern die Unvorhersehbarkeit des Tokens den Link schützt.

Der Standard Sind 30 Tage, aber der Bereich Reicht von 1 bis 365

Wenn Sie einen Portallink erstellen, ohne eine Laufzeit anzugeben, beträgt diese standardmäßig 30 Tage. Sie können sie auf einen einzigen Tag verkürzen für einen Link, der einmalig genutzt und danach verworfen werden soll, oder auf ein volles Jahr verlängern für eine Kundenbeziehung, bei der Sie nicht ständig neue Links erzeugen möchten. Es gibt keine Option "läuft nie ab" — jeder Portallink erhält bei der Erstellung einen berechneten Ablaufzeitstempel, selbst einen weit in der Zukunft liegenden, was bedeutet, dass ein mit dem Maximum von 365 Tagen erzeugter Link irgendwann trotzdem aufhört zu funktionieren, sofern Sie nicht vorher einen neuen erstellen.

Wie Der Ablauf Tatsächlich Geprüft Wird

Der Ablauf wird nicht von einem Hintergrundjob erzwungen, der Links deaktiviert, sobald ihre Zeit um ist — die Zeile des Links bleibt genau so, wie sie erstellt wurde. Stattdessen vergleicht jede einzelne Anfrage, die das Portal berührt — das Laden der Dokumentenliste, das Öffnen einer einzelnen Rechnung — unabhängig den gespeicherten Ablaufzeitstempel mit der aktuellen Zeit, bevor überhaupt etwas anderes geschieht. Zeigt dieser Vergleich, dass der Link abgelaufen ist, wird die Anfrage sofort mit einer eigenen Antwort "Link ist abgelaufen" abgelehnt, noch bevor irgendwelche Kunden- oder Dokumentdaten nachgeschlagen werden. Das bedeutet, ein abgelaufener Link hört nicht still und heimlich beim nächsten zufälligen Lauf eines Wartungsjobs auf zu funktionieren; er hört genau in dem Moment auf, in dem die Uhr den Ablaufzeitstempel überschreitet, bei der nächstfolgenden Anfrage.

Der Widerruf Funktioniert Bewusst Genauso

Sie können einen Portallink auch jederzeit manuell widerrufen, wodurch der Zeile ein revoked_at-Zeitstempel aufgeprägt wird, statt sie zu löschen. Jede Anfrage, die ein Portaltoken validiert, prüft als Teil derselben Suche, die überhaupt prüft, ob das Token existiert, auch auf ein leeres revoked_at — ein widerrufener Link scheitert also auf dieselbe Weise und an derselben Stelle wie einer, der schlicht nicht existiert. Aus Sicht des Kunden gibt es keinen Unterschied zwischen "dieser Link war nie gültig" und "dieser Link war einmal gültig und wurde widerrufen"; beide liefern eine Nicht-gefunden-Antwort zurück, statt zu verraten, dass ein Link einmal funktioniert hat.

Jede Erfolgreiche Anfrage Aktualisiert last_used_at

Jedes Mal, wenn ein Portallink erfolgreich genutzt wird — das heißt, er hat sowohl die Existenz- als auch die Ablaufprüfung bestanden — wird sein last_used_at-Zeitstempel aktualisiert, bevor die Anfrage fortgesetzt wird. Das geschieht bei jeder Anfrage, nicht nur bei der ersten, sodass last_used_at stets den jüngsten Zeitpunkt widerspiegelt, zu dem der Link tatsächlich genutzt wurde, statt wann er erstellt wurde. Das ist ein nützliches Signal, wenn Sie entscheiden möchten, ob eine Kundenbeziehung noch einen Portallink nutzt, den Sie vor Monaten eingerichtet haben, oder ob es sicher ist, ihn zu widerrufen.

Warum der Dokumentabgleich Ein Exakter Vergleich Ist, Kein Fremdschlüssel

Ein Portallink ist an einen bestimmten gespeicherten Kundendatensatz gebunden, aber die Rechnungen, die dieser Link zeigt, werden nicht über einen Fremdschlüssel nachgeschlagen — Rechnungen verweisen überhaupt nicht auf Kundendatensätze. Stattdessen normalisiert das System sowohl den "an"-Text der Rechnung als auch die gespeicherten Rechnungsdaten des Kunden — Kleinschreibung, Zusammenfassen von Leerzeichen, Trimmen — und verlangt eine exakte Übereinstimmung. Das ist eine bewusste Verschärfung: Eine frühere Version dieser Logik verwendete einen lockereren, teilstring-basierten Vergleich, mit einem realen Fehlerfall, bei dem der Name eines Kunden, der zufällig eine Teilzeichenkette der vollständigen Rechnungsadresse eines anderen Kunden war, einen Portallink dazu bringen konnte, — oder schlimmer, bei einer anders abgegrenzten Prüfung, möglicherweise zurückzugeben — die Rechnung dieses anderen Kunden anzuzeigen. Eine exakte Übereinstimmung nach der Normalisierung zu verlangen, schließt das aus, auf Kosten dessen, dass ein Portallink gelegentlich weniger Dokumente zeigt als erwartet, wenn der "an"-Text einer Rechnung leicht anders eingegeben wurde als der gespeicherte Kundendatensatz, dem er entsprechen sollte.

Was Das im Alltag Bedeutet

In der Praxis bedeutet dieses Design, dass ein Portallink innerhalb seines gewählten Zeitfensters sicher als langlebig behandelt werden kann — er wird weder still und heimlich schlechter noch gibt er Zugang zu den Dokumenten des falschen Kunden preis —, aber er ist nichts, das Sie einmal herausgeben und dann vollständig vergessen können. Wenn Sie möchten, dass ein Kunde dauerhaft wirkenden Zugang hat, besteht der praktische Weg darin, einen Link mit der maximalen Laufzeit von 365 Tagen zu erstellen und ihn gewohnheitsmäßig jährlich zu erneuern, statt anzunehmen, es gäbe eine Option, ihn wirklich dauerhaft zu machen.