Nabídka dokumentace
Pro konkrétního partnera Naposledy aktualizováno: 27. července 2026

Testování a spuštění

Ověřte OAuth, identitu, izolaci uživatelů, kontrakty zdrojů, zpracování chyb a připravenost na produkci.

Než budou vydány produkční přihlašovací údaje, otestujte celou integraci proti testovacímu prostředí Parkour Design. Automatické kontroly prokážou, že protokol a kontrakt fungují; ruční akceptace prokáže uživatelskou cestu a provozní obnovu.

Pravidlo spuštění: Úspěšný autorizační callback k akceptaci nestačí. Spuštění vyžaduje ověření identity, izolaci uživatelů, rotaci tokenů, testy kontraktu zdrojů, obnovu po chybách a schválení oběma týmy.

Předpoklady testování

Parkour Design a partner musí připravit:

  • registrovaného testovacího klienta a bezpečně předaný tajný klíč;
  • přesnou testovací URI přesměrování;
  • schválenou sadu scope;
  • alespoň dva testovací uživatele Parkour Design;
  • akce a projekty vlastněné každým uživatelem zvlášť;
  • prázdný účet nebo akci, kde je to relevantní;
  • technické kontakty a kontakty pro incidenty;
  • očekávané výsledky každého akceptačního případu.

Použijte testovacího vydavatele:

https://parkour-test.web.app

Testovací přihlašovací údaje, URL callbacků, tokeny ani uživatelská data znovu nepoužívejte v produkci.

Úvodní kontroly

Discovery

curl --fail-with-body \
  "https://parkour-test.web.app/.well-known/openid-configuration"

Zkontrolujte, že:

  • issuer přesně odpovídá nakonfigurovanému testovacímu vydavateli;
  • endpointy autorizace, tokenu, UserInfo a JWKS používají HTTPS;
  • jsou přítomny code, authorization_code, refresh_token, RS256 a S256;
  • v discovery není vidět žádný tajný klíč klienta ani jiná soukromá hodnota prostředí.

Podpisové klíče

Načtěte jwks_uri z discovery a zkontrolujte, že každý použitelný klíč má kid, kty, použití pro podpis a schválený algoritmus. Klient musí neznámý kid zpracovat tak, že JWKS jednou obnoví, než token odmítne.

Požadavek na zdroje bez autentizace

curl --include "https://parkour-test.web.app/api/events"

Očekávaný výsledek:

HTTP/2 401
Content-Type: application/json

{"error":"invalid_token"}

Automatické testy OAuth

Tyto případy automatizujte na hranici partnera. Používejte kontrolovaná testovací data a externí krok v prohlížeči simulujte jen tehdy, když úplný test v prohlížeči není praktický.

Autorizační požadavek

  • obsahuje přesné ID klienta, URI přesměrování a schválené scope;
  • vytváří jedinečné hodnoty state, nonce a ověřovače PKCE s vysokou entropií;
  • posílá code_challenge_method=S256;
  • nevkládá tajný klíč klienta ani ověřovač do URL;
  • v negativním testu prostředí odmítne neregistrovanou nebo nepatrně odlišnou URI přesměrování.

Callback

  • přijme správný state jednou;
  • odmítne chybějící, nesprávný, vypršelý a opakovaně použitý state;
  • zpracuje access_denied bez výměny kódu;
  • odmítne chybějící kód v jinak úspěšném callbacku;
  • zachová jen ověřenou místní cestu pro návrat;
  • nezpřístupní prohlížeči diagnostiku protokolu ani osobní údaje.

Výměna kódu

  • ověřuje se pomocí client_secret_basic;
  • používá stejnou URI přesměrování jako autorizační požadavek;
  • posílá původní ověřovač PKCE;
  • odmítne vypršelé, opakovaně použité kódy, kódy jiného klienta a kódy s nesprávným ověřovačem;
  • s odpověďmi s tokeny zachází jako s neukládatelnými do mezipaměti a drží je na serveru.

Ověření ID tokenu

Odmítněte tokeny s:

  • neplatným podpisem;
  • neznámým podpisovým klíčem po obnovení JWKS;
  • nesprávným vydavatelem;
  • nesprávnou cílovou skupinou;
  • jiným algoritmem než RS256;
  • chybějící nebo nesprávnou nonce;
  • vypršelými nebo nesmyslnými časovými nároky;
  • chybějícím subjektem.

Zkontrolujte, že propojení účtů používá dvojici iss a sub, ne jen e-mail.

Rotace při obnovení

  • platný obnovovací token vrátí nový přístupový token a náhradní obnovovací token;
  • náhrada se uloží atomicky;
  • obnovení probíhají postupně pro každého uživatele a relaci klienta;
  • opětovné použití starého obnovovacího tokenu je odmítnuto;
  • token vydaný jinému klientovi je odmítnut;
  • vypršelý token vyžaduje nový autorizační tok;
  • vypršení času nebo ztracená odpověď na obnovení s neznámým výsledkem vymaže místní stav tokenů a zahájí nový autorizační tok, místo opakování se starým tokenem;
  • souběžné pokusy o obnovení nemohou soupeřit o stejný token;
  • místní odpojení smaže aktivní obnovovací token a data relace.

Parkour Design v současnosti nemá veřejný endpoint pro odvolání. Testy nesmějí místní smazání vykazovat jako odvolání na serveru.

Automatické testy zdrojů

Autentizace a izolace

  • bez tokenu se vrátí 401 invalid_token;
  • vypršelý nebo chybně formátovaný token vrátí 401 invalid_token;
  • ID token použitý jako bearer token pro API je odmítnut;
  • uživatel A vidí jen akce a projekty uživatele A;
  • uživatel B nemůže načíst akci uživatele A zkopírováním jejího ID;
  • nedostupné i neexistující akce vrátí shodně 404 not_found.

Kontrakt schématu

Každou odpověď ověřte proti schématu, které vlastní partner:

  • povinné vlastnosti jsou přítomny;
  • vlastnosti, které mohou být null, přijímají null;
  • data se zpracují jako hodnoty ISO 8601;
  • neznámé další vlastnosti nesmějí klienta rozbít;
  • prázdné kolekce vracejí prázdné pole items;
  • s identifikátory se zachází jako s neprůhlednými řetězci;
  • text podporuje Unicode a zobrazuje se bezpečně.

Ze schématu souhrnů neodvozujte úplný plán parkuru.

Limity a chyby

  • klient zvládne největší schválený seznam akcí;
  • současný limit 500 projektů v detailu je součástí hodnocení rizik před spuštěním;
  • odpovědi 401, 404, 405, 429 a 5xx se řídí dohodnutou politikou opakování;
  • vypršení času nespouští neomezené opakování;
  • chybně formátovaný JSON selže bezpečně a uloží očištěnou diagnostiku;
  • opakované idempotentní požadavky GET nemění stav partnera.

Testy exportu z Parkour Design k partnerovi

Když Parkour Design posílá data partnerovi, přidejte vzájemné testy kontraktu pro:

  • výpis cílů a ověření identifikátorů;
  • doručení jen souboru;
  • doručení jen strukturovaných dat;
  • úspěšné doručení všech částí;
  • každou možnou kombinaci částečného úspěchu;
  • chybně formátovaná strukturovaná data;
  • prázdné a příliš velké soubory;
  • odpovědi partnera 401, 403, 404, 409, 413, 429 a 5xx;
  • vypršení času při připojení a při odpovědi;
  • dvojí odeslání a idempotenci;
  • odpojení, opětovné připojení a vypršelý token.

Ruční akceptace

Proveďte následující ve skutečném prohlížeči proti nasazenému testovacímu prostředí.

ScénářOčekávaný výsledek
Správný účetSouhlas se dokončí a vrátí se jen zdroje tohoto uživatele
Odmítnutý souhlasPartner zobrazí stav přerušení, ze kterého se lze zotavit, a neuloží žádné tokeny
Nesprávný účet v Parkour DesignPartner zobrazí přihlášenou identitu a umožní bezpečný nový začátek
Existující partnerská relace jiného účtuPřepnutí účtu funguje podle schválených pokynů podpory
Zpět a obnoveníŽádný autorizační kód ani hodnota state se nepřijme dvakrát
Dvojklik na připojitPlatná zůstane jedna transakce prohlížeče
Souběžné kartyCallback nelze spárovat s nesprávnou místní transakcí
Vypršelý callbackUživatel může začít znovu bez zastaralého stavu připojení
Vypršelý přístupový tokenPartner jednou obnoví, nebo znovu požádá o autorizaci
Výpadek partnera nebo Parkour DesignUživatel dostane zprávu o problému, ze kterého se lze zotavit, bez citlivé diagnostiky
Odpojení a opětovné připojeníMístní tokeny se smažou a lze stanovit novou identitu

Základní tok zopakujte v každém jazyce, který rozhraní podporuje. Hodnoty protokolu musí zůstat beze změny, zatímco zprávy pro uživatele se lokalizují.

Podklady pro bezpečnostní kontrolu

Poskytněte kontrolorům:

  • diagram toku dat zobrazující prohlížeč, oba backendy, poskytovatele identity, API a úložiště tokenů;
  • povolené URI přesměrování a původy;
  • požadované scope a jejich mapování na zdroje;
  • nastavení šifrování a uchovávání tokenů;
  • nastavení ověřování ID tokenu;
  • očištěné příklady logů a upozornění;
  • výsledky skenování závislostí a tajných klíčů;
  • výsledky automatických testů;
  • vyplněný protokol ruční akceptace;
  • postupy rotace přihlašovacích údajů a řešení incidentů.

Jako podklady nikdy nepřikládejte skutečné kódy, tokeny, tajné klíče klientů, soukromé klíče, surové odpovědi UserInfo ani data zákazníků.

Pozorovatelnost

Ukládejte dost informací pro diagnostiku chyb, aniž byste ukládali přihlašovací údaje nebo osobní údaje:

  • ID korelace vytvořené partnerem;
  • prostředí a směr integrace;
  • název operace;
  • kategorii navazujícího endpointu, ne parametry dotazu;
  • stav HTTP a bezpečný kód chyby OAuth;
  • dobu trvání a počet opakování;
  • očištěný počet zdrojů, pokud je to provozně užitečné.

Nelogujte autorizační kódy, přístupové tokeny, obnovovací tokeny, ID tokeny, tajné klíče klientů, state, nonce, ověřovače PKCE, úplné URL přesměrování, e-mailové adresy ani obsah plánů parkuru.

Upozornění mají rozlišovat chyby autentizace, chyby autorizace, výpadky partnera, latenci, chyby schématu a trvalé omezení rychlosti.

Připravenost na produkci

Než budou vydány produkční přihlašovací údaje, musí oba týmy schválit:

  • přesného produkčního vydavatele a URI přesměrování;
  • autentizaci klienta a vlastníka přihlašovacích údajů;
  • scope a dostupné zdroje;
  • očekávaný objem a současné limity API;
  • soukromí, uchovávání, odpojení a mazání;
  • pravidla pro vypršení času, opakování, idempotenci a částečné úspěchy;
  • monitoring a eskalaci incidentů;
  • pokyny podpory pro uživatele;
  • postup vrácení nebo vypnutí integrace;
  • časové okno a odpovědnou osobu pro smoke test v produkci.

Pro test a produkci používejte různé přihlašovací údaje klienta. Předejte je schváleným kanálem pro tajné klíče a před spuštěním ověřte rotaci.

Smoke test v produkci

První test v produkci držte úzký:

  1. autorizujte schválený interní účet;
  2. ověřte ID token a načtěte UserInfo;
  3. vyžádejte seznam akcí;
  4. vyžádejte souhrny projektů pro známou akci;
  5. zkontrolujte izolaci uživatelů a očekávaná pole;
  6. jednou obnovte a uložte náhradní token;
  7. odpojte se a smažte místně uložené přihlašovací údaje;
  8. projděte očištěné logy a upozornění;
  9. zdokumentujte výsledek a rozhodněte, zda zapnout širší přístup.

Destruktivní chování ani vysoký objem v produkci netestujte, pokud to výslovně není součástí schváleného postupu spuštění.

Protokol akceptace

U každého scénáře zdokumentujte:

  • prostředí a verzi sestavení;
  • odpovědnou osobu za test a datum;
  • anonymizovanou identitu testovacích dat;
  • očekávaný výsledek;
  • skutečný výsledek;
  • kde jsou podklady;
  • chybu nebo přijaté omezení;
  • odpovědnou osobu za schválení.

Nezdokumentované omezení není přijaté omezení. Nevyřešené problémy kontraktu nebo bezpečnosti doplňte do rozhodnutí o spuštění dřív, než zapnete produkční přístup.