Průvodce migrací: změna způsobu ověřování
Postupně vylepšujeme naši cloudovou platformu, a proto je nutné převést váš způsob ověřování na nový systém. Tento průvodce vám pomůže přejít na přepracovanou ověřovací vrstvu, která přináší vyšší zabezpečení, lepší kompatibilitu a podporu OpenID Connect (OIDC). Postupujte podle kroků níže, aby přechod proběhl hladce.
Čeho se změna týká
- Všech požadavků na API – autorizovaných i neautorizovaných.
- Všech požadavků na ověření – změnili jsme službu, která vydává přístupové tokeny.
Hlavní změny
- Zastaralé endpointy: Stávající autorizační endpointy API (
https://api.dronetag.app/v1/auth/*) jsou nyní zastaralé (deprecated). Musíte přejít na novou službu (https://auth.dronetag.app). - Přihlašovací údaje OAuth 2.0: K přihlášení budou nově potřeba přihlašovací údaje aplikace OAuth 2.0. Dokud nebude k dispozici automatizovaná správa OAuth 2.0, vydáváme je ručně.
Harmonogram migrace
- Do konce února 2025: Původní autorizační endpointy budou úplně odstraněny. Všechny autorizační požadavky musí do té doby přejít na novou službu.
Migrace krok za krokem
1. Použijte knihovnu pro OpenID Connect (OIDC) (doporučeno)
Přechod si nejvíce usnadníte, když použijete existující knihovnu OIDC pro OAuth 2.0. Tyto knihovny obsluhují celý tok OAuth 2.0 včetně přístupových tokenů, obnovovacích tokenů (refresh token) a dalších úloh souvisejících s OIDC.
Seznam certifikovaných implementací OIDC najdete zde: OpenID Connect Certified Libraries.
2. Převeďte autorizační požadavky na novou ověřovací službu
Všechny autorizační požadavky musí směřovat na nový endpoint:
- Původní endpoint:
POST https://api.dronetag.app/v1/auth/jwt/token - Nový endpoint:
POST https://auth.dronetag.app/realms/master/protocol/openid-connect/token
Upravte logiku požadavků tak, aby mířila na novou URL, a počítejte s jinou strukturou odpovědi JSON. Nová odpověď obsahuje mimo jiné pole access_token a refresh_token.