forked from Onyva/onyva-login-skill
Timo Uttenweiler
366edf55d9
Major SKILL.md update: lessons learned from real integrations - Add IdP-initiated SSO handling (Admin-Panel sends ?code= only, no state) → state missing must NOT trigger 400, otherwise admin-panel app tiles break - Add Middleware-Reihenfolge warning (SessionMiddleware LIFO footgun) - Add Auth-Guard distinction: HTML-Navigation 307 vs JSON-API 401 - Add Frontend 401-handling pattern (hard navigation, not fetch redirect) - Add stdlib-only HTTP + JWT-decode helpers (urllib.request + base64url padding) - Add Session-Storage options table (in-memory / SessionMiddleware / Redis) - Add CLIENT_SECRET generation guidance (admin-panel vs locally) - Add Smoke-Test mit curl (5 calls catching 90% of typical bugs) - Add "replace existing auth" checklist (remove old constants/routes/HTML) - Cookie flags: explain why samesite=lax (not strict) for OIDC callback - Logout: two separate functions, FastAPI doesn't support decorator stacking - Hard restart guidance for middleware iteration - Many additional Fallstricke entries from real bugs
onyva-login — Claude Code Skill
Integriert den zentralen Onyva Dev Login (OIDC/SSO unter https://login.onyva.dev) in ein bestehendes Projekt.
Was der Skill macht
Claude analysiert das aktuelle Projekt, fragt nach den nötigen Credentials und implementiert dann:
- Authorization Code Flow mit PKCE
- Session-Management mit JWT-Claims
- Auth Guard / Middleware für geschützte Routen
- Zentrales Logout (Single Sign-Out)
AUTH_ENABLED=falseBypass für lokale Entwicklung- Env-Variablen und
.env.example
Installation
/plugin install onyva-login@onyva-marketplace
oder direkt per URL:
/plugin install https://gitea.onyva.dev/Onyva/onyva-login-skill
Nutzung
In Claude Code:
/onyva-login
oder einfach schreiben: „Integriere den Onyva Login in dieses Projekt"
Voraussetzungen
- App muss im Admin-Panel von login.onyva.dev angelegt sein
client_id,client_secretund Redirect URI aus dem Admin-Panel bereithalten