Quickstarts
Jeder Quickstart führt ein Framework von einem leeren Projekt zu entweder einer API, die nur gültige KeenAuth-Zugriffstokens akzeptiert, oder zu einer Web-App, die Benutzer anmeldet. Jeder Quickstart stammt aus einem lauffähigen Beispiel, dessen Tests offline mit dem Test-Kit des SDK laufen. Der Code auf diesen Seiten ist also der Code, den die Tests prüfen.
Ihre API absichern
| Framework | Quickstart |
|---|---|
Go net/http |
Eine Go-API absichern |
| Node.js Express | Eine Express-API absichern |
| Python FastAPI | Eine FastAPI-API absichern |
| Python Django | Eine Django-API absichern |
Die vier API-Quickstarts erstellen dieselbe API: einen öffentlichen Endpunkt, einen Endpunkt, der ein gültiges Zugriffstoken verlangt, und einen Endpunkt, der zusätzlich den Scope messages:read verlangt. Sie lesen ihre Konfiguration ausschließlich aus Umgebungsvariablen:
| Variable | Bedeutung |
|---|---|
KEENAUTH_ISSUER |
Der Issuer Ihrer Umgebung, zum Beispiel https://your-environment.eu.keenauth.app |
KEENAUTH_AUDIENCE |
Der Identifier Ihrer API, die Audience ihrer Zugriffstokens |
PUBLIC_BASE_URL |
Die URL, die Clients aufrufen; erforderlich, https (http nur für localhost) |
Benutzer anmelden
| Framework | Quickstart |
|---|---|
| Next.js (App Router) | Anmeldung zu einer Next.js-App hinzufügen |
| React Single-Page-App (Vite) | Anmeldung zu einer React-Single-Page-App hinzufügen |
| React Router (Framework-Modus) | Anmeldung zu einer React-Router-App hinzufügen |
| Laravel | Anmeldung zu einer Laravel-App hinzufügen |
| Spring Boot | Anmeldung zu einer Spring-Boot-App hinzufügen |
| ASP.NET Core | Anmeldung zu einer ASP.NET-Core-App hinzufügen |
Die Next.js-App ist der OAuth-Client und hält alle Tokens auf dem Server; ebenso die React-Router-App, mit dem standardmäßigen OpenID-Connect-Client openid-client. Die React-Single-Page-App ist ein Public Client: Ihre Tokens bleiben im Arbeitsspeicher des Browsers, an einen DPoP-Schlüssel gebunden. Die anderen Web-Apps verwenden eine Standard-OpenID-Connect-Client-Bibliothek ihres Frameworks und halten alle Tokens in der serverseitigen Sitzung. Alle lesen ihre Konfiguration aus Umgebungsvariablen (siehe jeweilige Seite) und rufen eine geschützte API mit dem Zugriffstoken des Benutzers auf.
Fastify und Flask verwenden dieselbe Middleware; siehe Ihre API mit Middleware schützen.