Câu lệnh AI: Viết các quy tắc bảo mật của Firebase

Câu lệnh này có thể giúp trợ lý AI (như Google Antigravity) tạo và tinh chỉnh Firebase Security Rules cho ứng dụng của bạn. Bạn có thể sử dụng câu lệnh này để soạn thảo Security Rules cho các trường hợp sử dụng phổ biến, chẳng hạn như cấp quyền truy cập dành riêng cho người dùng, triển khai quyền dựa trên vai trò và xác thực dữ liệu.

Câu lệnh này tập trung vào việc tạo Security Rules cho:

  • Cloud Firestore: Bảo mật các bộ sưu tập và tài liệu dựa trên logic của ứng dụng.
  • Cloud Storage for Firebase: Xác thực quyền truy cập cho các tệp đã lưu trữ.

Việc sử dụng câu lệnh này có thể giúp bạn bắt đầu với một tư thế bảo mật mạnh mẽ, nhưng bạn nên luôn kiểm thử kỹ lưỡng Security Rules trước khi triển khai vào môi trường thực tế. Để biết thêm thông tin về việc kiểm thử Security Rules, hãy xem Bắt đầu sử dụng Firebase Security Rules: Kiểm thử Security Rules.

Điều kiện tiên quyết

Hạn chế

Chúng tôi đang tích cực cải thiện trải nghiệm này, vì vậy, danh sách các hạn chế này có thể thay đổi. Hãy thường xuyên kiểm tra để biết thông tin cập nhật.

  • Câu lệnh này được thiết kế để tạo Firebase Security Rules cho Cloud Firestore và Cloud Storage for Firebase. Câu lệnh này chưa thể tạo Security Rules cho Firebase Realtime Database.

  • Firebase Security Rules không được gọi khi truy cập vào cơ sở dữ liệu hoặc vùng chứa của bạn từ một máy chủ hoặc môi trường phụ trợ khác, chẳng hạn như khi sử dụng Firebase Admin SDK. Nếu đang sử dụng Admin SDK, bạn có trách nhiệm quản lý quá trình uỷ quyền và xác thực dữ liệu trong mã phụ trợ.

  • Gemini trong Firebase trong bảng điều khiển Firebase không thể tạo Firebase Security Rules, ngay cả khi sử dụng câu lệnh này. Thay vào đó, hãy sử dụng một trợ lý AI thay thế có quyền truy cập vào toàn bộ mã nguồn của bạn, chẳng hạn như Antigravity (được mô tả trên trang này).

Sử dụng câu lệnh

Bạn có thể sử dụng khả năng này khi sử dụng máy chủ Firebase MCP và các kỹ năng của tác nhân Firebase với một trợ lý AI tương thích (chẳng hạn như Antigravity) để tạo các bài kiểm thử và Security Rules. Các công cụ này phân tích mã nguồn của bạn để giúp xác định các lược đồ dữ liệu và mẫu truy cập cho Cloud Firestore và Cloud Storage. Các công cụ này được thiết kế để soạn thảo Security Rules dựa trên nguyên tắc về đặc quyền tối thiểu và cố gắng phát hiện các lỗ hổng thông qua các mô phỏng "tấn công" lặp đi lặp lại. Để hỗ trợ quá trình xác minh cuối cùng, các công cụ này cung cấp một bộ kiểm thử đơn vị bắt đầu bằng cách sử dụng @firebase/rules-unit-testing, cho phép bạn xác minh logic bảo mật của mình ở cấp cục bộ bằng Firebase Local Emulator Suite.

Để sử dụng các công cụ này, bạn cần thực hiện 3 bước được mô tả trong phần này:

  1. Tạo các bài kiểm thử và Security Rules của bạn.

  2. Xem lại kết quả kiểm thử và xác thực Security Rules.

  3. Triển khai Security Rules vào dự án Firebase.

Bước 1: Tạo Security Rules và các bài kiểm thử

Thiết lập và chạy các công cụ:

  1. Bật các kỹ năng của tác nhân Firebase:

  2. Khởi động trợ lý AI (ví dụ: chạy agy trong thiết bị đầu cuối cho CLI hoặc mở ứng dụng dành cho máy tính).

  3. Từ thư mục gốc của dự án, hãy yêu cầu tác nhân tạo Security Rules cho Cloud Firestore hoặc Cloud Storage dựa trên cách tác nhân lập trình AI tương tác với các câu lệnh MCP:

    • Đối với các tác nhân lập trình sử dụng ngôn ngữ tự nhiên (như Antigravity), hãy nhắc tác nhân bằng ngôn ngữ tự nhiên.

      • Tạo Security Rules cho Cloud Firestore:

        Generate Firestore security rules for this project, then run the unit tests.

        Trong thư mục mẹ, tác nhân sẽ tạo một tệp firestore.rules và một thư mục security_rules_test_firestore mới chứa một dự án Node.js có các bài kiểm thử đơn vị cho Security Rules đã tạo.

      • Tạo Security Rules cho Cloud Storage for Firebase:

        Generate Cloud Storage security rules for this project, then run the unit tests.

        Trong thư mục mẹ, tác nhân sẽ tạo một tệp storage.rules và một thư mục security_rules_test_storage mới chứa một dự án Node.js có các bài kiểm thử đơn vị cho Security Rules đã tạo.

    • Đối với các tác nhân lập trình hỗ trợ lệnh dấu gạch chéo (như Claude Code), hãy sử dụng các lệnh sau.

      • Tạo Security Rules cho Cloud Firestore:

        /firestore:generate_security_rules

      • Tạo Security Rules cho Cloud Storage for Firebase:

        /storage:generate_security_rules

    • Đối với các tác nhân lập trình không hỗ trợ tính năng tích hợp câu lệnh MCP, bạn có thể sao chép mẫu câu lệnh thô từ kho lưu trữ firebase-tools và dán vào cuộc trò chuyện của tác nhân.

Bước 2: Xem lại kết quả kiểm thử và xác thực Security Rules

  1. Đảm bảo tác nhân lập trình AI của bạn thực hiện những việc sau. Bạn sẽ nhận được bản tóm tắt đã tạo sau khi các công cụ chạy.

    • Xác thực cú pháp: Sau khi tạo Security Rules, tác nhân lập trình AI sẽ tự động xác thực cú pháp bằng lệnh firebase_validate_security_rules từ máy chủ Firebase MCP.

    • Kiểm thử đơn vị: Sau khi xác thực cú pháp, tác nhân lập trình AI sẽ cố gắng chạy các bài kiểm thử đơn vị đã tạo bằng Firebase Local Emulator Suite.

  2. Nếu các bài kiểm thử không chạy tự động, hãy khởi động Firebase Local Emulator Suite trong một thiết bị đầu cuối riêng, sau đó sử dụng một trong các lựa chọn sau để chạy các bài kiểm thử:

    • Lựa chọn 1: Hướng dẫn trợ lý AI chạy các bài kiểm thử:

      Firebase Emulator Suite is running in a separate terminal. Please execute the tests.

    • Lựa chọn 2: Chạy các bài kiểm thử theo cách thủ công bằng cách làm theo hướng dẫn trong tệp README.md trong thư mục rules_test hoặc storage_rules_test.

Bước 3: Triển khai Security Rules vào dự án Firebase

Khi bạn hài lòng với kết quả của Security Rules, hãy sử dụng các lệnh CLI Firebase sau để triển khai Security Rules vào dự án Firebase:

  • Cloud Firestore

    firebase deploy --only firestore:rules

  • Cloud Storage for Firebase

    firebase deploy --only storage