Didit Verification für Joomla einrichten

Didit Verification verbindet Ihre Joomla-Website mit Didit, damit angemeldete Benutzer eine Identitätsprüfung durchführen können. Nach erfolgreicher Prüfung kann der Benutzer automatisch einer Joomla-Benutzergruppe zugewiesen werden.

Voraussetzungen

Sie benötigen:

  • Eine Joomla-Website
  • Die installierte Erweiterung Didit Verification
  • Einen Zugang zur Didit Console
  • Einen Didit API Key
  • Eine Didit Workflow ID
  • Den Didit Webhook Secret Key

1. Erweiterung installieren

Öffnen Sie im Joomla-Backend:

System -> Install -> Extensions

Laden Sie das Installationspaket hoch und installieren Sie es.

Nach der Installation finden Sie Didit Verification im Joomla-Backend.

2. Plugin aktivieren

Öffnen Sie:

System -> Manage -> Plugins

Suchen Sie nach:

Didit Webhook

Aktivieren Sie das Plugin.

Ohne dieses Plugin können Webhooks, Callback-Aufrufe und automatische Lizenzprüfungen nicht verarbeitet werden.

3. Didit API Key und Webhook Secret finden

Öffnen Sie die Didit Console.

Gehen Sie zu:

Settings -> API & Webhooks

Kopieren Sie dort:

  • API Key
  • Webhook Secret Key

Der API Key wird verwendet, um neue Verifizierungssitzungen bei Didit zu erstellen. Der Webhook Secret Key wird verwendet, um eingehende Webhooks sicher zu prüfen.

4. Workflow ID erstellen oder kopieren

Öffnen Sie in der Didit Console:

Workflows

Erstellen Sie einen neuen Workflow oder öffnen Sie einen vorhandenen Workflow. Kopieren Sie die Workflow ID.

Der Workflow bestimmt, welche Schritte der Benutzer durchläuft, z.B. Ausweisprüfung, Liveness Check oder Altersprüfung.

5. Didit Verification in Joomla konfigurieren

Öffnen Sie im Joomla-Backend:

Components -> Didit Verification -> Settings

Tragen Sie ein:

  • API Key
  • Workflow ID
  • Webhook Secret
  • Approved Usergroup

Die Approved Usergroup ist die Joomla-Benutzergruppe, in die ein Benutzer nach erfolgreicher Verifizierung verschoben oder hinzugefügt wird.

6. Webhook URL bei Didit eintragen

In den Didit Verification Settings sehen Sie eine Webhook URL.

Kopieren Sie diese URL und tragen Sie sie in der Didit Console unter:

Settings -> API & Webhooks

als Webhook Endpoint ein.

Didit sendet die Ergebnisse der Verifizierung an diese URL.

7. Callback URL

Die Callback URL wird verwendet, um Benutzer nach Abschluss der Verifizierung zurück zu Ihrer Website zu führen.

Die Erweiterung übergibt diese URL automatisch an Didit, wenn eine neue Verifizierung gestartet wird. Sie dient hauptsächlich zur Kontrolle und Orientierung.

8. Modul veröffentlichen

Wenn Sie das Status-Modul verwenden möchten, öffnen Sie:

Content -> Site Modules

Suchen Sie nach:

Didit Verification Status

Veröffentlichen Sie das Modul an einer gewünschten Position.

9. Pro-Lizenz eintragen

Falls Sie Pro-Funktionen verwenden, tragen Sie Ihren Lizenzschlüssel in den Didit Verification Settings ein.

Die Lizenz wird automatisch für die aktuelle Domain aktiviert und regelmäßig geprüft.

Pro-Funktionen können sein:

  • Altersprüfung
  • Ablaufdatum von Dokumenten speichern
  • Revalidierung bei abgelaufenem Dokument
  • Ablaufdatum im Frontend anzeigen

10. Test durchführen

Melden Sie sich im Frontend als Benutzer an und starten Sie die Verifizierung.

Nach Abschluss sendet Didit das Ergebnis per Webhook an Ihre Joomla-Website. Wenn die Prüfung erfolgreich ist, wird der Benutzer der festgelegten Benutzergruppe hinzugefügt.

Häufige Probleme

Der Benutzer wird nicht freigeschaltet

Prüfen Sie:

  • Ist das Plugin Didit Webhook aktiviert?
  • Ist die Webhook URL korrekt in Didit eingetragen?
  • Ist der Webhook Secret Key korrekt?
  • Ist eine Approved Usergroup ausgewählt?

Webhook kommt nicht an

Prüfen Sie:

  • Ist die Website öffentlich erreichbar?
  • Blockiert eine Firewall den Webhook?
  • Wenn Sie Cloudflare verwenden, prüfen Sie die Firewall-Regeln.

API Key funktioniert nicht

Prüfen Sie:

  • Wurde der API Key vollständig kopiert?
  • Gehört der API Key zur richtigen Didit Organisation?
  • Ist die Workflow ID korrekt?