Service Account einrichten

Der Service Account ermöglicht die automatische Einrichtung aller Firebase-Dienste beim Veröffentlichen deiner App. Einmal eingerichtet, werden Firestore Rules, Storage Rules, Indexes, Auth-Methoden und der Admin-Account automatisch konfiguriert.

Warum ein Service Account?

Automatische Einrichtung

Firestore Rules, Storage Rules, Indexes, Auth-Methoden und Admin-Account werden automatisch bereitgestellt.

Einmalige Einrichtung

Nach der Einrichtung funktioniert alles automatisch - auch bei zukünftigen Updates.

Sicher

Die Zugangsdaten werden nur auf deinem Gerät gespeichert und niemals ins Internet hochgeladen.

Zeitsparend

Keine manuelle Navigation in der Firebase Console mehr nötig.

Voraussetzungen

Ein Firebase-Projekt muss bereits erstellt sein (Firebase-Projekt erstellen)
Du hast Zugang zur Google Cloud Console
Du verwendest dasselbe Google-Konto wie für Firebase

Schritt-für-Schritt-Anleitung

Der Publish-Assistent öffnet die Google Cloud Console direkt in der App und führt dich durch jeden Schritt.

Schritt 1: Google Cloud öffnen

Was passiert: Die Google Cloud Console wird automatisch geöffnet.

Was du tun musst:

Melde dich mit deinem Google-Konto an, das Zugriff auf dein Firebase-Projekt hat
Die Seite “IAM & Verwaltung > Dienstkonten” sollte sich automatisch öffnen

Falls die Seite nicht automatisch öffnet:

Klicke links auf “IAM & Verwaltung”
Dann auf “Dienstkonten”

Schritt 2: Projekt auswählen

Prüfe oben in der Kopfzeile, ob das richtige Projekt ausgewählt ist
Wenn nicht, klicke auf den Projektnamen und wähle dein Firebase-Projekt aus der Liste

Schritt 3: Dienstkonto erstellen

Klicke oben auf ”+ DIENSTKONTO ERSTELLEN”
Ein Formular wird angezeigt

Schritt 4: Name eingeben

Feld	Wert
Dienstkontoname	`blocq-automation`
Dienstkonto-ID	wird automatisch ausgefüllt
Beschreibung	`Automatische Einrichtung für BLOCQ`

Gib den Dienstkontonamen ein: blocq-automation
Die Dienstkonto-ID wird automatisch generiert
Gib optional eine Beschreibung ein
Klicke auf “ERSTELLEN UND FORTFAHREN”

Schritt 5: Berechtigungen vergeben

Füge die folgenden 6 Rollen hinzu. Klicke jeweils auf “Weitere Rolle hinzufügen”, um eine neue Rolle hinzuzufügen:

Nr.	Rolle	Zweck
1	Firebase Admin	für die Verwaltung
2	Cloud Datastore User	für Datenbankzugriff
3	Storage Admin	für Dateispeicher
4	Cloud Functions Admin	für Cloud Functions
5	Cloud Build Editor	für den Build-Prozess
6	Service Account User	für Function-Ausführung

Klicke auf “Rolle auswählen”
Suche nach der Rolle (z.B. “Firebase Admin”)
Wähle die Rolle aus
Klicke auf ”+ Weitere Rolle hinzufügen”
Wiederhole für alle 6 Rollen
Klicke auf “FORTFAHREN”
Klicke auf “FERTIG”

Schritt 6: Dienstkonto öffnen

Finde das gerade erstellte Dienstkonto “blocq-automation” in der Liste
Klicke auf die E-Mail-Adresse des Dienstkontos, um die Details zu öffnen

Die E-Mail-Adresse hat das Format: blocq-automation@dein-projekt.iam.gserviceaccount.com

Schritt 7: Schlüssel erstellen

Klicke oben auf den Tab “SCHLUESSEL”
Klicke auf “SCHLUESSEL HINZUFUEGEN”
Wähle “Neuen Schlüssel erstellen”
Wähle “JSON” als Schlüsseltyp
Klicke auf “ERSTELLEN”

Eine JSON-Datei wird automatisch heruntergeladen!

Schritt 8: Datei hochladen

Tippe auf “Datei auswählen”
Navigiere zum Speicherort der heruntergeladenen JSON-Datei
Wähle die Datei aus
Warte, bis die Validierung abgeschlossen ist
Bei Erfolg siehst du: “Verbindung erfolgreich hergestellt!”

Fertig!

Der Service Account ist jetzt eingerichtet. Beim Veröffentlichen werden automatisch folgende Schritte durchgeführt:

Firestore Security Rules werden bereitgestellt
Storage Security Rules werden bereitgestellt
Firestore Indexes werden erstellt
Auth-Methoden werden aktiviert
Admin-Account wird erstellt
Inhalte werden migriert

Alle diese Schritte übernimmt der Auto-Setup-Runner für dich.

Fehlerbehebung

”Berechtigung verweigert”

Problem: Die automatische Einrichtung schlägt fehl mit Berechtigungsfehler.

Lösungen:

Prüfe, ob alle 6 Rollen korrekt zugewiesen wurden
Stelle sicher, dass das richtige Projekt ausgewählt ist
Warte einige Minuten - Berechtigungen können bis zu 5 Minuten dauern

”Ungültige Datei”

Problem: Die hochgeladene Datei wird nicht erkannt.

Lösungen:

Stelle sicher, dass du die JSON-Datei ausgewählt hast (nicht XML oder andere Formate)
Prüfe, dass die Datei vollständig heruntergeladen wurde
Erstelle ggf. einen neuen Schlüssel

”Projekt nicht gefunden”

Problem: Das Firebase-Projekt wird nicht gefunden.

Lösungen:

Prüfe, ob das Google Cloud-Projekt mit dem Firebase-Projekt verknüpft ist
Beide müssen den gleichen Projektnamen haben
Melde dich mit dem korrekten Google-Konto an

Tipps

Nächste Schritte

Automatisches Firebase-Setup Erfahre, was der Auto-Setup-Runner beim Veröffentlichen alles einrichtet

Zurück zur Übersicht Firebase-Modul Übersicht