Laravel-Integration

Sendity in einer Laravel-Anwendung nutzen.

Installieren Sie den Laravel-Auth-Adapter, wenn sich Sendity in einer Laravel-Anwendung nativ anfühlen soll. Der Adapter bindet den Client ein, prüft das signierte Ergebnis auf Ihrem Server und meldet die Person in Ihrer Anwendung an.

composer require sendity/laravel-auth:^0.3

Die gehostete Kampagne konfigurieren

Für den Standardablauf mit der Cloud konfigurieren Sie die Kampagnen-ID, den Aussteller des Ergebnis-Tokens, die erwartete Audience und den öffentlichen Prüfschlüssel von Sendity. Die erwartete Audience entspricht der Kampagnen-ID. Von Sendity ausgestellte Ergebnis-Tokens sind immer an eine Kampagne gebunden und unterstützen keine separate, globale JWT-Audience. Behalten Sie die Standardwerte für die gehostete API und die Client-Assets bei, sofern Sie Sendity nicht selbst betreiben. Die client_secret-Werte eines AuthRequests im Browser sind Zugangsdaten pro Anfrage, die die API zurückliefert. Legen Sie sie nicht in Laravel-env-Dateien, Blade, JavaScript oder HTML ab.

SENDITY_APP_PUBLIC_KEY=app_01HX...
SENDITY_SERVER_URL=https://sendity.io/api
SENDITY_ISSUER=https://sendity.io
SENDITY_AUDIENCE=app_01HX...
SENDITY_PUBLIC_KEY="-----BEGIN PUBLIC KEY-----..."

Den Client einbinden

Platzieren Sie die Blade-Komponente dort, wo der Nachweis beginnen soll. Der Adapter bindet das Client-Skript einmal ein, übergibt die Kampagnen-ID und nutzt für die Session-Übergabe die serverseitige session_handoff_url, die Sendity zurückliefert.

<x-sendity />

Eigene Alternativen wie Passkeys platzieren Sie in Ihrem Layout neben oder unter dem Client. Sie sind eigenständige Anmeldeoptionen, keine Slots innerhalb der Sendity-Komponente.

<x-sendity />

<div class="my-4 border-t"></div>

<button type="button">
    Sign in with a passkey
</button>

Kontoverwaltung anpassen

Ihre Laravel-Anwendung bleibt für das Finden, Anlegen, Verknüpfen und Berechtigen von Nutzern zuständig. Ordnen Sie verifizierte Adressen über die Hooks des Adapters und Laravel-Events Ihrem Domänenmodell zu und leiten Sie Nutzer dann in den richtigen Bereich weiter.

Selbst betriebenes Sendity nutzt dieselbe Adapter-Grenze. Richten Sie Adapter und Client nur dann auf Ihren eigenen Server aus, wenn Sie das Verifizierungs-Backend selbst betreiben.