Test de volledige integratie in de testomgeving van Parkour Design voordat er inloggegevens voor productie worden uitgegeven. Automatische controles bewijzen het gedrag van protocol en contract; handmatige acceptatie bewijst de gebruikersflow en het operationele herstel.
Regel voor de release: Een geslaagde autorisatiecallback is geen voldoende acceptatie. Voor de lancering zijn identiteitsvalidatie, scheiding tussen gebruikers, tokenrotatie, tests van het resourcecontract, herstel na fouten en goedkeuring van beide teams nodig.
Voorwaarden voor testen
Parkour Design en de partner bereiden voor:
- een geregistreerde testclient en een veilig geleverd geheim;
- een exacte redirect-URI voor test;
- de goedgekeurde set scopes;
- minstens twee testgebruikers van Parkour Design;
- evenementen en ontwerpen die apart van elke gebruiker zijn;
- waar relevant één leeg account of evenement;
- technische contactpersonen en contactpersonen voor incidenten;
- het verwachte resultaat voor elk acceptatiegeval.
Gebruik de test-issuer:
https://parkour-test.web.app
Hergebruik testinloggegevens, callback-URL’s, tokens of gebruikersgegevens niet in productie.
Controles vooraf
Discovery
curl --fail-with-body \
"https://parkour-test.web.app/.well-known/openid-configuration"
Controleer dat:
issuerexact gelijk is aan de ingestelde test-issuer;- de endpoints voor autorisatie, token, UserInfo en JWKS HTTPS gebruiken;
code,authorization_code,refresh_token,RS256enS256aanwezig zijn;- er geen clientgeheim of omgevingsspecifieke privéwaarde in de discovery staat.
Ondertekeningssleutels
Haal jwks_uri op uit de discovery en controleer dat elke bruikbare sleutel een kid, een kty, gebruik voor ondertekening en een goedgekeurd algoritme heeft. De client moet een onbekende kid afhandelen door de JWKS één keer te vernieuwen voordat het token wordt geweigerd.
Resourceverzoek zonder authenticatie
curl --include "https://parkour-test.web.app/api/events"
Verwacht resultaat:
HTTP/2 401
Content-Type: application/json
{"error":"invalid_token"}
Automatische OAuth-tests
Automatiseer deze gevallen aan de kant van de partner. Gebruik gecontroleerde testgegevens en mock alleen de externe browserstap als een volledige browsertest niet praktisch is.
Autorisatieverzoek
- bevat de exacte client-ID, redirect-URI en goedgekeurde scopes;
- genereert unieke waarden met hoge entropie voor
state,nonceen de PKCE-verifier; - stuurt
code_challenge_method=S256; - zet het clientgeheim of de verifier niet in de URL;
- weigert een niet-geregistreerde of licht afwijkende redirect-URI in een negatieve test van de omgeving.
Callback
- accepteert de juiste state één keer;
- weigert een ontbrekende, afwijkende, verlopen en hergebruikte state;
- handelt
access_deniedaf zonder een code in te wisselen; - weigert een ontbrekende code bij een verder geslaagde callback;
- bewaart alleen een gevalideerd lokaal terugkeerpad;
- toont geen protocoldiagnostiek of persoonsgegevens in de browser.
Code inwisselen
- authenticeert met
client_secret_basic; - gebruikt dezelfde redirect-URI als het autorisatieverzoek;
- stuurt de oorspronkelijke PKCE-verifier;
- weigert verlopen en hergebruikte codes, codes van een andere client en codes met een verkeerde verifier;
- behandelt tokenantwoorden als niet-cachebaar en houdt ze op de server.
Validatie van het ID-token
Weiger tokens met:
- een ongeldige handtekening;
- een onbekende ondertekeningssleutel na één vernieuwing van de JWKS;
- de verkeerde issuer;
- de verkeerde audience;
- een ander algoritme dan
RS256; - een ontbrekende of verkeerde nonce;
- verlopen of onwaarschijnlijke tijdclaims;
- een ontbrekend subject.
Controleer dat het koppelen van accounts het paar iss en sub gebruikt, niet alleen het e-mailadres.
Rotatie van refresh tokens
- een geldig refresh token geeft een nieuw toegangstoken en een vervangend refresh token;
- de vervanging wordt atomair vastgelegd;
- vernieuwingen worden per gebruikers- en clientsessie na elkaar uitgevoerd;
- hergebruik van het oude refresh token wordt geweigerd;
- een token dat aan een andere client is uitgegeven, wordt geweigerd;
- een verlopen token vereist een nieuwe autorisatieflow;
- bij een time-out of een verloren antwoord met onbekende uitkomst wordt de lokale tokenstatus gewist en een nieuwe autorisatieflow gestart, in plaats van het oude token opnieuw te proberen;
- gelijktijdige vernieuwingspogingen kunnen niet met hetzelfde token om voorrang strijden;
- lokaal ontkoppelen verwijdert het actieve refresh token en de sessiegegevens.
Parkour Design heeft nu geen openbaar endpoint voor het intrekken van tokens. Tests mogen lokaal verwijderen niet rapporteren als intrekking op de server.
Automatische resourcetests
Authenticatie en scheiding
- zonder token volgt
401 invalid_token; - een verlopen of onjuist opgebouwd token geeft
401 invalid_token; - een ID-token dat als bearer-token voor de API wordt gebruikt, wordt geweigerd;
- gebruiker A ziet alleen de evenementen en ontwerpen van gebruiker A;
- gebruiker B kan het evenement van gebruiker A niet ophalen door de ID te kopiëren;
- ontoegankelijke en niet-bestaande evenementen geven allebei
404 not_found.
Schemacontract
Valideer elk antwoord tegen een schema dat de partner beheert:
- verplichte eigenschappen zijn aanwezig;
- eigenschappen die null mogen zijn, accepteren
null; - datums worden als ISO 8601-waarden geparsed;
- onbekende extra eigenschappen breken de client niet;
- lege verzamelingen geven een lege array
items; - identificaties worden als ondoorzichtige strings behandeld;
- tekst ondersteunt Unicode en wordt veilig weergegeven.
Leid geen volledig parcoursontwerp af uit het schema van het overzicht.
Limieten en fouten
- de client verwerkt de grootste goedgekeurde lijst met evenementen;
- de huidige limiet van 500 ontwerpen staat in de risicobeoordeling voor de lancering;
- antwoorden
401,404,405,429en5xxvolgen het afgesproken beleid voor nieuwe pogingen; - time-outs leiden niet tot onbeperkte nieuwe pogingen;
- onjuiste JSON faalt veilig en legt een opgeschoonde diagnose vast;
- herhaalde idempotente
GET-verzoeken wijzigen de status bij de partner niet.
Tests voor exports van Parkour Design naar de partner
Stuurt Parkour Design gegevens naar een partner, voeg dan wederzijdse contracttests toe voor:
- het opvragen van bestemmingen en het valideren van identificaties;
- levering van alleen het bestand;
- levering van alleen gestructureerde gegevens;
- geslaagde levering van alle onderdelen;
- elke mogelijke combinatie van gedeeltelijk succes;
- onjuiste gestructureerde gegevens;
- lege en te grote bestanden;
- antwoorden
401,403,404,409,413,429en5xxvan de partner; - time-out bij het verbinden en bij het antwoord;
- dubbele verzending en idempotentie;
- ontkoppelen, opnieuw verbinden en verlopen van tokens.
Handmatige acceptatie
Voer het volgende uit in een echte browser in de gehoste testomgeving.
| Scenario | Verwacht resultaat |
|---|---|
| Juist account | Toestemming wordt afgerond en alleen de resources van die gebruiker worden teruggegeven |
| Toestemming geweigerd | De partner toont een herstelbare annulering en bewaart geen tokens |
| Verkeerd account bij Parkour Design | De partner toont de ingelogde identiteit en laat veilig opnieuw beginnen |
| Bestaande sessie bij de partner voor een ander account | Het wisselen van account volgt de goedgekeurde supportinstructies |
| Terug en vernieuwen | Geen autorisatiecode of state wordt twee keer geaccepteerd |
| Dubbele klik op verbinden | Eén browsertransactie blijft leidend |
| Gelijktijdige tabbladen | Een callback kan niet aan de verkeerde lokale transactie worden gekoppeld |
| Verlopen callback | De gebruiker kan opnieuw beginnen zonder verouderde verbindingsstatus |
| Verlopen toegangstoken | De partner vernieuwt één keer of vraagt opnieuw om autorisatie |
| Storing bij de partner of Parkour Design | De gebruiker krijgt een herstelbare melding zonder gevoelige diagnostiek |
| Ontkoppelen en opnieuw verbinden | Lokale tokens worden verwijderd en er kan een nieuwe identiteit worden vastgesteld |
Herhaal de kernflow in elke ondersteunde taal van de interface. Protocolwaarden blijven ongewijzigd, terwijl meldingen voor de gebruiker worden vertaald.
Bewijs voor de beveiligingsbeoordeling
Geef de beoordelaars:
- een diagram van de gegevensstroom met browser, beide backends, identiteitsprovider, API’s en opslag van tokens;
- allowlists voor redirect-URI’s en origins;
- de gevraagde scopes en de koppeling met resources;
- de instellingen voor versleuteling en bewaren van tokens;
- de instellingen voor de validatie van ID-tokens;
- opgeschoonde voorbeelden van logs en waarschuwingen;
- resultaten van scans op afhankelijkheden en geheimen;
- resultaten van automatische tests;
- het ingevulde verslag van de handmatige acceptatie;
- procedures voor het roteren van inloggegevens en voor incidenten.
Voeg nooit echte codes, tokens, clientgeheimen, privésleutels, ruwe UserInfo-antwoorden of klantgegevens als bewijs toe.
Observeerbaarheid
Leg genoeg informatie vast om fouten te diagnosticeren, zonder inloggegevens of persoonsgegevens vast te leggen:
- een correlatie-ID die de partner genereert;
- de omgeving en richting van de integratie;
- de naam van de handeling;
- de categorie van het upstream-endpoint, geen queryparameters;
- de HTTP-status en een veilige OAuth-foutcode;
- de duur en het aantal nieuwe pogingen;
- een opgeschoond aantal resources als dat operationeel nuttig is.
Log geen autorisatiecodes, toegangstokens, refresh tokens, ID-tokens, clientgeheimen, state, nonce, PKCE-verifier, volledige redirect-URL’s, e-mailadressen of inhoud van parcoursontwerpen.
Waarschuwingen moeten onderscheid maken tussen authenticatiefouten, autorisatiefouten, storingen bij de partner, vertraging, schemafouten en aanhoudende rate limiting.
Gereedheid voor productie
Voordat inloggegevens voor productie worden uitgegeven, keuren beide teams goed:
- de exacte productie-issuer en redirect-URI;
- de clientauthenticatie en de eigenaar van de inloggegevens;
- de scopes en toegankelijke resources;
- het verwachte volume en de huidige limieten van de API;
- het gedrag rond privacy, bewaren, ontkoppelen en verwijderen;
- de regels voor time-outs, nieuwe pogingen, idempotentie en gedeeltelijk succes;
- monitoring en escalatie van incidenten;
- supportinstructies voor gebruikers;
- een procedure om terug te draaien of de integratie uit te schakelen;
- het tijdvenster en de eigenaar van de smoke test in productie.
Gebruik verschillende clientgegevens voor test en productie. Lever ze via het goedgekeurde kanaal voor geheimen en controleer de rotatie voor de lancering.
Smoke test in productie
Houd de eerste test in productie beperkt:
- autoriseer één goedgekeurd intern account;
- valideer het ID-token en haal UserInfo op;
- vraag de lijst met evenementen op;
- vraag de ontwerpoverzichten van één bekend evenement op;
- controleer de scheiding tussen gebruikers en de verwachte velden;
- vernieuw één keer en bewaar het vervangende token;
- ontkoppel en verwijder de lokaal opgeslagen inloggegevens;
- bekijk de opgeschoonde logs en waarschuwingen;
- leg het resultaat vast en beslis of bredere toegang wordt ingeschakeld.
Test geen destructief gedrag of grote volumes in productie, tenzij dat uitdrukkelijk deel is van de goedgekeurde lanceringsprocedure.
Acceptatieverslag
Leg voor elk scenario vast:
- de omgeving en buildversie;
- de eigenaar van de test en de datum;
- de geanonimiseerde identiteit van de testgegevens;
- het verwachte resultaat;
- het werkelijke resultaat;
- de plaats van het bewijs;
- het defect of de geaccepteerde beperking;
- de eigenaar van de goedkeuring.
Een niet-gedocumenteerde beperking is geen geaccepteerde beperking. Neem onopgeloste contract- of beveiligingsproblemen op in de lanceringsbeslissing voordat productietoegang wordt ingeschakeld.