Schnellstart mit der Cloud
Sendity in zwei Schritten in Ihre Anwendung einbauen.
Starten Sie mit Sendity Cloud: Legen Sie eine Kampagne an, erlauben Sie Ihre Produktions- und lokalen Origins, kopieren Sie die Kampagnen-ID und lassen Sie dann einen Framework-Adapter das gehostete Verifizierungsergebnis mit der Session Ihrer Anwendung verbinden.
Vor dem Programmieren
Legen Sie eine kostenlose Kampagne in Sendity Cloud an.
Erstellen Sie ein Konto auf sendity.io, legen Sie eine Kampagne an und wählen Sie, ob sie E-Mail-Adressen oder Telefonnummern verifiziert. Erlauben Sie Ihre Produktions- und lokalen Origins und kopieren Sie dann die Kampagnen-ID in Ihr Laravel-Projekt. Das HTML-Attribut und der Konfigurationswert heißen weiterhin public-key.
- Zuerst die Cloud-Kampagne: Nutzen Sie die gehostete Sendity API und die Kampagnen-ID Ihrer Kampagne. Für den Standardablauf brauchen Sie kein Sendity-Serverpaket.
- Der Adapter übernimmt die Übergabe: Der Adapter bindet den Client ein, prüft das signierte Ergebnis serverseitig und legt Ihre lokale Session an.
- Zwei nötige Schritte: Installieren Sie den Framework-Adapter und platzieren Sie den Client dort, wo Registrierung oder Anmeldung stattfinden sollen.
1. Adapter installieren
Fügen Sie das Laravel-Auth-Paket hinzu.
Der Adapter verbindet Ihr Framework mit Sendity Cloud. Konfigurieren Sie ihn mit Ihrer Kampagnen-ID und behalten Sie die Standardwerte für die Cloud API und die gehosteten Client-Assets bei, sofern Sie Sendity nicht bewusst selbst betreiben.
composer require sendity/laravel-auth:^0.32. Client einbinden
Zeigen Sie Sendity in Ihrer Anmeldemaske an.
Setzen Sie die Blade-Komponente in Ihre Login-, Registrierungs- oder Step-up-Ansicht. Die Komponente bindet den Browser-Client ein, nutzt standardmäßig die gehostete API und übergibt das signierte Ergebnis an den Laravel-Adapter.
<x-sendity />Bei eigenen Abläufen hören Sie auf sendity:authenticated und prüfen das signierte Ergebnis in Ihrem Backend, bevor Sie eine Session anlegen. Im Standardfall übernimmt das der Laravel-Adapter für Sie.
Selbst betreiben ist optional.
Der Schnellstart geht von Sendity Cloud aus. Wenn Ihr Team das Verifizierungs-Backend selbst betreiben muss, behalten Sie dasselbe Integrationsmodell für den Client bei und folgen Sie der Anleitung zum Selbstbetrieb, sobald der Cloud-Ablauf klar ist.