Intastellar schließt Rückleitungen nur zu vorab registrierten URLs ab (oder URIs, die Ihr Client für die Login-URI im React-/Plain-JS-Flow erlaubt). Tippfehler, falsches Schema oder ein zusätzlicher Schrägstrich erzeugen redirect_uri_mismatch — technisch klingend, meist heißt es: „URL steht nicht auf der Liste“.
Bei Hostname-Wechsel (Domain-Umzug, neues CDN) Intastellar-Client aktualisieren, damit Redirect/Login zur neuen Origin und Pfaden passen. SDKs leiten die Login-URI oft von der aktuellen Seite ab (hostname, port, pathname), sofern nicht überschrieben — registrieren Sie, was Sie wirklich senden.
Schnell prüfen, wenn es „plötzlich“ bricht
- Schema:
https://vs.http://. - Host:
www.vs. ohne. - Pfad:
/callbackvs./callback/. - Port in Dev:
127.0.0.1vs.localhost. - Staging- vs. Produktions-Client.
Faustregeln
- HTTPS in Produktion —
http://localhostoft für Entwicklung erlaubt. - Exakte Übereinstimmung —
/callbackund/callback/sind verschiedene Pfade. - Keine Wildcards in den meisten Setups — jeden konkreten Callback registrieren (oder Muster laut Konsole).
- Query-Strings — dynamische Query in der registrierten URI vermeiden, wenn nicht explizit erlaubt; festen Pfad nutzen, Kontext über
state.
Mehrere Umgebungen
Getrennte Redirect-URIs oder Clients für:
- lokale Entwicklung (
http://127.0.0.1:5173/auth/callbackusw.) - Staging
- Produktion
So bleibt Schaden bei Leaks in Nicht-Produktion begrenzt.
SPA-Router
Hash-Routing (/#/callback): prüfen, ob das erlaubt ist; oft sind Pfad-URLs (/auth/callback) nötig.
Auf der Callback-Route
codeundstateaus der Query lesen.statemit dem beim Start gespeicherten Wert vergleichen.- Code am Token-Endpunkt tauschen — Authorization-Code-Flow.
- Nutzer zur Zielseite weiterleiten.
Häufige Fragen
SDK-Popup — brauchen wir Redirect-URIs?
Weiterhin korrekte Client-Registrierung und oft registrierte Login-/Continue-Muster. Bei Fehlern vor Ende des Popups: prüfen, was das SDK sendet vs. was registriert ist.
URL im Code geändert, Fehler bleibt
Die Liste beim Intastellar-Client muss mitgeändert werden — Deploy allein reicht nicht.
Nächste Schritte
Last updated