安全性規則和 Firebase 驗證

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

識別使用者

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

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

auth.token 變數包含下列值：

欄位	說明
email	與帳戶相關聯的電子郵件地址 (如果有)。
email_verified	true：如果使用者已驗證自己有權存取 email 地址。部分供應商會自動驗證他們擁有的電子郵件地址。
phone_number	與帳戶相關聯的電話號碼 (如果有的話)。
name	使用者的顯示名稱 (如有)。
sub	使用者的 Firebase UID。在專案中不得重複。
firebase.identities	與此使用者帳戶相關聯的所有身分的字典。字典的鍵可以是下列任一值：email、phone、google.com、facebook.com、github.com、twitter.com。字典的值是與帳戶相關聯的每個 ID 提供者的專屬 ID 陣列。例如，auth.token.firebase.identities["google.com"][0] 包含與帳戶相關聯的第一個 Google 使用者 ID。
firebase.sign_in_provider	用於取得這個權杖的登入提供者。可以是下列任一字串：custom、password、phone、anonymous、google.com、facebook.com、github.com、twitter.com。
firebase.tenant	與帳戶相關聯的 tenantId (如有)，例如 tenant2-m6tyz

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

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

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

在規則中使用使用者資訊

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

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

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

Cloud Firestore

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

Realtime Database

{
  "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"
      }
    }
  }
}

Cloud Storage

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

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 變數參照這些自訂宣告。

Cloud Firestore

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

Realtime Database

{
  "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"
      }
    }
  }

Cloud Storage

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 範例，請參閱「基本安全性規則」。