Node.js

Einrichten Ihrer Vonage-Anmeldeinformationen

Für dieses Tutorial benötigen Sie eine Vonage-Konto und eine Vonage Application. Wenn Sie noch keinen Account bei Vonage haben, können Sie sich anmelden und mit einem kostenlosen Guthaben starten.

Erstellen einer Vonage-Applikation

Eine Vonage Application stellt Ihren Backend-Service dar und enthält die für den Aufruf der Verify API erforderlichen Anmeldeinformationen.

Befolgen Sie diese Schritte in der Vonage Dashboard:

  1. Öffnen Sie das Vonage Dashboard und wählen Sie Applications aus dem Menü auf der linken Seite.
  2. Klicken Sie auf Erstellen Sie eine neue Anwendung.
  3. Geben Sie einen Namen für Ihre Anwendung ein (z. B.: verify-tutorial).
  4. Klicken Sie auf Öffentlichen und privaten Schlüssel generieren.
    • Eine private Schlüsseldatei wird automatisch heruntergeladen.
    • Speichern Sie diese Datei sicher. Sie ist für die Generierung von JWTs erforderlich und muss im Backend verbleiben.
  5. Blättern Sie zum Abschnitt Fähigkeiten und aktivieren Sie Netzwerkregistrierung.
    • Wählen Sie die Spielplatzumgebung aus.
    • Lassen Sie den Rest der Konfiguration der Netzwerkregistrierung vorerst leer. Wir werden später im Lehrgang darauf zurückkommen.
  6. Klicken Sie auf Neue Anwendung generieren zu beenden.
  7. Kopieren Sie nach der Erstellung die im Dashboard angezeigte Application ID.

Wichtige Sicherheitsregel

  • Der private Schlüssel darf niemals in einer mobilen Anwendung enthalten sein.
  • Nur das Backend verwendet sie zur Authentifizierung bei Vonage.

Umgebungsvariablen konfigurieren

Jetzt speichern wir die Vonage-Anmeldeinformationen in der Datei .env Datei, die vom Backend verwendet wird.

Öffnen Sie die .env Datei, die Sie zuvor erstellt haben, und fügen Sie hinzu:

Anmerkung: Die Verwendung eines relativen Pfades (./private.key) hält das Projekt portabel und vermeidet maschinenspezifische Pfade.

Erläuterung:

  • VONAGE_APPLICATION_ID: die Application ID aus dem Vonage Dashboard.
  • VONAGE_PRIVATE_KEY_PATH: Pfad zur Datei des privaten Schlüssels, der zum Signieren von JWTs verwendet wird.

Legen Sie die heruntergeladene private Schlüsseldatei in Ihrem Backend-Ordner ab und nennen Sie sie private.key. Fügen Sie sie dann der .gitignore Datei:

echo "private.key" >> .gitignore

Aktualisierte Ordnerstruktur

Nach diesem Schritt wird Ihr Backend-Ordner wie folgt aussehen: