Přehled endpointů

Interaktivní API dokumentace

Pro kompletní a vždy aktuální API dokumentaci navštivte Swagger UI na vaší instanci Klubero SSO:

https://your-sso-domain.com/documentation

Swagger poskytuje:

• Interaktivní testování API
• Příklady požadavků/odpovědí
• Všechny dostupné parametry
• Požadavky na autentizaci

---

Základní OIDC endpointy

Toto jsou standardní OpenID Connect endpointy:

Endpoint	URL	Popis
Discovery	/.well-known/openid-configuration	Metadata OpenID konfigurace
JWKS	/.well-known/jwks	Veřejné klíče pro ověření tokenů
Authorization	/connect/authorize	Zahájení OAuth flow
Token	/connect/token	Výměna kódu za tokeny
UserInfo	/connect/userinfo	Získání claims uživatele
Logout	/connect/logout	Ukončení relace uživatele
Introspection	/connect/introspect	Validace tokenu
Revocation	/connect/revoke	Zneplatnění tokenu

---

Discovery endpoint

Discovery endpoint poskytuje veškerou konfiguraci potřebnou pro integraci s Klubero SSO:

curl https://your-sso-domain.com/.well-known/openid-configuration

Odpověď:

{
  "issuer": "https://your-sso-domain.com/",
  "authorization_endpoint": "https://your-sso-domain.com/connect/authorize",
  "token_endpoint": "https://your-sso-domain.com/connect/token",
  "userinfo_endpoint": "https://your-sso-domain.com/connect/userinfo",
  "end_session_endpoint": "https://your-sso-domain.com/connect/logout",
  "jwks_uri": "https://your-sso-domain.com/.well-known/jwks",
  "scopes_supported": ["openid", "profile", "email", "offline_access", "..."],
  "response_types_supported": ["code", "id_token", "token"],
  "grant_types_supported": ["authorization_code", "refresh_token", "client_credentials"],
  "code_challenge_methods_supported": ["S256", "plain"]
}

---

Další API endpointy

Kromě OIDC poskytuje Klubero SSO další API:

Kategorie	Base Path	Popis
Magic Link	/api/magiclink/*	Autentizace bez hesla
Two-Factor	/api/twofactor/*	2FA ověření
Users	/api/users/*	Správa uživatelů
Sessions	/api/sessions/*	Správa relací

tip

Pro kompletní detaily o všech API endpointech, parametrech a formátech odpovědí se podívejte na Swagger dokumentaci na vaší SSO instanci.