Incidentrapport för den oväntade JWT `iss`-ändringen den 2024-03-18.
Den 2024-03-18 orsakade en uppdatering av förändrad JWT-utgivarsbeteende i Logto Cloud avbrott i autentiseringsflöden för användare med anpassade domäner och iss-validering. Lösningen krävde att dessa användare uppdaterade sin valideringslogik.
iss-validering.iss-valideringen inom autentiseringsflöden.Uppdateringen ändrade iss-fältet för att matcha den begärda domänen, vilket bröt befintliga valideringar som förväntade sig den tidigare standardutgivaren.
iss-beteendet.Logto Cloud stöder anpassad domän för autentisering. Utvecklare som har aktiverat anpassade domänhyrare kan ställa in slutpunkten till den anpassade domänen i SDK:er, sedan kommer slutanvändaren att använda denna slutpunkt för att initiera autentiseringsprocessen och få tokens. Vissa tokens är i form av JWT, som inkluderar ett iss-fält som anger utgivaren av denna token. Tidigare, även när en anpassad domänslutpunkt användes för att begära en åtkomsttoken, skulle utgivaren fortfarande vara standardiserad till vår domän ([tenant-id].logto.app).
Men utgivarens domän bör vara densamma som den begärda slutpunkten. Så vi släppte en uppdatering för att fixa detta problem, och nu kommer iss-fältet automatiskt att spegla domänen som används i förfrågan.
För de som redan använder anpassad domän för att bevilja tokens och implementerat iss-validering i resursservern, kan detta vara en brytande ändring. Befintlig autentiseringskontroll kommer att misslyckas på grund av förändringen av utgivaren. För att fixa detta behöver utvecklarna ändra valideringskoden, ersätta den förväntade utgivaren med den nya med anpassad domän.
Vi misslyckades med att fullständigt överväga påverkan på befintliga iss-valideringar, vilket resulterade i att denna utgåva blev en brytande ändring utan tidigare meddelande.
Meddelade påverkade användare via e-post och rådde dem att uppdatera sin iss-validering för att matcha den begärda domänen.
Förändringen är en nödvändig fix för utgivarens fält, och vissa användare kan redan ha anpassat sig till det nya beteendet. En återställning skulle orsaka förvirring och inkonsekvens.