Dokumentationsmenu
Partnerspecifik Senest opdateret: 27. juli 2026

Test og lancering

Kontrollér OAuth, identitet, isolering af brugere, ressourcekontrakter, fejlhåndtering og parathed til produktion.

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:

  • issuer stemmer præcist med den konfigurerede testudsteder;
  • endpoints for autorisation, token, UserInfo og JWKS bruger HTTPS;
  • code, authorization_code, refresh_token, RS256 og S256 findes;
  • 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, nonce og 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_denied uden 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, 429 og 5xx fø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, 429 og 5xx;
  • 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ø.

ScenarieForventet resultat
Rigtig kontoSamtykket fuldføres, og kun den brugers ressourcer returneres
Afvist samtykkePartneren viser en tilstand for afbrydelse, der kan genoprettes, og gemmer ingen tokens
Forkert konto i Parkour DesignPartneren viser den indloggede identitet og tillader en sikker genstart
Eksisterende partnersession for en anden kontoSkift af konto fungerer efter de godkendte supportinstruktioner
Tilbage og opdaterIngen autorisationskode eller state-værdi accepteres to gange
Dobbeltklik på forbindÉn browsertransaktion forbliver den gældende
Samtidige fanerEt callback kan ikke forbindes med den forkerte lokale transaktion
Udløbet callbackBrugeren kan starte forfra uden forældet forbindelsestilstand
Udløbet adgangstokenPartneren fornyer én gang eller beder om autorisation igen
Nedbrud hos partneren eller Parkour DesignBrugeren får en besked om et problem, der kan genoprettes, uden følsom diagnostik
Frakobling og genforbindelseLokale 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:

  1. autorisér en godkendt intern konto;
  2. validér ID-tokenet, og hent UserInfo;
  3. anmod om listen over stævner;
  4. anmod om projektoversigter for et kendt stævne;
  5. kontrollér isoleringen af brugere og de forventede felter;
  6. forny én gang, og gem det erstattende token;
  7. frakobl, og slet lokalt gemte loginoplysninger;
  8. gennemgå rensede logs og alarmer;
  9. 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.