安全性規則和 Firebase 驗證

Firebase Security Rules 能以支援多種複雜程度的格式，提供存取權控管和資料驗證。如要建構以使用者和角色為基礎的存取系統，以保護使用者資料的安全，請搭配使用 Firebase Authentication 和 Firebase Security Rules。

識別使用者

Authentication 會識別要求存取資料的使用者，並將該資訊做為變數提供，供您在規則中使用。auth 變數包含下列資訊：

• uid：指派給提出要求的使用者的不重複使用者 ID。
• token：由 Authentication 收集的值對應表。

auth.token 變數包含下列值：

如果您想新增自訂驗證屬性，auth.token 變數也會包含您指定的任何自訂宣稱。

如果要求存取權的使用者未登入，auth 變數會是 null。舉例來說，如果您想限制已驗證使用者的讀取權限，可以利用這項功能。auth != null不過，我們通常會建議進一步限制寫入存取權。

如要進一步瞭解 auth 變數，請參閱 Cloud Firestore、Realtime Database 和 Cloud Storage 的參考說明文件。

在規則中使用使用者資訊

實際上，在規則中使用經過驗證的資訊，可讓規則更強大且具彈性。您可以根據使用者身分控管資料存取權。

在規則中定義 auth 變數 (要求者的使用者資訊) 中的資訊，如何與要求資料相關聯的使用者資訊相符。

舉例來說，您的應用程式可能會想確保使用者只能讀取及寫入自己的資料。在這種情況下，您需要在要求的資料中，將 auth.uid 變數與使用者 ID 進行比對：

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;
  }
}

定義自訂使用者資訊

您可以進一步利用 auth 變數，定義指派給應用程式使用者的自訂欄位。

舉例來說，假設您想建立「管理員」角色，讓使用者在特定路徑上擁有寫入權限。您可以將該屬性指派給使用者，然後在授予路徑存取權的規則中加以利用。

在 Cloud Firestore 中，您可以將自訂欄位新增至使用者的文件，並透過規則中嵌入的讀取功能擷取該欄位的值。因此，以管理員為依據的規則會如下所示：

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;
  }
}

在 Authentication 中建立自訂宣告後，您就可以在 Rules 中存取自訂宣告。接著，您可以使用 auth.token 變數參照這些自訂宣告。

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;
  }
}

如要查看更多利用 Authentication 的基本 Rules 範例，請參閱「基本安全性規則」。