Chuyển đến nội dung chính
Kết nối Firebase để CloudThinker liệt kê project và ứng dụng, đọc cấu hình SDK, kiểm tra security rules của Firestore, Storage và Realtime Database, và xem trạng thái deploy. Firebase xác thực bằng Google Cloud service-account key (file JSON), và các IAM role của service account quyết định CloudThinker truy cập được gì.

Chọn Firebase hay Google Cloud

Hai kết nối này độc lập với nhau. Bạn có thể kết nối cả hai cho cùng một project, mỗi kết nối một service account riêng.

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

  • Một project Firebase mà bạn muốn CloudThinker kiểm tra.
  • Quyền trong Google Cloud của project đó để tạo service account và key, và gán IAM role.
  • Cho phép tạo service account key. Nếu tổ chức của bạn áp dụng constraints/iam.disableServiceAccountKeyCreation (mặc định trên các tổ chức tạo từ tháng 5/2024), hãy nhờ organization policy admin cấp ngoại lệ cho project này trước.

Thiết lập

Trước tiên, hãy quyết định cách bao quát nhiều project. Phần lớn các đội dùng mỗi project một kết nối.
Đừng dùng Generate new private key trong Project settings của Firebase. Nút này tạo key cho tài khoản mặc định firebase-adminsdk-…@<project-id>.iam.gserviceaccount.com, vốn có quyền admin rộng và có thể đang được chính ứng dụng của bạn sử dụng. Cũng đừng gỡ role khỏi tài khoản đó.
1

Tạo service account riêng

Trong Google Cloud console, chọn project Firebase và vào IAM & Admin → Service Accounts. Nhấn Create service account, đặt tên cloudthinker-firebase, rồi nhấn Create and continue.
2

Cấp role Firebase chỉ đọc

Thêm Firebase Viewer (roles/firebase.viewer) và nhấn Done. Chỉ thêm role ghi nếu bạn muốn CloudThinker tạo ứng dụng hoặc deploy thông qua phê duyệt của bạn. Xem Quyền yêu cầu.
3

Tạo JSON key

Mở service account, vào tab Keys, rồi nhấn Add key → Create new key. Chọn JSON và nhấn Create.Trạng thái thành công: trình duyệt tải xuống một file key .json.
Sau đó kết nối trong CloudThinker:
1

Mở hộp thoại kết nối

Trên thanh bên, nhấn More → Workspace settings → Connections, chọn Firebase, rồi nhấn Connect.
2

Đặt tên kết nối

Điền Alias (ví dụ prod-firebase) và Description (ví dụ Production Firebase project, mobile app). Agent đọc phần mô tả để chọn đúng kết nối khi bạn có nhiều kết nối.
3

Tải key lên

Kéo file .json vào vùng tải lên, hoặc nhấn choose a JSON file để chọn file. Nhấn Connect.Trạng thái thành công: kết nối hiển thị Connected, và project_id của key là project đang hoạt động. Sau đó bước khám phá chạy một lần ở chế độ nền và tiêu tốn credit. Bước này không bao giờ chờ phê duyệt, nên bỏ qua việc chuyển project và kiểm tra trạng thái deploy. Xem Điều gì xảy ra sau khi kết nối.
4

Đặt environment

Mở Firebase trong More → Workspace settings → Connections, nhấn biểu tượng bút chì trên dòng của kết nối, rồi đặt Environment trong Edit Instance. Trường này gắn nhãn cho kết nối để người và agent dễ nhận biết.

Chi tiết kết nối

Bạn không cần project ID riêng hay file cấu hình Firebase. Để bao quát nhiều project, xem các lựa chọn trong Thiết lập.

Quyền yêu cầu

Google yêu cầu thêm role cho một số loại deploy. Ví dụ, deploy Cloud Functions cần thêm Cloud Functions Developer (roles/cloudfunctions.developer) và Service Account User (roles/iam.serviceAccountUser).
Firebase không có công tắc Allow writes. Mọi thay đổi đều đi qua Approvals, và chỉ chạy khi IAM role cũng cho phép. Hãy cấp Firebase Viewer cho việc kiểm tra.

Khả năng của agent

CloudThinker dùng bộ công cụ Firebase CLI chính thức (firebase-tools) qua kết nối này. Kết nối bao gồm những gì firebase-tools cung cấp. Kết nối không đọc document Firestore, user của Authentication, Crashlytics hay Remote Config.

Xác minh kết nối

Câu trả lời nêu đúng project_id thật của bạn là project đang hoạt động.

Ví dụ prompt

Khắc phục sự cố

Nguyên nhân: JSON key không hợp lệ, không đầy đủ, hoặc thuộc về một service account đã bị xóa.Cách sửa: tạo JSON key mới cho service account. Trong More → Workspace settings → Connections, mở Firebase, nhấn biểu tượng bút chì trên dòng của kết nối, rồi dùng Replace… trong Edit Instance để tải key lên.
Nguyên nhân: lỗi ghi PRECONDITION_FAILED và nhắc tới project đang hoạt động. CloudThinker đặt project đang hoạt động từ project_id của key mỗi khi kết nối khởi động. Nếu không đọc được key đã lưu, ví dụ vì key bị sửa trước khi tải lên, sẽ không có project nào được chọn. Tài nguyên không hề bị thiếu.Cách sửa: với prompt này, hãy nêu tên project. Việc chuyển project đang hoạt động đi qua phê duyệt của bạn. Để sửa hẳn, hãy tạo JSON key mới và tải nguyên file đã tải xuống, không chỉnh sửa, bằng Replace… trong Edit Instance.
Nguyên nhân: service account thiếu IAM role cho sản phẩm Firebase đó, hoặc không nhìn thấy project.Cách sửa: trong Google Cloud console → IAM, cấp Firebase Viewer cho thao tác đọc và rules, hoặc Firebase Admin (hay role hẹp hơn trong Quyền yêu cầu) cho thao tác tạo và deploy. Sau đó thử lại.
Nguyên nhân: service account không có role nào trong project đó.Cách sửa: trong Google Cloud console → IAM của project đó, cấp cho service account role Firebase Viewer (roles/firebase.viewer), rồi hỏi lại.
Nguyên nhân: bước kiểm tra không hoàn tất kịp thời. Endpoint của Firebase là công khai, nên hiếm khi do mạng của bạn.Cách sửa: kết nối lại. Nếu vẫn tiếp tục timeout, hãy liên hệ chúng tôi.
Nguyên nhân: thao tác ghi cần cả IAM role cho phép lẫn phê duyệt trong CloudThinker. Nếu bạn đã từ chối yêu cầu, CloudThinker sẽ không thử lại.Cách sửa: kiểm tra role của service account, rồi hỏi lại.

Bảo mật

  • Quyền tối thiểu — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
  • Chỉ đọc theo mặc định — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
  • Xoay vòng thông tin xác thực — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
  • Thu hồi khi bàn giao — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.
  • Bảo vệ key: JSON key là thông tin xác thực đầy đủ của service account. Xóa bản sao cục bộ sau khi tải lên, và không bao giờ commit hay dán key vào chat.
  • Xoay vòng key ít nhất mỗi 90 ngày: tạo key mới, tải lên bằng Replace… trong Edit Instance, rồi xóa key cũ. Xem Xoay vòng thông tin xác thực.

Liên quan

Kết nối Google Cloud

Kết nối phần còn lại của project Google Cloud.

Approvals

Kiểm soát cách các thao tác cần phê duyệt được quyết định.