Sicherheitsregeln und Firebase Authentication

Firebase Security Rules bieten Zugriffssteuerung und Datenvalidierung in einem Format, das mehrere Komplexitätsebenen unterstützt. Verwenden Sie Firebase Authentication mit Firebase Security Rules, um nutzer- und rollenbasierte Zugriffssysteme zum Schutz der Nutzerdaten zu erstellen.

Nutzer identifizieren

Authentication identifiziert Nutzer, die Zugriff auf Ihre Daten anfordern, und stellt diese Informationen als Variable bereit, die Sie in Ihren Regeln verwenden können. Die Variable auth enthält die folgenden Informationen:

• uid:Eine eindeutige Nutzer-ID, die dem anfragenden Nutzer zugewiesen ist.
• token:Eine Zuordnungstabelle mit Werten, die von Authentication erfasst wurden.

Die Variable auth.token enthält die folgenden Werte:

Wenn Sie benutzerdefinierte Authentifizierungsattribute hinzufügen möchten, enthält die Variable auth.token auch alle von Ihnen angegebenen benutzerdefinierten Ansprüche.

Wenn der Nutzer, der den Zugriff anfordert, nicht angemeldet ist, hat die Variable auth den Wert null. Sie können diese Funktion in Ihren Regeln nutzen, wenn Sie beispielsweise den Lesezugriff auf authentifizierte Nutzer beschränken möchten – auth != null. Wir empfehlen jedoch generell, den Schreibzugriff weiter einzuschränken.

Weitere Informationen zur Variablen auth finden Sie in der Referenzdokumentation für Cloud Firestore, Realtime Database und Cloud Storage.

Nutzerinformationen in Regeln nutzen

In der Praxis machen authentifizierte Informationen in Ihren Regeln diese leistungsfähiger und flexibler. Sie können den Zugriff auf Daten basierend auf der Nutzeridentität steuern.

Definieren Sie in den Regeln, wie die Informationen in der Variablen auth – die Nutzerinformationen des Senders – mit den Nutzerinformationen übereinstimmen, die mit den angeforderten Daten verknüpft sind.

Angenommen, Ihre Anwendung möchte sicherstellen, dass Nutzer nur ihre eigenen Daten lesen und schreiben können. In diesem Szenario sollte eine Übereinstimmung zwischen der Variablen auth.uid und der Nutzer-ID in den angeforderten Daten bestehen:

service cloud.firestore {
  match /databases/{database}/documents {
    // Make sure the uid of the requesting user matches name of the user
    // document. The wildcard expression {userId} makes the userId variable
    // available in rules.
    match /users/{userId} {
      allow read, write: if request.auth != null && request.auth.uid == userId;
    }
  }
}

{
  "rules": {
    "users": {
      "$userId": {
        // grants write access to the owner of this user account
        // whose uid must exactly match the key ($userId)
        ".write": "$userId === auth.uid"
      }
    }
  }
}

service firebase.storage {
  // Only a user can upload their file, but anyone can view it
  match /users/{userId}/{fileName} {
    allow read;
    allow write: if request.auth != null && request.auth.uid == userId;
  }
}

Benutzerdefinierte Nutzerinformationen definieren

Außerdem können Sie mit der Variablen auth benutzerdefinierte Felder definieren, die den Nutzern Ihrer App zugewiesen sind.

Angenommen, Sie möchten eine Administratorrolle erstellen, die den Schreibzugriff auf bestimmten Pfaden ermöglicht. Sie weisen dieses Attribut Nutzern zu und verwenden es dann in den Regeln, die Zugriff auf die Pfade gewähren.

In Cloud Firestore können Sie den Dokumenten von Nutzern ein benutzerdefiniertes Feld hinzufügen und den Wert dieses Felds mit einem in Ihre Regeln eingebetteten Lesevorgang abrufen. Ihre verwaltete Regel würde also so aussehen:

service cloud.firestore {
  match /databases/{database}/documents/some_collection: {
    // Remember that, in Cloud Firestore, reads embedded in your rules are billed operations
    write: if request.auth != null && get(/databases/(database)/documents/users/$(request.auth.uid)).data.admin == true;
    read: if request.auth != null;
  }
}

Sie können auf benutzerdefinierte Ansprüche in Rules zugreifen, nachdem Sie sie in Authentication erstellt haben. Sie können dann über die Variable auth.token auf diese benutzerdefinierten Ansprüche verweisen.

service cloud.firestore {
  match /databases/{database}/documents {
    // For attribute-based access control, check for an admin claim
    allow write: if request.auth.token.admin == true;
    allow read: true;

    // Alterntatively, for role-based access, assign specific roles to users
    match /some_collection/{document} {
     allow read: if request.auth.token.reader == "true";
     allow write: if request.auth.token.writer == "true";
   }
  }
}

{
  "rules": {
    "some_path/$sub_path": {
      // Create a custom claim for the admin role
      ".write": "auth.uid !== null && auth.token.writer === true"
      ".read": "auth.uid !== null"
      }
    }
  }

service firebase.storage {
  // Create a custom claim for the admin role
  match /files/{fileName} {
    allow read: if request.auth.uid != null;
    allow write: if request.auth.token.admin == true;
  }
}

Weitere Beispiele für einfache Rules unter Verwendung von Authentication finden Sie unter Grundlegende Sicherheitsregeln.