Selbst betreiben / Server

Das Kampagnenmodell für den Selbstbetrieb nachbauen.

In Sendity Cloud bildet eine Kampagne die Konfigurationsgrenze zwischen einer Website und dem Verifizierungs-Backend. Selbst betriebene Installationen brauchen dasselbe Konzept, auch wenn Sie es über eine eigene Admin-Oberfläche bereitstellen oder aus der Konfiguration befüllen.

Pflichtfelder

public_app_id: Die Kampagnen-ID. Sie darf als Attribut public-key im Markup stehen. Der Client nutzt sie beim Erstellen von Challenges.
client_secret: Serverseitiges Zugangsdatum für Adapter und vertrauenswürdige Backend-Aufrufe. Zeigen Sie es beim Anlegen einmal an und speichern Sie es nach Möglichkeit nur gehasht.
allowed_origins: Origins, die für diese Kampagne Challenges im Browser erstellen dürfen.
verification_channel: Der eine Kanal der Kampagne: E-Mail oder Telefon. Die Empfänger des Kanals bleiben Teil der Serverkonfiguration.

Für jeden AuthRequest leitet der Server die verification_action ab. E-Mail-Aktionen enthalten das konfigurierte Postfach und eine vollständige mailto:-URL. Telefon-Aktionen nennen den konfigurierten Transport (WhatsApp oder SMS/RCS), dessen Empfänger und eine vollständige Aktions-URL. WhatsApp nutzt die offizielle Meta-Plattform und gehört zum Kanal phone. Der Browser-Client darf keinen dieser Werte selbst zusammensetzen.

Umgang mit Secrets

Client Secrets sind betriebliche Zugangsdaten. Erzeugen Sie sie mit ausreichender Entropie, zeigen Sie sie nur einmal an, ermöglichen Sie eine Rotation und geben Sie sie nie als kopierbare, maskierte Werte an Nutzer zurück. Der Browser-Client braucht nur die Kampagnen-ID.