
Telefonnummern mit Firebase und Vonage Identity Insights validieren
Lesedauer: 5 Minuten
Einführung
Dieses Tutorial zeigt, wie man eine serverlose Demosolution mithilfe von Firebase Callable Functions und der Vonage Identity Insights API, die automatisch versucht, Benutzereingaben zu bereinigen. Sie müssen sich keine Sorgen machen, wenn Ihre Nutzer Nummern eingeben, die Bindestriche, Leerzeichen oder alphanumerische Zeichen enthalten. Die API wird ihr Bestes tun, um die Telefonnummer zu analysieren und zu validieren.
Die Validierung von Telefonnummern sowie deren Bereinigung und korrekte Formatierung sind unerlässlich. In der Demonstration, die wir erstellen werden, können Sie eine Telefonnummer eingeben und die Vonage Identity Insights API nutzen, um die Formatgültigkeit, das internationale Format, die Ländervorwahl, den aktuellen und ursprünglichen Namen des Netzbetreibers sowie den Netztyp abzufragen.
Phone Number Validation
Voraussetzungen
Stellen Sie sicher, dass Sie das haben:
Ein Google-Account mit Firebase mit aktivierter Blaze-Abrechnung (erforderlich für Node.js -Funktionen erforderlich).
Die Firebase-CLI ist installiert:
npm install -g firebase-toolsEin Vonage-Account.
Öffnen Sie Ihre API-Einstellungen-Seite um auf Ihren Vonage API-Schlüssel und Ihr API-Geheimnis zuzugreifen, die beide wie im Screenshot unten dargestellt angezeigt werden. Der API-Schlüssel befindet sich oben auf der Seite, und um auf Ihr API-Geheimnis zuzugreifen, lesen Sie bitte den Unterabschnitt "Account secret".
Hinweis: Falls Sie sich nicht an Ihr zuvor erstelltes API-Geheimnis erinnern können, klicken Sie auf "+ Neues Geheimnis erstellen" und speichern Sie es sicher.

Dateistruktur
Der Beispielcode für dieses Projekt entspricht der folgenden Struktur.
my-firebase-project/
├── firebase.json
├── functions/
│ ├── index.js
│ └── package.json
└── public/
└── index.htmlVerbinden wir dieses Projektverzeichnis mit einem Firebase-Projekt. Du kannst mehrere Projekt-Aliase erstellen, indem du folgenden Befehl ausführst: firebase use --add.
Firebase-Funktion initialisieren
Initialisieren Sie Firebase Functions in Ihrem Projektverzeichnis:
firebase init functionsAuswählen JavaScript , wenn Sie dazu aufgefordert werden. Es besteht auch die Möglichkeit, TypeScript und Python auszuwählen. Navigieren Sie anschließend in Ihren Funktionsordner und installieren Sie das Vonage Server SDK:
cd functions
npm install @vonage/server-sdkUm eine Anwendung zu erstellen, gehen Sie auf die Seite Erstellen einer Anwendung auf dem Vonage Dashboard und legen Sie einen Namen für Ihre Anwendung fest.
Wenn Sie eine API verwenden möchten, die Webhooks nutzt, benötigen Sie einen privaten Schlüssel. Klicken Sie auf "Generate public and private key", der Download sollte automatisch starten. Bewahren Sie ihn sicher auf; dieser Schlüssel kann bei Verlust nicht erneut heruntergeladen werden. Er folgt der Namenskonvention privat_<Ihre App-ID>.key. Dieser Schlüssel kann nun zur Authentifizierung von API-Aufrufen verwendet werden. Hinweis: Ihr Schlüssel funktioniert erst, wenn Ihre Anwendung gespeichert ist.
Wählen Sie die benötigten Funktionen (z. B. Voice, Nachrichten, RTC usw.) und stellen Sie die erforderlichen Webhooks bereit (z. B. Ereignis-URLs, Antwort-URLs oder URLs für eingehende Nachrichten). Diese werden im Lernprogramm beschrieben.
Zum Speichern und Bereitstellen klicken Sie auf "Neue Anwendung generieren", um die Einrichtung abzuschließen. Ihre Anwendung ist nun bereit für die Verwendung mit Vonage-APIs.
Die Vonage Identity Insights API verwendet JWTs, daher müssen wir unsere Anwendungs-ID und unseren privaten Schlüssel sicher speichern. Wir nutzen den in Firebase integrierten Secret Manager, damit diese Werte niemals in unserem Quellcode enthalten sind:
firebase functions:secrets:set VONAGE_APPLICATION_ID
Anschließend werden Sie aufgefordert, die Vonage-Anwendungs-ID hinzuzufügen.
firebase functions:secrets:set VONAGE_PRIVATE_KEYAnschließend werden Sie aufgefordert, den mit Ihrer Anwendungs-ID verknüpften Vonage-Privatschlüssel hinzuzufügen.
Die Backend-Logik verstehen
Wir werden die Vonage Identity Insights APIverwenden. Firebase Callable Functions kümmern sich automatisch um CORS und die Authentifizierung, sodass Ihr Frontend sie aufrufen kann. Sie können die Schritte anhand der vollständigen „index.js“-Datei im Beispiel-Repository mitverfolgen.
Wir initialisieren den Vonage-Client. Für Identity Insights ist eine JWT-Authentifizierung erforderlich. Wir initialisieren den Client mit den zuvor gespeicherten Geheimnissen.
const vonage = new Vonage({
applicationId: process.env.VONAGE_APPLICATION_ID,
privateKey: process.env.VONAGE_PRIVATE_KEY.replace(/\n/g, '
')
});
exports.validatePhone = onCall(async (request) => {
const phoneNumber = request.data.phone;Hinweis: Das
.replace(/\n/g, '\n')ist eine Korrektur zur Behebung von Formatierungsproblemen bei Zeilenumbrüchen bei der Verwendung des Firebase Secret Managers.
Wir bitten sowohl die format sowie current_carrier Identity Insights API-Informationen an, um nicht nur zu erfahren, ob die Telefonnummer technisch gültig ist, sondern auch, ob es sich um einen Mobilfunkanschluss handelt, an den wir tatsächlich eine SMS senden können.
if (!phoneNumber) {
throw new HttpsError('invalid-argument', 'Phone number is required.');
}
try {
// Call the Vonage Identity Insights API
// We request both the 'format' and 'current_carrier' datasets
const response = await vonage.identityInsights.getInsights({
phone_number: phoneNumber,
insights: {
format: {},
current_carrier: {}
}
});
const formatData = response.format || {};
const carrierData = response.current_carrier || {};Wir bündeln alles und senden ein Antwortobjekt an unser Frontend zurück, sodass dieses die rohen API-Antworten nicht selbst auswerten muss.
return {
valid: formatData.is_format_valid === true,
country: formatData.country_code || 'Unknown',
formattedNumber: formatData.number_international || phoneNumber,
carrier: carrierData.name || 'Unknown',
networkType: carrierData.network_type || 'Unknown'
};
} catch (error) {
console.error('Validation error:', error);
throw new HttpsError('internal', 'Failed to validate phone number.');
}
});
Stellen Sie Ihre Funktion in der Cloud bereit
Führen Sie den folgenden Befehl in Ihrem Terminal im Stammverzeichnis Ihres Projekts aus, um Ihre Funktion in Firebase bereitzustellen:
firebase deploy --only functionsWährend des Bereitstellungsprozesses bündelt die Firebase-CLI den Quellcode Ihrer Funktion, lädt ihn in Cloud Functions hoch und richtet die erforderlichen Cloud Secret Manager-Berechtigungen für Ihre konfigurierten Geheimnisse ein. In Ihrem Terminal werden Fortschrittsprotokolle angezeigt, die jeden Schritt detailliert beschreiben. Am Ende erscheint eine Erfolgsmeldung sowie der URL-Endpunkt für Ihre bereitgestellte Funktion.
Um zu überprüfen, ob die Bereitstellung erfolgreich war, öffnen Sie die Firebase-Konsole, wählen Sie Ihr Projekt aus und navigieren Sie zum Abschnitt „Functions“. Dort sollten validatePhone unter dem Dashboard zusammen mit dem Status, der Laufzeit und dem Auslösertyp aufgeführt sehen.
Frontend verbinden
Da wir eine aufrufbare Funktion verwendet haben, lässt sich diese ganz einfach aus Ihrer Web-App heraus aufrufen. Sie müssen sich nicht mit Fetch-Anfragen, HTTP-Headern oder dem Parsen von JSON herumschlagen.
Erstellen Sie eine index.html-Datei und fügen Sie den Code ein. Denken Sie dabei daran, die Angaben für Ihr Firebase-Projektkonfigurationeinzufügen.
// TODO: Replace with your Firebase project configuration
const firebaseConfig = {
projectId: "YOUR_PROJECT_ID",
apiKey: "YOUR_WEB_API_KEY"
};
Testen Sie es aus
Öffnen Sie die HTML-Datei in Ihrem Browser, geben Sie eine Telefonnummer einschließlich der Ländervorwahl in das Eingabefeld ein und klicken Sie auf „Nummer überprüfen“. Sie erhalten Informationen zu der Telefonnummer, genau wie in der Abbildung am Anfang dieses Tutorials gezeigt.
Schlussfolgerung
Die Number Insight API hilft Ihrer Anwendung dabei, ausschließlich echte, erreichbar Telefonnummern zu akzeptieren und gleichzeitig wertvolle Informationen zu Netzbetreibern zu sammeln. Um mehr darüber zu erfahren, welche Daten Sie aus Telefonnummern gewinnen können, lesen Sie die Dokumentation zur Vonage Identity Insights-API.
Möchtest du etwas lernen, in Kontakt bleiben oder zeigen, woran du gerade arbeitest?
Lerne weiter
Entdecken Sie Anwendungsfälle und strukturierte Lernpfade im Vonage Learning Center
Sehen Sie sich Tutorials auf unserem Vonage Developer YouTube-Kanal
Bleiben Sie auf dem Laufenden
Abonnieren Sie den Vonage-Entwickler-Newsletter
Folgen Sie uns auf X für aktuelle Informationen
Folgen Sie uns auf LinkedIn
Helfen Sie uns, unsere Entwicklererfahrung zu verbessern, indem Sie unser Feedback-Formular „Voice of the Developer“ aus.