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:
issuerpř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,RS256aS256; - 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,noncea 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_deniedbez 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,429a5xxse ří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
GETnemě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,429a5xx; - 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ý účet | Souhlas se dokončí a vrátí se jen zdroje tohoto uživatele |
| Odmítnutý souhlas | Partner zobrazí stav přerušení, ze kterého se lze zotavit, a neuloží žádné tokeny |
| Nesprávný účet v Parkour Design | Partner zobrazí přihlášenou identitu a umožní bezpečný nový začátek |
| Existující partnerská relace jiného účtu | Př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řipojit | Platná zůstane jedna transakce prohlížeče |
| Souběžné karty | Callback nelze spárovat s nesprávnou místní transakcí |
| Vypršelý callback | Uživatel může začít znovu bez zastaralého stavu připojení |
| Vypršelý přístupový token | Partner jednou obnoví, nebo znovu požádá o autorizaci |
| Výpadek partnera nebo Parkour Design | Už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ý:
- autorizujte schválený interní účet;
- ověřte ID token a načtěte UserInfo;
- vyžádejte seznam akcí;
- vyžádejte souhrny projektů pro známou akci;
- zkontrolujte izolaci uživatelů a očekávaná pole;
- jednou obnovte a uložte náhradní token;
- odpojte se a smažte místně uložené přihlašovací údaje;
- projděte očištěné logy a upozornění;
- 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.