Test hele integrationen mod Parkour Designs testmiljø, før loginoplysninger til produktion udstedes. Automatiske kontroller viser, at protokollen og kontrakten fungerer; manuel accept viser brugerrejsen og den operationelle genoprettelse.
Regel for lancering: Et vellykket autorisations-callback er ikke nok som accept. Lanceringen kræver validering af identitet, isolering af brugere, rotation af tokens, test af ressourcekontrakten, genoprettelse efter fejl og godkendelse fra begge teams.
Forudsætninger for test
Parkour Design og partneren skal forberede:
- en registreret testklient og en sikkert leveret hemmelighed;
- en præcis redirect-URI til test;
- det godkendte sæt scopes;
- mindst to testbrugere i Parkour Design;
- stævner og projekter, som hver bruger ejer separat;
- en tom konto eller et tomt stævne, hvor det er relevant;
- tekniske kontakter og kontakter ved hændelser;
- forventede resultater for hvert acceptscenarie.
Brug testudstederen:
https://parkour-test.web.app
Genbrug ikke loginoplysninger, callback-URL’er, tokens eller brugerdata fra test i produktion.
Indledende kontroller
Discovery
curl --fail-with-body \
"https://parkour-test.web.app/.well-known/openid-configuration"
Kontrollér, at:
issuerstemmer præcist med den konfigurerede testudsteder;- endpoints for autorisation, token, UserInfo og JWKS bruger HTTPS;
code,authorization_code,refresh_token,RS256ogS256findes;- ingen client secret eller anden privat værdi for miljøet er synlig i discovery.
Signeringsnøgler
Hent jwks_uri fra discovery, og kontrollér, at hver brugbar nøgle har kid, kty, brug til signering og en godkendt algoritme. Klienten skal håndtere et ukendt kid ved at opdatere JWKS én gang, før tokenet afvises.
Anmodning om ressourcer uden autentificering
curl --include "https://parkour-test.web.app/api/events"
Forventet resultat:
HTTP/2 401
Content-Type: application/json
{"error":"invalid_token"}
Automatiske OAuth-tests
Automatisér disse scenarier ved partnerens grænse. Brug kontrollerede testdata, og simulér kun det eksterne browsertrin, når en fuld browsertest ikke er praktisk.
Autorisationsanmodning
- indeholder præcis klient-ID, redirect-URI og godkendte scopes;
- opretter unikke værdier med høj entropi for
state,nonceog PKCE-verifier; - sender
code_challenge_method=S256; - lægger ikke client secret eller verifier i URL’en;
- afviser en uregistreret eller subtilt anderledes redirect-URI i en negativ test af miljøet.
Callback
- accepterer det rigtige state én gang;
- afviser manglende, forkert, udløbet og genbrugt state;
- håndterer
access_denieduden at udveksle en kode; - afviser en manglende kode i et ellers vellykket callback;
- bevarer kun en valideret lokal returnsti;
- eksponerer ikke protokoldiagnostik eller personoplysninger for browseren.
Udveksling af kode
- autentificerer med
client_secret_basic; - bruger den samme redirect-URI som autorisationsanmodningen;
- sender den oprindelige PKCE-verifier;
- afviser udløbne, genbrugte koder, koder til en forkert klient og koder med forkert verifier;
- behandler tokensvar som ikke-cachebare og beholder dem på serveren.
Validering af ID-token
Afvis tokens med:
- en ugyldig signatur;
- en ukendt signeringsnøgle efter en opdatering af JWKS;
- forkert udsteder;
- forkert audience;
- en anden algoritme end
RS256; - en manglende eller forkert nonce;
- udløbne eller urimelige tidsclaims;
- et manglende subject.
Kontrollér, at forbindelse af konti bruger parret iss og sub, ikke kun e-mail.
Rotation ved fornyelse
- et gyldigt refresh token returnerer et nyt adgangstoken og et erstattende refresh token;
- erstatningen gemmes atomisk;
- fornyelser køres efter hinanden for hver bruger og klientsession;
- genbrug af det gamle refresh token afvises;
- et token, der er udstedt til en anden klient, afvises;
- et udløbet token kræver et nyt autorisationsflow;
- en timeout eller et mistet fornyelsessvar med usikkert resultat rydder den lokale tokentilstand og starter et nyt autorisationsflow i stedet for at prøve igen med det gamle token;
- samtidige fornyelsesforsøg kan ikke konkurrere om det samme token;
- lokal frakobling sletter det aktive refresh token og sessionsdata.
Parkour Design har i øjeblikket intet offentligt endpoint til tilbagekaldelse. Testene må ikke rapportere lokal sletning som tilbagekaldelse på serveren.
Automatiske tests af ressourcer
Autentificering og isolering
- intet token returnerer
401 invalid_token; - et udløbet eller forkert formateret token returnerer
401 invalid_token; - et ID-token, der bruges som bearer token til API, afvises;
- bruger A ser kun bruger A’s stævner og projekter;
- bruger B kan ikke hente bruger A’s stævne ved at kopiere dets ID;
- utilgængelige stævner og stævner, der ikke findes, returnerer begge
404 not_found.
Skemakontrakt
Validér hvert svar mod et skema, som partneren ejer:
- obligatoriske egenskaber findes;
- egenskaber, der kan være null, accepterer
null; - datoer tolkes som værdier efter ISO 8601;
- ukendte ekstra egenskaber må ikke få klienten til at holde op med at virke;
- tomme samlinger returnerer et tomt array
items; - identifikatorer behandles som uigennemsigtige strenge;
- tekst understøtter Unicode og vises sikkert.
Udled ikke en fuldstændig baneskitse af skemaet for oversigter.
Grænser og fejl
- klienten håndterer den største godkendte liste over stævner;
- den nuværende grænse på 500 projekter i detaljevisningen indgår i risikovurderingen før lanceringen;
- svarene
401,404,405,429og5xxfølger den aftalte politik for nye forsøg; - timeouts udløser ikke ubegrænsede nye forsøg;
- forkert formateret JSON fejler sikkert og gemmer en renset diagnostik;
- gentagne idempotente
GET-anmodninger ændrer ikke partnerens tilstand.
Tests af eksport fra Parkour Design til partneren
Når Parkour Design sender data til en partner, tilføjer du gensidige kontrakttests for:
- liste over modtagere og validering af identifikatorer;
- levering af kun fil;
- levering af kun strukturerede data;
- vellykket levering af alle dele;
- hver mulig kombination af delvist vellykket levering;
- forkert formaterede strukturerede data;
- tomme og for store filer;
- partnerens svar
401,403,404,409,413,429og5xx; - timeout for forbindelse og for svar;
- dobbelte indsendelser og idempotens;
- frakobling, genforbindelse og udløbet token.
Manuel accept
Gør følgende i en rigtig browser mod det driftsatte testmiljø.
| Scenarie | Forventet resultat |
|---|---|
| Rigtig konto | Samtykket fuldføres, og kun den brugers ressourcer returneres |
| Afvist samtykke | Partneren viser en tilstand for afbrydelse, der kan genoprettes, og gemmer ingen tokens |
| Forkert konto i Parkour Design | Partneren viser den indloggede identitet og tillader en sikker genstart |
| Eksisterende partnersession for en anden konto | Skift af konto fungerer efter de godkendte supportinstruktioner |
| Tilbage og opdater | Ingen autorisationskode eller state-værdi accepteres to gange |
| Dobbeltklik på forbind | Én browsertransaktion forbliver den gældende |
| Samtidige faner | Et callback kan ikke forbindes med den forkerte lokale transaktion |
| Udløbet callback | Brugeren kan starte forfra uden forældet forbindelsestilstand |
| Udløbet adgangstoken | Partneren fornyer én gang eller beder om autorisation igen |
| Nedbrud hos partneren eller Parkour Design | Brugeren får en besked om et problem, der kan genoprettes, uden følsom diagnostik |
| Frakobling og genforbindelse | Lokale tokens slettes, og en ny identitet kan fastslås |
Gentag grundflowet på hvert sprog, som brugerfladen understøtter. Protokolværdier skal forblive uændrede, mens beskeder til brugeren lokaliseres.
Materiale til sikkerhedsgennemgang
Giv gennemgangen:
- et dataflowdiagram, der viser browseren, begge backends, identitetsudbyderen, API’erne og lagringen af tokens;
- tilladte redirect-URI’er og oprindelser;
- ønskede scopes og tilknytning til ressourcer;
- indstillinger for kryptering og opbevaring af tokens;
- indstillinger for validering af ID-token;
- rensede eksempler på logs og alarmer;
- resultater fra scanning af afhængigheder og hemmeligheder;
- resultater fra automatiske tests;
- udfyldt protokol fra manuel accept;
- procedurer for rotation af loginoplysninger og hændelser.
Vedhæft aldrig rigtige koder, tokens, client secrets, private nøgler, rå UserInfo-svar eller kundedata som materiale.
Observerbarhed
Gem nok oplysninger til at diagnosticere fejl uden at gemme loginoplysninger eller personoplysninger:
- korrelations-ID, som partneren opretter;
- miljø og integrationens retning;
- operationens navn;
- kategori for endpointet opstrøms, ikke forespørgselsparametre;
- HTTP-status og sikker OAuth-fejlkode;
- varighed og antal nye forsøg;
- renset antal ressourcer, når det er operationelt nyttigt.
Log ikke autorisationskoder, adgangstokens, refresh tokens, ID-tokens, client secrets, state, nonce, PKCE-verifiers, fulde redirect-URL’er, e-mailadresser eller indhold i baneskitser.
Alarmerne skal skelne mellem fejl ved autentificering, fejl ved autorisation, nedbrud hos partneren, forsinkelse, skemafejl og vedvarende hastighedsbegrænsning.
Parathed til produktion
Før loginoplysninger til produktion udstedes, skal begge teams godkende:
- præcis udsteder og redirect-URI til produktion;
- klientautentificering og ejer af loginoplysningerne;
- scopes og tilgængelige ressourcer;
- forventet volumen og nuværende grænser i API’et;
- privatliv, opbevaring, frakobling og sletning;
- regler for timeout, nye forsøg, idempotens og delvist vellykkede leveringer;
- overvågning og eskalering af hændelser;
- supportinstruktioner til brugerne;
- procedure for tilbagerulning eller slukning af integrationen;
- tidsvindue og ansvarlig for røgtest i produktion.
Brug forskellige klientoplysninger til test og produktion. Lever dem via den godkendte kanal for hemmeligheder, og kontrollér rotationen før lanceringen.
Røgtest i produktion
Hold den første test i produktion snæver:
- autorisér en godkendt intern konto;
- validér ID-tokenet, og hent UserInfo;
- anmod om listen over stævner;
- anmod om projektoversigter for et kendt stævne;
- kontrollér isoleringen af brugere og de forventede felter;
- forny én gang, og gem det erstattende token;
- frakobl, og slet lokalt gemte loginoplysninger;
- gennemgå rensede logs og alarmer;
- dokumentér resultatet, og beslut, om bredere adgang skal slås til.
Test ikke destruktiv adfærd eller høj volumen i produktion, medmindre det udtrykkeligt indgår i den godkendte lanceringsprocedure.
Acceptprotokol
Dokumentér for hvert scenarie:
- miljø og buildversion;
- ansvarlig for testen og dato;
- anonymiseret identitet for testdata;
- forventet resultat;
- faktisk resultat;
- hvor materialet findes;
- fejl eller accepteret begrænsning;
- ansvarlig for godkendelsen.
En udokumenteret begrænsning er ikke en accepteret begrænsning. Tilføj uløste problemer med kontrakt eller sikkerhed til beslutningen om lancering, før produktionsadgang slås til.