Service Account einrichten

Der Service Account ermöglicht die automatische Einrichtung aller Firebase-Dienste. Einmal eingerichtet, werden alle weiteren Module automatisch konfiguriert - ganz ohne manuelles Kopieren und Einfügen.

Warum ein Service Account?

Automatische Einrichtung

Firestore Rules, Storage Rules und Indexes werden automatisch bereitgestellt.

Einmalige Einrichtung

Nach der Einrichtung funktioniert alles automatisch für alle weiteren Module.

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 existieren
Du hast Zugang zur Google Cloud Console
Du verwendest dasselbe Google-Konto wie für Firebase

Den Assistenten starten

Öffne den Edit Mode in deiner App
Gehe zu Module & Features
Tippe auf ein beliebiges Modul (z.B. Feed oder Profil)
Wähle Einrichten
Wähle Automatisch als Setup-Modus
Wenn noch kein Service Account vorhanden ist, tippe auf Jetzt verbinden

Der Assistent öffnet sich im Vollbildmodus mit der Google Cloud Console.

Schritt-für-Schritt-Anleitung

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

Was passiert: Du siehst die Dienstkonten-Übersicht.

Was du tun musst:

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

Was passiert: Du bist in der Dienstkonten-Übersicht deines Projekts.

Was du tun musst:

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

Schritt 4: Name eingeben

Was passiert: Das Formular zur Dienstkonto-Erstellung erscheint.

Was du tun musst:

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

Was passiert: Der Abschnitt “Diesem Dienstkonto Zugriff auf Projekt gewähren” erscheint.

Was du tun musst:

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

Was passiert: Das Dienstkonto wurde erstellt und du bist zurück in der Übersicht.

Was du tun musst:

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

Was passiert: Die Detailansicht des Dienstkontos öffnet sich.

Was du tun musst:

Klicke oben auf den Tab “SCHLÜSSEL”
Klicke auf “SCHLÜSSEL HINZUFÜGEN”
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

Was passiert: Der Assistent zeigt jetzt die Upload-Seite.

Was du tun musst:

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!

Geschafft! Der Service Account ist jetzt eingerichtet. Ab sofort werden alle Module automatisch konfiguriert:

✅ Firestore Security Rules werden automatisch bereitgestellt
✅ Storage Security Rules werden automatisch bereitgestellt
✅ Firestore Indexes werden automatisch erstellt
✅ Kein manuelles Kopieren und Einfügen mehr nötig

Automatische Einrichtung nutzen

Nach der Service Account-Einrichtung kannst du bei jedem Modul “Automatisch” wählen:

Öffne ein beliebiges Modul (z.B. Feed, Profil, Wiki)
Tippe auf “Einrichten”
Wähle “Automatisch”
Die Einrichtung erfolgt in wenigen Sekunden!

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

Firestore einrichten Mit dem Service Account geht das jetzt automatisch!

Zurück zur Übersicht Firebase-Setup Übersicht