인증 및 승인

Firebase 원격 분석 플러그인에는 Google Cloud 또는 Firebase 프로젝트 ID와 애플리케이션 사용자 인증 정보가 필요합니다.

Google Cloud 프로젝트 및 계정이 없는 경우 Firebase Console 또는 Google Cloud 콘솔에서 설정할 수 있습니다. 모든 Firebase 프로젝트 ID는 Google Cloud 프로젝트 ID입니다.

API 사용 설정

플러그인을 추가하기 전에 프로젝트에 다음 API가 사용 설정되어 있는지 확인합니다.

이러한 API는 프로젝트의 API 대시보드에 표시되어야 합니다. API를 사용 설정 및 중지하는 방법을 자세히 알아보려면 클릭하세요.

사용자 인증

로컬 개발 환경에서 Firebase Genkit 모니터링으로 원격 분석을 내보내려면 Google Cloud로 인증해야 합니다.

본인으로 인증하는 가장 쉬운 방법은 gcloud CLI를 사용하는 것입니다. 그러면 애플리케이션 기본 사용자 인증 정보 (ADC)를 통해 프레임워크에서 사용자 인증 정보를 자동으로 사용할 수 있습니다.

gcloud CLI가 설치되어 있지 않으면 먼저 설치 안내를 따르세요.

  1. gcloud CLI를 사용하여 인증합니다.

    gcloud auth application-default login

  2. 프로젝트 ID 설정

    gcloud config set project PROJECT_ID

Google Cloud에 배포

Google Cloud 또는 Firebase 환경 (Cloud Functions, Cloud Run, 앱 호스팅 등)에 코드를 배포하는 경우 프로젝트 ID와 사용자 인증 정보는 애플리케이션 기본 사용자 인증 정보를 사용하여 자동으로 검색됩니다.

IAM 콘솔을 사용하여 코드를 실행하는 서비스 계정 (즉, '연결된 서비스 계정')에 다음 역할을 적용해야 합니다.

  • roles/monitoring.metricWriter
  • roles/cloudtrace.agent
  • roles/logging.logWriter

어떤 서비스 계정이 적합한지 모르시나요? 서비스 계정 찾기 또는 만들기 섹션을 참고하세요.

Google Cloud 외부 배포 (ADC 사용)

가능하면 애플리케이션 기본 사용자 인증 정보를 사용하여 플러그인에서 사용자 인증 정보를 사용할 수 있도록 합니다.

일반적으로 서비스 계정 키를 생성하고 이러한 사용자 인증 정보를 프로덕션 환경에 배포하는 작업이 포함됩니다.

  1. 안내에 따라 서비스 계정 키를 설정합니다.

  2. 서비스 계정에 다음 역할이 있는지 확인합니다.

    • roles/monitoring.metricWriter
    • roles/cloudtrace.agent
    • roles/logging.logWriter

  3. 사용자 인증 정보 파일을 프로덕션에 배포합니다 (소스 코드에 체크인하지 마세요).

  4. GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 사용자 인증 정보 파일의 경로로 설정합니다.

    GOOGLE_APPLICATION_CREDENTIALS = "path/to/your/key/file"

어떤 서비스 계정이 적합한지 모르시나요? 서비스 계정 찾기 또는 만들기 섹션을 참고하세요.

Google Cloud 외부 배포 (ADC 없음)

일부 서버리스 환경에서는 사용자 인증 정보 파일을 배포할 수 없습니다.

  1. 안내에 따라 서비스 계정 키를 설정합니다.

  2. 서비스 계정에 다음 역할이 있는지 확인합니다.

    • roles/monitoring.metricWriter
    • roles/cloudtrace.agent
    • roles/logging.logWriter

  3. 사용자 인증 정보 파일을 다운로드합니다.

  4. 다음과 같이 사용자 인증 정보 파일의 콘텐츠를 GCLOUD_SERVICE_ACCOUNT_CREDS 환경 변수에 할당합니다.

GCLOUD_SERVICE_ACCOUNT_CREDS='{
  "type": "service_account",
  "project_id": "your-project-id",
  "private_key_id": "your-private-key-id",
  "private_key": "your-private-key",
  "client_email": "your-client-email",
  "client_id": "your-client-id",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://accounts.google.com/o/oauth2/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "your-cert-url"
}'

어떤 서비스 계정이 적합한지 모르시나요? 서비스 계정 찾기 또는 만들기 섹션을 참고하세요.

서비스 계정 찾기 또는 만들기

적절한 서비스 계정을 찾으려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔의 서비스 계정 페이지로 이동합니다.
  2. 프로젝트 선택
  3. 적절한 서비스 계정을 찾습니다. 일반적인 기본 서비스 계정은 다음과 같습니다.

  • Firebase Functions 및 Cloud Run

    PROJECT ID-compute@developer.gserviceaccount.com

  • App Engine

    PROJECT ID@appspot.gserviceaccount.com

  • 앱 호스팅

    firebase-app-hosting-compute@PROJECT ID.iam.gserviceaccount.com

Google 생태계 외부에서 배포하거나 기본 서비스 계정을 사용하지 않으려는 경우 Google Cloud 콘솔에서 서비스 계정을 만들 수 있습니다.