Troubleshooting (диагностика)
Типичные сбои интегратора при вызовах Runtime или проверке lease. Предпочитайте typed code из каталога ошибок, а не парсинг free-text.
Быстрая карта
| Симптом | Сначала проверьте |
|---|---|
| Auth / unknown license | Нормализация ключа; чужое env; revoke/rotate — Ключи лицензий |
| Lease / JWS reject | JWKS kid, alg=ES256, typ, expiry, audience — Проверка доверия |
| Offline / air-gapped deny | Lease exp, свежесть trust bundle — Offline · Air-gapped |
| Floating seat denied | Checkout/heartbeat/release — Floating |
| Config apply failed | Fail-closed на плохой typ / подпись — Runtime configuration |
| Rate limit / retry storm | retryable + backoff из каталога ошибок; без busy-loop |
Typed degraded | Считать не allow — Production checklist |
Гигиена логов
Не логируйте полные license keys, lease tokens, JWE payload или PSP secrets. Только public prefix — Secrets.
Когда эскалировать
Если OpenAPI и каталог ошибок расходятся с HTTP status, сохраните correlationId (без секретов) и тикет с environment + версией SDK (SDKs).