Tutorials

Wie du die Mobile App Authentifizierung mit Cloudflare einrichtest [2025 Easy Guide]

Melden

Hier ist ein aktueller Schritt-für-Schritt-Leitfaden, wie du im Jahr 2025 die Authentifizierung für deine mobile App über Cloudflare (Zero Trust) einrichtest.

Die Absicherung eines mobilen Backends kann komplex sein. Cloudflare Zero Trust (ehemals Cloudflare Access) ermöglicht es dir, eine sichere Authentifizierungsebene vor deine API oder App zu schalten, ohne dass du ein eigenes Login-System programmieren musst.

Voraussetzungen

  • Ein Cloudflare-Konto.
  • Eine registrierte Domain auf Cloudflare.
  • Eine mobile App (iOS/Android) oder ein Backend-API-Endpunkt.

Schritt 1: Cloudflare Zero Trust aktivieren

Zuerst musst du die Zero Trust-Umgebung in deinem Cloudflare-Konto aktivieren.

  1. Logge dich im Cloudflare Dashboard ein.
  2. Klicke in der linken Seitenleiste auf Zero Trust.
  3. Wähle einen Team-Namen (z. B. deine-app-auth).
  4. Wähle den kostenlosen Plan (Free Plan reicht für bis zu 50 Nutzer meist völlig aus).

Schritt 2: Identity Provider (IDP) hinzufügen

Hier legst du fest, wie sich deine Nutzer anmelden sollen (z. B. Google, GitHub, Apple oder per E-Mail OTP).

  1. Gehe im Zero Trust Dashboard auf Settings > Authentication.
  2. Klicke unter "Identity Providers" auf Add new.
  3. Wähle einen Anbieter aus (z. B. Google oder One-Time Pin (OTP)).
  4. Folge den Anweisungen, um die API-Keys des Anbieters zu hinterlegen.
    • Tipp: Für mobile Apps ist Apple oder Google ideal für die User Experience.

Schritt 3: Die Applikation in Cloudflare Access erstellen

Jetzt definierst du, welcher Endpunkt (deine API) geschützt werden soll.

  1. Navigiere zu Access > Applications.
  2. Klicke auf Add an application und wähle Self-hosted.
  3. Application Name: Gib einen Namen ein (z. B. Mobile App API).
  4. Domain: Gib die Subdomain ein, unter der dein Backend erreichbar ist (z. B. api.deine-domain.de).
  5. Klicke auf Next.

Schritt 4: Policies (Zugriffsregeln) festlegen

Bestimme, wer Zugriff auf die App hat.

  1. Policy Name: z. B. Zulässige Nutzer.
  2. Action: Allow.
  3. Assign a group / Include: Wähle "Emails" oder "Emails ending in" (z. B. nur Nutzer mit @gmail.com).
  4. Klicke auf Next und dann auf Add application.

Schritt 5: Integration in die mobile App (JWT Validierung)

Dies ist der technische Teil. Wenn deine mobile App die API aufruft, leitet Cloudflare den Nutzer zur Anmeldung weiter. Nach dem Login erhält die App ein JWT (JSON Web Token).

A. Der Webview-Ansatz (Einfach)

Für die meisten Apps nutzt du einen ASWebAuthenticationSession (iOS) oder Custom Tabs (Android), um den Nutzer auf die Cloudflare-Login-Seite deiner Subdomain zu leiten.

B. Header-Validierung im Backend

Dein Backend muss sicherstellen, dass Anfragen von Cloudflare kommen. Cloudflare sendet nach erfolgreichem Login einen Header namens Cf-Access-Jwt-Assertion.

So verifizierst du den Token in deinem Backend (Beispiel Node.js):

const jwt = require('jsonwebtoken');

function verifyCloudflareToken(req, res, next) {
    const token = req.headers['cf-access-jwt-assertion'];

    if (!token) {
        return res.status(401).send('Kein Token vorhanden');
    }

    // Cloudflare Public Key URL: https://<dein-team-name>.cloudflareaccess.com/cdn-cgi/access/certs
    // Hier validierst du die Signatur des Tokens
    // ... Validierungslogik ...

    next();
}

Schritt 6: Service Tokens für automatisierte Prozesse (Optional)

Wenn deine App automatisierte Hintergrundprozesse hat, die kein menschliches Login erfordern, nutze Service Tokens.

  1. Gehe zu Access > Service Tokens.
  2. Erstelle einen Token und speichere die Client ID und das Client Secret.
  3. Sende diese in deiner App in den Headern CF-Access-Client-Id und CF-Access-Client-Secret mit.

Zusammenfassung der Vorteile 2025

  • Keine eigene Datenbank für Passwörter: Du musst keine sensiblen Daten speichern.
  • Bot-Schutz: Cloudflare blockiert bösartige Bots, bevor sie dein Backend erreichen.
  • Multi-Faktor-Authentifizierung (MFA): Kann einfach über das Dashboard erzwungen werden.
  • Edge Performance: Die Authentifizierung findet im Cloudflare-Netzwerk statt, direkt in der Nähe deiner Nutzer.

Pro-Tipp: Nutze das Cloudflare WARP SDK, wenn du eine extrem tiefe Integration und noch höhere Sicherheit (Device Posture) für Unternehmens-Apps benötigst. Für normale Consumer-Apps ist der oben beschriebene Weg über Access + JWT der Standardweg.

0