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 (chẳng hạn như Google Antigravity) tạo và tinh chỉnh Firebase Security Rules cho ứng dụng của bạn. Bạn có thể dùng câu lệnh này để phác 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 các 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 vào các tệp bạn đã 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 trạng thái bảo mật mạnh mẽ, nhưng bạn luôn phải kiểm tra kỹ lưỡng Security Rules trước khi triển khai cho sản xuất. Để biết thêm thông tin về việc kiểm thử Security Rules, hãy xem bài viết Bắt đầu 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 lại để nắm được 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ông cụ này chưa thể tạo Security Rules cho Firebase Realtime Database.

  • Firebase Security Rules sẽ không được gọi khi truy cập vào cơ sở dữ liệu hoặc nhóm 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 phải chịu trách nhiệm quản lý việc 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 bạn 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 tính năng này khi dùng máy chủ MCP của Firebase 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 Security Rules và các bài kiểm thử. Những công cụ này phân tích mã nguồn của bạn để giúp xác định giản đồ dữ liệu và các mẫu truy cập cho Cloud Firestore và Cloud Storage. Các công cụ này được thiết kế để tạ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 hoạt động mô phỏng "tấn công" lặp đi lặp lại. Để hỗ trợ quy trình xác minh cuối cùng, họ cung cấp một bộ kiểm thử đơn vị ban đầ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 tại chỗ bằng cách sử dụ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 Security Rules và kiểm thử.

  2. Xem Security Ruleskết quả xác thực và kiểm thử.

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

Bước 1: Tạo Security Rules và các 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:

    • Google Antigravity: Tham khảo hướng dẫn thiết lập để bật gói tích hợp Firebase. Nếu đang dùng CLI, bạn có thể bật các kỹ năng bằng cách chạy:

      npx skills add firebase/agent-skills --agent=antigravity

    • Các tác nhân lập trình AI khác: Làm theo hướng dẫn về kỹ năng của tác nhân và máy chủ MCP.

  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ừ 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 của bạn tương tác với 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 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 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 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 những tác nhân lập trình không hỗ trợ 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 rồi dán vào cuộc trò chuyện của tác nhân.

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

  1. Đảm bảo rằng 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 được 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 cách sử dụng Firebase Local Emulator Suite.

  2. Nếu các 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 biệt, sau đó sử dụng một trong các lựa chọn sau để chạy các kiểm thử:

    • Cách 1: Hướng dẫn trợ lý AI chạy các bài kiểm tra:

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

    • Cách 2: Chạy thử nghiệm 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 của bạn

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

  • Cloud Firestore

    firebase deploy --only firestore:rules

  • Cloud Storage for Firebase

    firebase deploy --only storage