Firebase IAM 權限

您可以透過角色將權限授予專案成員。角色是一組權限。將角色指派給專案成員後，就會授予該專案成員該角色包含的所有權限。

本頁面說明 Firebase 支援的角色中列出的權限可啟用的動作。這些權限分為兩類：

所需權限

Firebase IAM 包含下列權限：

如需 Firebase 產品或服務專屬權限的一般清單和說明，請參閱 Firebase 產品專屬 IAM 權限 中的適當章節。

所有角色都包含的必要權限

您必須具備下表所列的權限，才能使用任何 Firebase 產品或服務。

這些權限會自動納入每個 Firebase 預先定義的角色。

權限 說明
授予擷取 Firebase 專案資訊的權限
授予擷取 Firebase 專案資訊的權限
授予權限，以便檢查 Google API 的狀態，並執行 Firebase CLI 指令

Firebase 服務專屬動作所需的權限

下表列出的權限是執行某些 Firebase 服務專屬動作所需的權限。

在需要時，這些權限會自動納入每個 Firebase 預先定義的角色。

動作 必要權限
透過協作工具 (包括 Slack、Jira 和 PagerDuty) 存取 Firebase 專案整合功能 firebaseextensions.configs.*
透過 Stackdriver 查看用量和分析資料 monitoring.timeSeries.list
執行 Firebase CLI 指令
詳情請參閱 Google Cloud 說明文件，瞭解如何存取 Runtime Configurator。		 runtimeconfig.*

Firebase 管理專屬動作所需的權限

下表列出的權限是額外權限，必須具備這些權限才能執行某些 Firebase 管理相關動作。

管理權限和相關動作 需要額外權限
firebase.billingPlans.update
變更 Firebase 專案的計費方案 resourcemanager.projects.createBillingAssignment
resourcemanager.projects.deleteBillingAssignment
firebase.projects.delete
刪除 Firebase 專案 resourcemanager.projects.delete
firebase.projects.update
將 Firebase 資源新增至現有的 Google Cloud 專案 resourcemanager.projects.get
serviceusage.services.enable
serviceusage.services.get
變更 Firebase 專案名稱 resourcemanager.projects.update
為 Android 應用程式新增 SHA 憑證指紋 clientauthconfig.clients.create
移除 Android 應用程式的 SHA 憑證指紋 clientauthconfig.clients.delete
更新 Apple 應用程式的 App Store ID 或團隊 ID clientauthconfig.clients.get
clientauthconfig.clients.update

Firebase 產品專屬的 IAM 權限

下表列出 Firebase 產品或服務的專屬權限。您可以使用這些權限建立自訂角色。

Firebase 管理權限

請注意，下列部分管理權限需要額外權限才能執行特定動作。

權限名稱 說明
firebase.billingPlans.get 擷取專案目前的 Firebase 計費方案
firebase.billingPlans.update 變更專案目前的 Firebase 計費方案
firebase.clients.create 在專案中新增應用程式
firebase.clients.delete 從專案中刪除現有應用程式
firebase.clients.get 擷取專案中應用程式的詳細資料和設定
firebase.clients.list 擷取專案中的應用程式清單
firebase.clients.undelete 在資料遭到永久刪除前，取消刪除已刪除的應用程式
firebase.clients.update 更新專案中應用程式的詳細資料和設定
firebase.links.create 建立連結至 Google 系統的新連結
(Firebase 控制台 > 專案設定 > 整合)
firebase.links.delete 刪除 Google 系統的連結
(Firebase 控制台 > 專案設定 > 整合)
firebase.links.list 擷取連至 Google 系統的連結清單
(Firebase 控制台 > 專案設定 > 整合)
firebase.links.update 更新現有的 Google 系統連結
(Firebase 控制台 > 專案設定 > 整合)
firebase.playLinks.get 擷取 Google Play 連結的詳細資料
(Firebase 主控台 > 專案設定 > 整合 > Google Play)
firebase.playLinks.list 擷取 Google Play 連結清單
(Firebase 主控台 > 專案設定 > 整合 > Google Play)
firebase.playLinks.update 建立新的連結，並更新現有的 Google Play 連結
(Firebase 控制台 > 專案設定 > 整合 > Google Play)
firebase.projects.delete 刪除現有專案
firebase.projects.get 擷取專案的詳細資料和 Firebase 資源
firebase.projects.update 修改現有專案的屬性
接收適用 Firebase 產品和功能的警告 (瞭解詳情)
firebaseinstallations.instances.delete 刪除 Firebase 安裝 ID 和與該安裝相關聯的資料 (瞭解詳情)

Google Analytics權限

下列權限會授予存取連結至 Firebase 專案的 Analytics 資源的權限。讓 Firebase 專案成員存取 Analytics 資料，包括目標對象、使用者屬性、漏斗、報表、轉換等。

權限名稱 說明
firebaseanalytics.resources.googleAnalyticsEdit 預設會將 Analytics 編輯者角色授予已連結的 Analytics 資源
firebaseanalytics.resources.googleAnalyticsAdditionalAccess 根據預設，將 Analytics 行銷人角色授予已連結的 Analytics 資源
firebaseanalytics.resources.googleAnalyticsReadAndAnalyze 預設會將 Analytics 檢視者角色授予已連結的 Analytics 資源
firebaseanalytics.resources.googleAnalyticsRestrictedAccess 根據預設，將 Analytics 檢視者角色授予已連結的 Analytics 資源，但無法存取收益資料和費用資料

Firebase App Check權限

權限名稱 說明
firebaseappcheck.appAttestConfig.get 擷取應用程式的 App Attest 設定
firebaseappcheck.appAttestConfig.update 更新應用程式的 App Attest 設定
firebaseappcheck.appCheckTokens.verify 驗證 Firebase 專案所核發的 App Check 權杖
firebaseappcheck.debugTokens.get 擷取應用程式的偵錯權杖
firebaseappcheck.debugTokens.update 建立、更新或刪除應用程式的偵錯權杖
firebaseappcheck.deviceCheckConfig.get 擷取應用程式的 DeviceCheck 設定
firebaseappcheck.deviceCheckConfig.update 更新應用程式的 DeviceCheck 設定
firebaseappcheck.playIntegrityConfig.get 擷取應用程式的 Play Integrity 設定
firebaseappcheck.playIntegrityConfig.update 更新應用程式的 Play Integrity 設定
firebaseappcheck.recaptchaEnterpriseConfig.get 擷取應用程式的 reCAPTCHA Enterprise 設定
firebaseappcheck.recaptchaEnterpriseConfig.update 更新應用程式的 reCAPTCHA Enterprise 設定
firebaseappcheck.recaptchaV3Config.get 擷取應用程式的 reCAPTCHA v3 設定
firebaseappcheck.recaptchaV3Config.update 更新應用程式的 reCAPTCHA v3 設定
firebaseappcheck.safetyNetConfig.get 擷取應用程式的 SafetyNet 設定
firebaseappcheck.safetyNetConfig.update 更新應用程式的 SafetyNet 設定
firebaseappcheck.services.get 擷取專案的服務強制執行設定
firebaseappcheck.services.update 更新專案的服務強制執行設定

Firebase App Distribution權限

權限名稱 說明
firebaseappdistro.releases.list 擷取現有發布和邀請連結的清單
firebaseappdistro.releases.update 建立、刪除及修改發送清單
建立及刪除邀請連結
firebaseappdistro.testers.list 擷取專案中現有測試人員的清單
firebaseappdistro.testers.update 在專案中建立及刪除測試人員
firebaseappdistro.groups.list 擷取專案中現有測試人員群組的清單
firebaseappdistro.groups.update 在專案中建立及刪除測試人員群組

Firebase Authentication權限

權限名稱 說明
firebaseauth.configs.create 建立 Authentication 設定
firebaseauth.configs.get 擷取 Authentication 設定
firebaseauth.configs.getHashConfig 取得使用者帳戶的密碼雜湊設定和密碼雜湊
firebaseauth.configs.getSecret 取得 Authentication 設定中的用戶端密碼
firebaseauth.configs.update 更新現有的 Authentication 設定
firebaseauth.users.create 在 Authentication 中建立新使用者
firebaseauth.users.createSession 為已登入的使用者建立工作階段 Cookie
firebaseauth.users.delete 刪除 Authentication 中的現有使用者
firebaseauth.users.get 擷取現有 Authentication 使用者的清單
firebaseauth.users.sendEmail 傳送電子郵件給使用者
firebaseauth.users.update 更新 Authentication 中的現有使用者

Firebase A/B Testing 權限(Beta 版)

權限名稱 說明
firebaseabt.experimentresults.get 擷取實驗結果
firebaseabt.experiments.create 建立新實驗
firebaseabt.experiments.delete 刪除現有實驗
firebaseabt.experiments.get 擷取現有實驗的詳細資料
firebaseabt.experiments.list 擷取現有實驗的清單
firebaseabt.experiments.update 更新現有實驗
firebaseabt.projectmetadata.get 擷取數據分析中繼資料，以便設定實驗

Firebase App Hosting 權限(Beta 版)

權限名稱 說明
firebaseapphosting.backends.create 為 Firebase 專案建立新的 App Hosting 後端。
firebaseapphosting.backends.delete 從 Firebase 專案中刪除現有的 App Hosting 後端。
firebaseapphosting.backends.get 擷取 Firebase 專案中特定 App Hosting 後端的相關資訊。
firebaseapphosting.backends.list 列出 Firebase 專案中所有可用的 App Hosting 後端。
firebaseapphosting.backends.update 修改現有 App Hosting 後端的設定或設定。
firebaseapphosting.builds.create 在 Firebase 專案中，為 App Hosting 後端啟動新的建構程序。
firebaseapphosting.builds.delete 刪除 App Hosting 後端中的現有版本。
firebaseapphosting.builds.get 擷取 App Hosting 後端中現有版本的詳細資料。
firebaseapphosting.builds.list 列出 Firebase 專案中與 App Hosting 後端相關聯的所有版本。
firebaseapphosting.builds.update 修改現有未定案 App Hosting 版本的設定。
firebaseapphosting.domains.create 為 Firebase 專案中的 App Hosting 後端建立新的網域關聯。
firebaseapphosting.domains.delete 從 App Hosting 後端移除網域關聯。
firebaseapphosting.domains.get 擷取與 App Hosting 網站相關聯的特定網域相關資訊。
firebaseapphosting.domains.list 列出與 App Hosting 相關聯的所有網域。
firebaseapphosting.domains.update 修改已連結至 App Hosting 後端的網域設定。
firebaseapphosting.rollouts.create 啟動新的推出作業，將現有版本升級為該 App Hosting 後端目前提供的版本。
firebaseapphosting.rollouts.get 擷取特定 App Hosting 推出計畫的相關資訊。
firebaseapphosting.rollouts.list 列出與 App Hosting 後端相關聯的所有推行內容。
firebaseapphosting.traffic.get 擷取 App Hosting 網站目前的流量分配和推行政策。
firebaseapphosting.traffic.list 與 `firebaseapphosting.traffic.get` 的功能相同，但新增了可在您擁有此權限的後端間擷取清單的功能。
firebaseapphosting.traffic.update 修改 App Hosting 後端目前的流量分配和推出政策。

Cloud Firestore權限

如需 Cloud Firestore 權限的清單和說明，請參閱 Google Cloud 說明文件。

Cloud Storage權限

如需 Cloud Storage 權限的清單和說明，請參閱 Google Cloud 說明文件。

Firebase 安全性規則 (Cloud Firestore 和 Cloud Storage) 權限

權限名稱 說明
firebaserules.releases.create 建立版本
firebaserules.releases.delete 刪除版本
firebaserules.releases.get 擷取版本
firebaserules.releases.getExecutable 擷取版本的二進位可執行酬載
firebaserules.releases.list 擷取版本清單
firebaserules.releases.update 更新版本的規則集參照
firebaserules.rulesets.create 建立新規則集
firebaserules.rulesets.delete 刪除現有規則集
firebaserules.rulesets.get 使用來源擷取規則集
firebaserules.rulesets.list 找出規則集中繼資料 (沒有來源)
firebaserules.rulesets.test 測試來源是否正確

Cloud Functions for Firebase權限

如需 Cloud Functions 權限的清單和說明，請參閱 IAM 說明文件。

請注意，部署函式需要特定的權限設定，而這些權限並未包含在標準 Firebase 預先定義角色中。如要部署函式，請使用下列其中一種方式：

Firebase 通訊廣告活動權限

這些權限適用於 Firebase Cloud Messaging 和 Firebase In-App Messaging 的廣告活動。

權限名稱 說明
firebasemessagingcampaigns.campaigns.create 建立新廣告活動
firebasemessagingcampaigns.campaigns.delete 刪除現有廣告活動
firebasemessagingcampaigns.campaigns.get 擷取現有廣告活動的詳細資料
firebasemessagingcampaigns.campaigns.list 擷取現有廣告活動的清單
firebasemessagingcampaigns.campaigns.update 更新現有廣告活動
firebasemessagingcampaigns.campaigns.start 啟動現有廣告活動
firebasemessagingcampaigns.campaigns.stop 更新現有廣告活動

Firebase Cloud Messaging權限

權限名稱 說明
cloudmessaging.messages.create 透過 FCM HTTP API 和 Admin SDK 傳送通知和資料訊息
權限名稱 說明
firebasenotifications.messages.create 在通知編輯器中建立新訊息
firebasenotifications.messages.delete 在通知編寫器中刪除現有訊息
firebasenotifications.messages.get 在通知編寫工具中擷取現有訊息的詳細資料
firebasenotifications.messages.list 在通知編寫工具中擷取現有訊息清單
firebasenotifications.messages.update 在通知編輯器中更新現有訊息

Firebase Crashlytics權限

權限名稱 說明
firebasecrashlytics.config.get 擷取 Crashlytics 設定
firebasecrashlytics.config.update 更新 Crashlytics 設定
firebasecrashlytics.data.get 擷取與 Crashlytics 問題和工作階段相關的指標
firebasecrashlytics.issues.get 擷取 Crashlytics 問題的詳細資料，包括附加至問題的附註
firebasecrashlytics.issues.list 擷取 Crashlytics 問題清單
firebasecrashlytics.issues.update 開啟、關閉及略過現有的 Crashlytics 問題
更新附加至問題的附註
firebasecrashlytics.sessions.get 擷取 Crashlytics 當機工作階段的詳細資料
權限名稱 說明
firebasecrash.issues.update 更新現有的 Crashlytics 問題、建立問題附註，以及設定速度警示
firebasecrash.reports.get 擷取現有的 Crashlytics 報表
權限名稱 說明
firebasedynamiclinks.domains.create 建立新的 Dynamic Links 網域
firebasedynamiclinks.domains.delete 刪除現有的 Dynamic Links 網域
firebasedynamiclinks.domains.get 擷取現有 Dynamic Links 網域的詳細資料
firebasedynamiclinks.domains.list 擷取現有 Dynamic Links 網域的清單
firebasedynamiclinks.domains.update 更新現有的 Dynamic Links 網域
firebasedynamiclinks.links.create 建立新 Dynamic Links
firebasedynamiclinks.links.get 擷取現有 Dynamic Links 的詳細資料
firebasedynamiclinks.links.list 擷取現有 Dynamic Links 的清單
firebasedynamiclinks.links.update 更新現有的 Dynamic Links
firebasedynamiclinks.stats.get 擷取 Dynamic Links 統計資料
firebasedynamiclinks.destinations.list 擷取現有的 Dynamic Links 目的地
firebasedynamiclinks.destinations.update 更新現有的 Dynamic Links 目的地

Firebase Extensions 發布權限

權限名稱 說明
firebaseextensionspublisher.extensions.create 上傳擴充功能的新版本
firebaseextensionspublisher.extensions.delete 刪除或淘汰擴充功能版本
firebaseextensionspublisher.extensions.get 擷取擴充功能版本的詳細資料
firebaseextensionspublisher.extensions.list 列出此發布者專案上傳的所有擴充功能版本

Firebase Hosting權限

權限名稱 說明
firebasehosting.sites.create 為 Firebase 專案建立新的 Hosting 資源
firebasehosting.sites.delete 刪除 Firebase 專案的現有 Hosting 資源
firebasehosting.sites.get 擷取 Firebase 專案現有 Hosting 資源的詳細資料
firebasehosting.sites.list 擷取 Firebase 專案的 Hosting 資源清單
firebasehosting.sites.update 更新 Firebase 專案的現有 Hosting 資源

Firebase In-App Messaging 權限(Beta 版)

權限名稱 說明
firebaseinappmessaging.campaigns.create 建立新廣告活動
firebaseinappmessaging.campaigns.delete 刪除現有廣告活動
firebaseinappmessaging.campaigns.get 擷取現有廣告活動的詳細資料
firebaseinappmessaging.campaigns.list 擷取現有廣告活動的清單
firebaseinappmessaging.campaigns.update 更新現有廣告活動

Firebase ML 權限(Beta 版)

權限名稱 說明
firebaseml.models.create 建立新的機器學習模型
firebaseml.models.update 更新現有機器學習模型
firebaseml.models.delete 刪除現有的機器學習模型
firebaseml.models.get 擷取現有機器學習模型的詳細資料
firebaseml.models.list 擷取現有機器學習模型的清單
firebaseml.modelversions.create 建立新模型版本
firebaseml.modelversions.get 擷取現有模型版本的詳細資料
firebaseml.modelversions.list 擷取現有模型版本的清單
firebaseml.modelversions.update 更新現有模型版本

Firebase AI Logic權限

權限名稱 說明
firebasevertexai.configs.get 擷取 Firebase AI Logic 的設定
firebasevertexai.configs.update 更新 Firebase AI Logic 的設定

Firebase Performance Monitoring權限

權限名稱 說明
firebaseperformance.config.create 建立新的議題門檻設定
firebaseperformance.config.delete 刪除現有的議題門檻設定
firebaseperformance.config.update 修改快訊和現有問題門檻設定
firebaseperformance.data.get 查看所有成效資料和問題門檻值

Firebase Realtime Database權限

權限名稱 說明
firebasedatabase.instances.create 建立新的資料庫例項
firebasedatabase.instances.get 擷取現有資料庫執行個體的中繼資料
對現有資料庫執行個體中的資料具備唯讀存取權
firebasedatabase.instances.list 擷取現有資料庫執行個體的清單
firebasedatabase.instances.update 具備現有資料庫執行個體中資料的完整讀取和寫入權限
啟用及停用資料庫執行個體
擷取及修改現有資料庫執行個體的安全性規則
firebasedatabase.instances.disable 停用有效的資料庫執行個體

現有資料會保留，但無法進行讀取/寫入作業。
firebasedatabase.instances.reenable 重新啟用已停用的資料庫執行個體

現有資料可再次讀取/寫入。
firebasedatabase.instances.delete 刪除停用的資料庫執行個體

刪除的資料庫名稱無法重複使用。
刪除的資料庫執行個體中的資料會在 20 天後永久刪除。
firebasedatabase.instances.undelete 在資料永久刪除前，還原已刪除的資料庫執行個體

刪除執行個體後，系統會在 20 天後永久刪除該執行個體中的資料。

Firebase Remote Config權限

權限名稱 說明
cloudconfig.configs.get 擷取 Remote Config 資料
cloudconfig.configs.update 更新 Remote Config 資料

Firebase Test Lab權限

Test Lab 需要存取 Cloud Storage 儲存桶，因此需要特定的權限設定，而這些權限並非全部包含在標準 Firebase 預先定義角色中。如要授予 Test Lab 存取權，請使用下列其中一種方法：

  • 針對從 Firebase 控制台啟動的測試

    • 在專屬的 Firebase 專案中測試應用程式。

    • 新增需要 Test Lab 存取權的成員，然後使用 Firebase 控制台指派舊版專案角色。

      • 如要允許成員使用 Test Lab 執行測試，請指派專案「編輯者」或更高角色。
      • 如要讓成員在 Test Lab 中查看測試結果，請指派專案「Viewer」以上的角色。

  • 如果是使用 gcloud CLI、Testing API 或 Gradle 管理的裝置啟動測試，並使用自己的 Cloud Storage 儲存體

    • 使用 Google Cloud 控制台指派一組預先定義的角色 (這些角色會共同授予必要的權限組合)。

      • 如要允許成員使用 Test Lab 執行測試，請指派下列兩項權限：

        • Firebase Test Lab 管理員 (roles/cloudtestservice.testAdmin)
        • Firebase Analytics 檢視者 (roles/firebase.analyticsViewer)

      • 如要讓成員在 Test Lab 中查看測試結果，請同時指派下列權限：

        • Firebase Test Lab 檢視器 (roles/cloudtestservice.testViewer)
        • Firebase Analytics 檢視者 (roles/firebase.analyticsViewer)
權限名稱 說明
cloudtestservice.environmentcatalog.get 擷取專案支援的測試環境目錄
cloudtestservice.matrices.create 要求根據指定規格執行測試矩陣
cloudtestservice.matrices.get 擷取測試矩陣的狀態
cloudtestservice.matrices.update 更新未完成的測試矩陣
cloudtoolresults.executions.list 擷取歷史記錄的執行作業清單
cloudtoolresults.executions.get 擷取現有的執行作業
cloudtoolresults.executions.create 建立新的執行作業
cloudtoolresults.executions.update 更新現有的執行作業
cloudtoolresults.histories.list 擷取記錄清單
cloudtoolresults.histories.get 擷取現有記錄
cloudtoolresults.histories.create 建立新的記錄
cloudtoolresults.settings.create 建立新的工具結果設定
cloudtoolresults.settings.get 可擷取現有的工具結果設定
cloudtoolresults.settings.update 更新工具結果設定
cloudtoolresults.steps.list 擷取執行作業的步驟清單
cloudtoolresults.steps.get 擷取現有步驟
cloudtoolresults.steps.create 建立新的步驟
cloudtoolresults.steps.update 更新現有的步驟

整合外部服務權限

權限名稱 說明
firebaseextensions.configs.create 為外部服務建立新的擴充功能設定
(Firebase 管理中心 > 專案設定 > 整合)
firebaseextensions.configs.delete 刪除外部服務的現有擴充功能設定
(Firebase 管理中心 > 專案設定 > 整合)
firebaseextensions.configs.list 擷取外部服務的擴充功能設定清單
(Firebase 管理中心 > 專案設定 > 整合)
firebaseextensions.configs.update 更新外部服務的現有擴充功能設定
(Firebase 管理中心 > 專案設定 > 整合)