Testa hela integrationen mot Parkour Designs testmiljö innan inloggningsuppgifter för produktion utfärdas. Automatiska kontroller visar att protokollet och kontraktet fungerar; manuell acceptans visar användarresan och den operativa återhämtningen.
Regel för lansering: En lyckad auktoriseringscallback räcker inte som acceptans. Lanseringen kräver validering av identitet, isolering av användare, rotation av token, tester av resurskontraktet, återhämtning efter fel och godkännande från båda teamen.
Förutsättningar för test
Parkour Design och partnern måste förbereda:
- en registrerad testklient och en säkert levererad hemlighet;
- en exakt omdirigerings-URI för test;
- den godkända uppsättningen scope;
- minst två testanvändare i Parkour Design;
- evenemang och projekt som ägs separat av varje användare;
- ett tomt konto eller evenemang där det är relevant;
- tekniska kontakter och kontakter vid incidenter;
- förväntade resultat för varje acceptansfall.
Använd testutfärdaren:
https://parkour-test.web.app
Återanvänd inte inloggningsuppgifter, callback-URL:er, token eller användardata från test i produktion.
Inledande kontroller
Discovery
curl --fail-with-body \
"https://parkour-test.web.app/.well-known/openid-configuration"
Kontrollera att:
issuerexakt stämmer med den konfigurerade testutfärdaren;- slutpunkterna för auktorisering, token, UserInfo och JWKS använder HTTPS;
code,authorization_code,refresh_token,RS256ochS256finns;- ingen klienthemlighet eller annat privat värde för miljön syns i discovery.
Signeringsnycklar
Hämta jwks_uri från discovery och kontrollera att varje användbar nyckel har kid, kty, användning för signering och en godkänd algoritm. Klienten måste hantera ett okänt kid genom att uppdatera JWKS en gång innan token avvisas.
Begäran om resurser utan autentisering
curl --include "https://parkour-test.web.app/api/events"
Förväntat resultat:
HTTP/2 401
Content-Type: application/json
{"error":"invalid_token"}
Automatiska OAuth-tester
Automatisera de här fallen vid partnerns gräns. Använd kontrollerade testdata och simulera bara det externa webbläsarsteget när ett fullständigt webbläsartest inte är praktiskt.
Auktoriseringsbegäran
- innehåller exakt klient-ID, omdirigerings-URI och godkända scope;
- skapar unika värden med hög entropi för
state,nonceoch PKCE-verifierare; - skickar
code_challenge_method=S256; - lägger inte klienthemligheten eller verifieraren i URL:en;
- avvisar en oregistrerad eller subtilt annorlunda omdirigerings-URI i ett negativt test av miljön.
Callback
- accepterar rätt state en gång;
- avvisar saknat, felaktigt, utgånget och återanvänt state;
- hanterar
access_deniedutan att byta en kod; - avvisar en saknad kod i en i övrigt lyckad callback;
- bevarar bara en validerad lokal återgångssökväg;
- exponerar inte protokolldiagnostik eller personuppgifter för webbläsaren.
Byte av kod
- autentiserar med
client_secret_basic; - använder samma omdirigerings-URI som auktoriseringsbegäran;
- skickar den ursprungliga PKCE-verifieraren;
- avvisar utgångna, återanvända koder, koder för fel klient och koder med fel verifierare;
- behandlar tokensvar som icke cachebara och behåller dem på servern.
Validering av ID-token
Avvisa token med:
- en ogiltig signatur;
- en okänd signeringsnyckel efter en uppdatering av JWKS;
- fel utfärdare;
- fel målgrupp;
- en annan algoritm än
RS256; - en saknad eller felaktig nonce;
- utgångna eller orimliga tidsanspråk;
- ett saknat subjekt.
Kontrollera att koppling av konton använder paret iss och sub, inte enbart e-post.
Rotation vid förnyelse
- en giltig förnyelsetoken returnerar en ny åtkomsttoken och en ersättande förnyelsetoken;
- ersättaren sparas atomärt;
- förnyelser körs i tur och ordning för varje användare och klientsession;
- återanvändning av den gamla förnyelsetoken avvisas;
- en token som utfärdats till en annan klient avvisas;
- en utgången token kräver ett nytt auktoriseringsflöde;
- en timeout eller ett förlorat förnyelsesvar med okänt resultat rensar det lokala tokentillståndet och startar ett nytt auktoriseringsflöde i stället för att försöka igen med den gamla token;
- samtidiga förnyelseförsök kan inte konkurrera med samma token;
- lokal frånkoppling tar bort den aktiva förnyelsetoken och sessionsdata.
Parkour Design har för närvarande ingen offentlig slutpunkt för återkallande. Testerna får inte rapportera lokal borttagning som återkallande på servern.
Automatiska tester av resurser
Autentisering och isolering
- ingen token returnerar
401 invalid_token; - en utgången eller felformaterad token returnerar
401 invalid_token; - en ID-token som används som bearer-token för API avvisas;
- användare A ser bara användare A:s evenemang och projekt;
- användare B kan inte hämta användare A:s evenemang genom att kopiera dess ID;
- otillgängliga evenemang och evenemang som inte finns returnerar båda
404 not_found.
Schemakontrakt
Validera varje svar mot ett schema som partnern äger:
- obligatoriska egenskaper finns;
- egenskaper som kan vara null accepterar
null; - datum tolkas som värden enligt ISO 8601;
- okända extra egenskaper får inte få klienten att sluta fungera;
- tomma samlingar returnerar en tom array
items; - identifierare behandlas som ogenomskinliga strängar;
- text stöder Unicode och visas säkert.
Härled ingen fullständig banskiss från schemat för sammanfattningar.
Gränser och fel
- klienten hanterar den största godkända listan över evenemang;
- den nuvarande gränsen på 500 projekt i detaljvyn finns med i riskbedömningen inför lanseringen;
- svaren
401,404,405,429och5xxföljer den överenskomna policyn för nya försök; - timeouter utlöser inte obegränsade nya försök;
- felformaterad JSON misslyckas säkert och sparar en rensad diagnostik;
- upprepade idempotenta
GET-begäranden ändrar inte partnerns tillstånd.
Tester för export från Parkour Design till partnern
När Parkour Design skickar data till en partner lägger du till ömsesidiga kontraktstester för:
- listning av mål och validering av identifierare;
- leverans av bara fil;
- leverans av bara strukturerade data;
- lyckad leverans av alla delar;
- varje möjlig kombination av delvis lyckad leverans;
- felformaterade strukturerade data;
- tomma och för stora filer;
- partnerns svar
401,403,404,409,413,429och5xx; - timeout för anslutning och för svar;
- dubbla inskick och idempotens;
- frånkoppling, återanslutning och utgången token.
Manuell acceptans
Gör följande i en riktig webbläsare mot den driftsatta testmiljön.
| Scenario | Förväntat resultat |
|---|---|
| Rätt konto | Samtycket slutförs och bara den användarens resurser returneras |
| Nekat samtycke | Partnern visar ett läge för avbrott som går att återhämta sig från och sparar inga token |
| Fel konto i Parkour Design | Partnern visar den inloggade identiteten och tillåter en säker omstart |
| Befintlig partnersession för ett annat konto | Byte av konto fungerar enligt de godkända supportinstruktionerna |
| Bakåt och uppdatera | Ingen auktoriseringskod eller inget state-värde accepteras två gånger |
| Dubbelklick på anslut | En webbläsartransaktion förblir den som gäller |
| Samtidiga flikar | En callback kan inte kopplas till fel lokal transaktion |
| Utgången callback | Användaren kan starta om utan inaktuellt anslutningstillstånd |
| Utgången åtkomsttoken | Partnern förnyar en gång eller ber om auktorisering igen |
| Avbrott hos partnern eller Parkour Design | Användaren får ett meddelande om något som går att återhämta sig från, utan känslig diagnostik |
| Frånkoppling och återanslutning | Lokala token tas bort och en ny identitet kan fastställas |
Upprepa grundflödet på varje språk som gränssnittet stöder. Protokollvärden måste förbli oförändrade medan meddelanden till användaren lokaliseras.
Underlag för säkerhetsgranskning
Ge granskarna:
- ett dataflödesdiagram som visar webbläsaren, båda backend-systemen, identitetsleverantören, API:erna och lagringen av token;
- tillåtna omdirigerings-URI:er och ursprung;
- begärda scope och koppling till resurser;
- inställningar för kryptering och lagring av token;
- inställningar för validering av ID-token;
- rensade exempel på loggar och larm;
- resultat från skanning av beroenden och hemligheter;
- resultat från automatiska tester;
- ifyllt protokoll från manuell acceptans;
- rutiner för rotation av inloggningsuppgifter och incidenter.
Bifoga aldrig riktiga koder, token, klienthemligheter, privata nycklar, råa UserInfo-svar eller kunddata som underlag.
Observerbarhet
Spara tillräckligt med information för att diagnostisera fel utan att spara inloggningsuppgifter eller personuppgifter:
- korrelations-ID som partnern skapar;
- miljö och integrationens riktning;
- operationens namn;
- kategori för slutpunkten uppströms, inte frågeparametrar;
- HTTP-status och säker OAuth-felkod;
- varaktighet och antal nya försök;
- rensat antal resurser när det är operativt användbart.
Logga inte auktoriseringskoder, åtkomsttoken, förnyelsetoken, ID-token, klienthemligheter, state, nonce, PKCE-verifierare, fullständiga omdirigerings-URL:er, e-postadresser eller innehåll i banskisser.
Larmen ska skilja mellan fel vid autentisering, fel vid auktorisering, avbrott hos partnern, fördröjning, schemafel och ihållande hastighetsbegränsning.
Beredskap för produktion
Innan inloggningsuppgifter för produktion utfärdas måste båda teamen godkänna:
- exakt utfärdare och omdirigerings-URI för produktion;
- klientautentisering och ägare av inloggningsuppgifterna;
- scope och tillgängliga resurser;
- förväntad volym och nuvarande gränser i API:et;
- integritet, lagring, frånkoppling och radering;
- regler för timeout, nya försök, idempotens och delvis lyckade leveranser;
- övervakning och eskalering av incidenter;
- supportinstruktioner för användarna;
- rutin för återställning eller avstängning av integrationen;
- tidsfönster och ansvarig för röktest i produktion.
Använd olika klientuppgifter för test och produktion. Leverera dem via den godkända kanalen för hemligheter och kontrollera rotationen före lanseringen.
Röktest i produktion
Håll det första testet i produktion snävt:
- auktorisera ett godkänt internt konto;
- validera ID-token och hämta UserInfo;
- begär listan över evenemang;
- begär sammanfattningar av projekt för ett känt evenemang;
- kontrollera isoleringen av användare och de förväntade fälten;
- förnya en gång och spara den ersättande token;
- koppla från och ta bort lokalt sparade inloggningsuppgifter;
- granska rensade loggar och larm;
- dokumentera resultatet och besluta om bredare åtkomst ska aktiveras.
Testa inte destruktivt beteende eller hög volym i produktion om det inte uttryckligen ingår i den godkända lanseringsrutinen.
Acceptansprotokoll
Dokumentera för varje scenario:
- miljö och byggversion;
- ansvarig för testet och datum;
- anonymiserad identitet för testdata;
- förväntat resultat;
- faktiskt resultat;
- var underlaget finns;
- fel eller accepterad begränsning;
- ansvarig för godkännandet.
En odokumenterad begränsning är ingen accepterad begränsning. Lägg till olösta problem med kontrakt eller säkerhet i beslutet om lansering innan produktionsåtkomst aktiveras.