Firebase IAM 權限

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

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

所需權限

Firebase IAM 包含下列權限：

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

所有角色都具備必要權限

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

每個 Firebase 預先定義的角色都會自動包含這些權限。

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

執行 Firebase 服務特定動作所需的權限

您必須具備下表列出的權限，才能執行某些 Firebase 服務專屬動作。

如有需要，每個 Firebase 預先定義的角色都會自動包含這些權限。

動作 必要權限
存取 Firebase 專案與協作工具 (包括 Slack、Jira 和 PagerDuty) 的整合功能 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 AI Logic權限

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

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 更新專案的服務強制執行設定
firebaseappcheck.tokens.mint 為應用程式鑄造 App Check 代幣。

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權限

權限名稱 說明
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 傳送通知和資料訊息
cloudmessaging.topicSubscriptions.create 為 FCM 註冊建立主題訂閱項目
cloudmessaging.topicSubscriptions.delete 刪除 FCM 註冊的主題訂閱項目
cloudmessaging.topicSubscriptions.get 擷取 FCM 註冊的主題訂閱詳細資料
cloudmessaging.topicSubscriptions.list 擷取 FCM 註冊的主題訂閱項目清單
cloudmessaging.topicSubscriptions.update 更新 FCM 註冊的主題訂閱項目
權限名稱 說明
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 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 bucket，因此需要特定權限設定，而標準 Firebase 預先定義的角色並未包含所有這些權限。如要授予 Test Lab 的存取權，請使用下列其中一種方法：

  • 從 Firebase 控制台啟動的測試

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

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

      • 如要允許成員使用 Test Lab 執行測試，請指派專案編輯者或以上權限。
      • 如要允許成員在 Test Lab 中查看測試結果，請指派專案檢視者或以上權限。

  • 使用自己的 Cloud Storage bucket，透過 gcloud CLI、 Testing API 或 Gradle 管理的裝置啟動測試

    • 使用 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 控制台 > 專案設定 > 整合)

已淘汰或不支援的產品

權限名稱 說明
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 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 更新現有模型版本