Zum Inhalt

🔐 iOS App Check Debug Token extrahieren

Problem

Die iOS App zeigt diesen Fehler: 

[firebase_app_check/unknown] The operation couldn't be completed. 
The server responded with an error: 403 - App attestation failed.

Lösung: Debug Token in Firebase Console registrieren

Methode 1: Token aus Xcode Console extrahieren (empfohlen)

  1. Öffne das Projekt in Xcode: 

    cd /Users/michaelmodlmair/Development/easySale/core/apps/shop_system
open ios/Runner.xcworkspace

  2. Starte die App in Xcode:

  3. Wähle einen iOS Simulator (z.B. iPhone 15)

  4. Klicke auf ▶️ (Run) oder drücke ⌘+R

  5. Öffne die Debug Console:

  6. Drücke ⌘+Shift+C oder

  7. Gehe zu View → Debug Area → Activate Console

  8. Suche nach dem Debug Token:

  9. In der Console (unterer Bereich) nach folgenden Begriffen suchen:
    • Firebase App Check Debug Token
    • Debug Token
    • FIRAppCheck

Das Token sieht so aus: 

[Firebase/AppCheck][I-FAC001000] Firebase App Check Debug Token: 
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

  1. Kopiere das Token (die UUID nach dem Doppelpunkt)

Methode 2: Token über System Console

  1. Öffne die Console App (macOS):

  2. Spotlight (⌘+Leertaste) → "Console" eingeben

  3. Filtere nach dem Simulator:

  4. Links: Wähle deinen Simulator (z.B. "iPhone 15 - iOS 17.0")

  5. Suchfeld: Firebase App Check Debug Token

  6. Starte die App und beobachte die Logs

  7. Kopiere das Token aus den Logs

Methode 3: Token manuell generieren

Wenn das Token nicht in den Logs erscheint, kannst du es selbst generieren:

# Generiere eine UUID v4 als Debug Token
uuidgen | tr '[:upper:]' '[:lower:]'

Beispiel Output: 

a1b2c3d4-e5f6-4abc-89de-f0123456789a

⚠️ Wichtig: Verwende diese Methode nur als letzte Option. Das Token muss zur App-Installation passen.

Token in Firebase Console registrieren

  1. Öffne die Firebase Console: 

    https://console.firebase.google.com/project/ts-easy-sale-core/appcheck/apps

  2. Wähle die Shop iOS App:

  3. Suche nach "easySale Shop" oder Bundle ID: de.tech-schuppen.shop

  4. Manage Debug Tokens:

  5. Klicke auf die 3 Punkte (⋮) rechts neben der App

  6. Wähle "Manage debug tokens"

  7. Token hinzufügen:

  8. Klicke "Add debug token"
  9. Füge das kopierte Token ein
  10. Name: iOS Simulator - Michael MBP

  11. Klicke "Save"

  12. App neu starten:

  13. Stoppe die App (⌘+.)
  14. Starte sie neu (⌘+R)
  15. Der Fehler sollte verschwunden sein ✅

Überprüfung

Nach der Registrierung sollte in den Flutter-Logs erscheinen: 

flutter: [INFO] App Check token successfully obtained

Dann kannst du Bestellungen aufgeben! 🎉

Troubleshooting

Token erscheint nicht in Xcode-Logs

  1. Prüfe ob App Check aktiviert ist:

  2. In Xcode Console nach "Activating Firebase App Check" suchen

  3. Erhöhe Log-Level:

  4. In Xcode: Product → Scheme → Edit Scheme
  5. Tab: Run

  6. Unter Arguments: Environment Variable hinzufügen:

    • Name: FIRDebugEnabled
    • Value: 1

  7. Bereinige Build: 

    cd core/apps/shop_system
flutter clean
rm -rf ios/Pods ios/Podfile.lock
cd ios && pod install && cd ..

Token wird nicht akzeptiert

  • Stelle sicher, dass du das komplette Token kopiert hast (inkl. Bindestriche)
  • Das Token muss lowercase sein
  • Keine Leerzeichen vor/nach dem Token