Menu van de documentatie
Per partner Laatst bijgewerkt: 27 juli 2026

Testen en lancering

Controleer OAuth, identiteit, scheiding tussen gebruikers, resourcecontracten, foutafhandeling en de gereedheid voor productie.

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:

  • issuer exact gelijk is aan de ingestelde test-issuer;
  • de endpoints voor autorisatie, token, UserInfo en JWKS HTTPS gebruiken;
  • code, authorization_code, refresh_token, RS256 en S256 aanwezig 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, nonce en 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_denied af 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, 429 en 5xx volgen 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, 429 en 5xx van 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.

ScenarioVerwacht resultaat
Juist accountToestemming wordt afgerond en alleen de resources van die gebruiker worden teruggegeven
Toestemming geweigerdDe partner toont een herstelbare annulering en bewaart geen tokens
Verkeerd account bij Parkour DesignDe partner toont de ingelogde identiteit en laat veilig opnieuw beginnen
Bestaande sessie bij de partner voor een ander accountHet wisselen van account volgt de goedgekeurde supportinstructies
Terug en vernieuwenGeen autorisatiecode of state wordt twee keer geaccepteerd
Dubbele klik op verbindenEén browsertransactie blijft leidend
Gelijktijdige tabbladenEen callback kan niet aan de verkeerde lokale transactie worden gekoppeld
Verlopen callbackDe gebruiker kan opnieuw beginnen zonder verouderde verbindingsstatus
Verlopen toegangstokenDe partner vernieuwt één keer of vraagt opnieuw om autorisatie
Storing bij de partner of Parkour DesignDe gebruiker krijgt een herstelbare melding zonder gevoelige diagnostiek
Ontkoppelen en opnieuw verbindenLokale 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:

  1. autoriseer één goedgekeurd intern account;
  2. valideer het ID-token en haal UserInfo op;
  3. vraag de lijst met evenementen op;
  4. vraag de ontwerpoverzichten van één bekend evenement op;
  5. controleer de scheiding tussen gebruikers en de verwachte velden;
  6. vernieuw één keer en bewaar het vervangende token;
  7. ontkoppel en verwijder de lokaal opgeslagen inloggegevens;
  8. bekijk de opgeschoonde logs en waarschuwingen;
  9. 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.