메인 콘텐츠로 건너뛰기
Firebase 프로젝트를 연결하여 CloudThinker 에이전트가 프로젝트와 앱을 인벤토리하고, SDK 설정을 읽고, Firestore·Storage·Realtime Database 보안 규칙을 감사하고, 배포 상태를 검토하고, Firebase 문서를 검색하고, 앱 생성이나 배포와 같은 승인 게이트 작업을 실행할 수 있도록 합니다. Firebase는 Google Cloud 서비스 계정 키 (JSON 파일)로 인증합니다. 서비스 계정의 IAM 역할이 에이전트가 접근할 수 있는 범위를 결정합니다 — 감사를 위해서는 읽기 전용 Firebase 역할을 부여하고, 쓰기나 배포가 필요한 경우에만 더 넓은 역할을 부여하세요.

​
사전 요구 사항

  • CloudThinker가 검사할 Firebase 프로젝트.
  • 해당 프로젝트의 서비스 계정 키 (JSON).
  • 프로젝트의 Google Cloud에서 서비스 계정 키를 생성하고 IAM 역할을 할당할 권한.
서비스 계정 JSON은 전체 자격 증명입니다. IAM 역할을 최소 권한으로 제한하세요 — 인벤토리 및 규칙 감사에는 뷰어 수준 Firebase 역할로 충분합니다.

​
설정

1

서비스 계정 키 생성

Firebase 콘솔에서 프로젝트를 선택한 후, 사이드바의 Settings (기어) 아이콘을 클릭하여 Project settings를 여세요. 상단 바에서 Service accounts 탭을 열고 Generate new private key를 클릭한 후 Generate key로 확인하여 JSON 키 파일을 다운로드하세요.
2

IAM 역할 부여 (최소 권한 적용 시 선택 사항)

Google Cloud 콘솔 → IAM에서 서비스 계정에 CloudThinker가 필요한 역할만 부여하세요 — 읽기 전용 감사를 위한 Viewer / Firebase Viewer 역할, 또는 승인 게이트 쓰기 및 배포가 필요한 경우 Firebase 관리자 역할.
3

CloudThinker에 연결 추가

Connections → Firebase로 이동하여 자격 증명을 추가하세요:
  • Service Account Key (JSON): 다운로드한 .json 키 파일을 업로드 영역에 드래그하거나 클릭하여 파일을 선택하세요
Connect를 클릭하세요. CloudThinker가 키를 읽어 활성 프로젝트를 설정하고 Connected 상태를 표시합니다.
다운로드한 JSON을 비밀번호처럼 취급하세요. 시크릿 매니저에 저장하고 CloudThinker에 업로드한 후 로컬 복사본을 삭제하세요.

​
연결 세부 정보

필드설명예시
GOOGLE_SERVICE_ACCOUNT_KEY전체 Google Cloud 서비스 계정 키 JSON. CloudThinker가 project_id를 읽어 활성 Firebase 프로젝트를 자동으로 설정합니다.{ "type": "service_account", "project_id": "my-app", ... }
CloudThinker가 키의 project_id에서 활성 프로젝트를 확인하므로, 별도의 프로젝트 ID나 설정 파일이 필요하지 않습니다.

​
필요 권한

읽기 작업 (프로젝트, 앱, SDK 설정, 보안 규칙 검사)은 뷰어 수준 Firebase/GCP 역할로 작동합니다. 제어 작업 — 프로젝트나 앱 생성, 기능 초기화, 활성 프로젝트 전환, 배포 — 은 해당 작업을 허용하는 역할과 CloudThinker에서의 명시적 승인이 추가로 필요합니다.
최소 권한을 따르세요: 감사를 위해 읽기 전용 Firebase 역할을 부여하고 실제로 필요할 때만 쓰기 가능한 역할을 예약하세요. 제어 작업은 안전 장치를 제거하지 말고 승인 게이트를 유지하세요.

​
에이전트 기능

연결되면 에이전트가 Firebase 프로젝트, 앱, 규칙에 대한 읽기 접근 권한을 갖습니다.
기능설명
프로젝트 & 앱접근 가능한 프로젝트 목록 조회, 활성 프로젝트 검사, iOS·Android·Web 앱 목록 조회
SDK 설정플랫폼 또는 앱의 Firebase SDK 설정 읽기
보안 규칙Firestore·Storage·Realtime Database 규칙을 읽어 접근 감사
배포 상태배포 상태 검토
Firebase 문서공식 Firebase 및 Google 개발자 문서 검색
프로젝트 & 앱 제어프로젝트, 앱, Android SHA 키 생성, 기능 초기화, 활성 프로젝트 전환, 배포 — 승인 필요
생성, 초기화, 배포, 프로젝트 전환 작업은 승인 게이트가 적용됩니다. CloudThinker는 실행 전에 확인을 요청합니다. 읽기 전용 작업은 승인 없이 실행됩니다.

​
연결 검증

@alex show my Firebase environment and list the projects I can access

​
예시 프롬프트

@alex review the current Firestore and Storage security rules, flag any that allow unauthenticated writes, and #recommend tighter definitions
@alex list all Firebase projects and the apps registered in the active project and #report as a table
@alex show the Firebase SDK config for my web app
여러 프로젝트에 접근 가능하고 활성화된 것이 없다면, 에이전트가 올바른 프로젝트를 범위로 하도록 프롬프트에 프로젝트 이름을 명시하세요.

​
문제 해결

서비스 계정 JSON이 잘못되었거나 불완전하거나 문자가 누락된 채로 붙여 넣어졌습니다. Firebase 콘솔에서 새 개인 키를 생성하고 다시 연결하세요.
CloudThinker가 키의 project_id에서 활성 프로젝트를 설정합니다. 키에 project_id가 없거나 여러 프로젝트에 접근 가능한 경우, 에이전트가 목록을 보여주고 어떤 것을 사용할지 묻습니다 — 계속하려면 프로젝트를 명시하세요.
서비스 계정에 해당 제품에 대한 Firebase/GCP IAM 역할이 없습니다. Google Cloud IAM에서 적절한 역할을 부여하고 다시 연결하세요.
생성, 초기화, 배포는 해당 작업을 허용하는 IAM 역할과 CloudThinker에서의 명시적 승인이 모두 필요합니다. 메시지가 나타나면 작업을 승인하고 서비스 계정의 역할이 허용하는지 확인하세요.

​
보안

  • 최소 권한 — 에이전트가 사용 사례에 필요한 권한만 부여하세요. 읽기 전용으로 시작한 후 필요에 따라 확장하세요.
  • 기본 읽기 전용 — 에이전트가 이 연결을 통해 변경 작업을 수행하게 할 것이 아니라면 읽기 전용 자격증명을 사용하세요.
  • 자격증명 교체 — 정기 일정에 따라 키와 토큰을 교체하세요. 연결을 업데이트하면 CloudThinker가 새 값을 자동으로 반영합니다.
  • 오프보딩 시 취소 — 연결을 삭제하거나 팀원이 퇴사할 때 프로바이더에서 자격증명을 제거하세요.
  • 제어 작업 승인 — 생성, 초기화, 배포 작업은 안전 장치를 제거하지 말고 승인 게이트를 유지하세요.
  • 키 보호 — 서비스 계정 JSON은 전체 자격 증명입니다. 소스 관리에 커밋하거나 일반 텍스트로 공유하지 마세요.

​
관련 문서

https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/gcp.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=2cc7040a8e4cd401b1c388f8b0cd6fe3

Google Cloud 연결

Google Cloud Platform 연결

Approval

승인 게이트 작업의 작동 방식