Firebase için API anahtarlarını kullanma ve yönetme hakkında bilgi

API anahtarı, Firebase ve Google hizmetleriyle etkileşim kurarken istekleri Firebase projenize yönlendirmek için kullanılan benzersiz bir dizedir. Bu sayfada, API anahtarlarıyla ilgili temel bilgiler ve API anahtarlarını Firebase uygulamalarıyla kullanma ve yönetmeyle ilgili en iyi uygulamalar açıklanmaktadır.

Öğrenmeniz gereken en önemli şeyler şunlardır: Firebase için API anahtarları hakkında:

• Firebase ile ilgili API'ler API anahtarlarını yalnızca Firebase projesini veya uygulamasını tanımlamak için kullanın, API'yi çağırmak için yetkilendirme için değil (diğer bazı API'ler gibi) izin ver) seçeneği de sunulur. Firebase ile ilgili API'ler için yetkilendirme işlemi gerçekleşir Google Cloud IAM izinleri aracılığıyla, API anahtarından ayrı olarak Firebase Security Rules veya Firebase App Check. Bu nedenle Firebase API anahtarlarını yalnızca Firebase ile ilgili API'ler.
• Önerilerimiz: uygun kısıtlamaları inceleyip uygulayın ve sınırlar ile tüm API anahtarlarınızı (Firebase API anahtarlarınız dahil) sınırlandırır. Daha açık belirtmek gerekirse, anahtarı yalnızca uygulamanızda gerçekten kullandığınız API'lerle kısıtlayın ve geçerli olduğu durumlarda kotayı sınırlayın. Lütfen tüm Firebase tarafından temel hazırlığı yapılanlar API anahtarlarında "API kısıtlamaları" bulunur varsayılan olarak uygulanır.
• Firebase tarafından sağlanan API anahtarlarınızı yalnızca Firebase ile ilgili API'ler için kullanın. Diğer tüm API'ler (ör. Haritalar için Places API veya Google AI Gemini API) için ayrı bir API anahtarı kullanın.
• Firebase Security Rules'i kullanarak Realtime Database, Cloud Firestore ve Cloud Storage verilerinizin güvenliğini sağlamanızı önemle tavsiye ederiz. API anahtarı kısıtlamalarıyla yetinmeyin.

API anahtarları ve Firebase hakkında genel bilgiler

Firebase API anahtarları, normal API anahtarlarından farklıdır

API anahtarlarının genellikle kullanılmasının aksine, Firebase hizmetleri için API anahtarları Arka uç kaynaklarına erişimi kontrol etmek için kullanılmaz; ancak gerçek zamanlı Firebase Security Rules ile (hangi son kullanıcıların kaynaklara erişebileceğini kontrol etmek için) ve Firebase App Check (hangi uygulamaların kaynaklara erişebileceğini kontrol etmek için).

Genellikle API anahtarlarını titizlikle korumanız gerekir (ör. bir şifreleme hizmeti kullanarak veya anahtarları ortam değişkenleri olarak ayarlayarak). Ancak Firebase hizmetlerinin API anahtarlarını koda veya kontrollü yapılandırma dosyalarına eklemenizde sakınca yoktur.

Firebase hizmetlerinin API anahtarlarını koda eklemek güvenli olsa da bunları inceleyip uygun kısıtlamaları ve sınırları uygulamanız gerekir.

Realtime Database, Cloud Firestore ve Cloud Storage veri: Firebase Security Rules başlıklı makaleyi inceleyin. API anahtarlarınızı yalnızca kısıtlayarak ve/veya gizleyerek korumaya çalışmayın.

API anahtarları oluşturma

Bir Firebase projesinin çok sayıda API anahtarı olabilir ancak her API anahtarı yalnızca tek bir Firebase projesiyle ilişkilendirilebilir.

Aşağıdakilerden herhangi birini yaptığınızda Firebase, projeniz için otomatik olarak API anahtarları oluşturur: takip etmek için:

• Firebase projesi oluşturma > Browser key otomatik olarak oluşturuldu
• Firebase Apple uygulaması oluşturma > iOS key otomatik olarak oluşturuldu
• Firebase Android uygulaması oluşturma > Android key otomatik olarak oluşturuldu

ziyaret edin.

Önemli: Firebase tarafından otomatik olarak oluşturulan API anahtarları varsayılan olarak otomatik bir şekilde oluşturulur istemcinin birlikte bir API anahtarı sağlamasını gerektiren API'lerin listesiyle sınırlıdır daha kolay olur. Firebase hizmetlerinin API anahtarları varsayılan olarak kısıtlanmış mı? başlıklı SSS'ye bakın.

Google Cloud konsolunda da kendi API anahtarlarınızı oluşturabilirsiniz. Örneğin, geliştirme veya hata ayıklama için. Bu özelliğin ne zaman önerilebileceği hakkında daha fazla bilgiyi bu sayfanın ilerleyen bölümlerinde bulabilirsiniz.

API anahtarlarınızı bulma

Projenizin tüm API anahtarlarını Google Cloud konsolundaki API'ler ve Hizmetler > Kimlik bilgileri panelinde görüntüleyebilir ve yönetebilirsiniz.

Hangi API anahtarının otomatik olarak bir Firebase uygulamasıyla eşleştirildiğini aşağıdaki yerlerde de bulabilirsiniz. Varsayılan olarak, projenizin aynı platformdaki (Apple, Android ve web) tüm Firebase uygulamaları aynı API anahtarını kullanır.

• Firebase Apple Apps — Firebase'de otomatik eşleşen API anahtarını bulun GoogleService-Info.plist adlı yapılandırma dosyasını API_KEY alanı için geçerlidir.

• Firebase Android Apps — Otomatik eşleşen API anahtarını google-services.json Firebase yapılandırma dosyasına current_key alanı için geçerlidir.

• Firebase web uygulamaları: Otomatik olarak eşlenen API anahtarını Firebase yapılandırma nesnesinde, apiKey alanında bulun.

Bir API anahtarını kullanma

API anahtarları, etkileşimde bulunurken Firebase projenizi tanımlamak için kullanılır Firebase/Google hizmetleri. Bunlar özellikle API isteklerini ilişkilendirmek için kullanılır projenizle bağdaştırın. Ayrıca herkese açık verilere erişmek için de faydalıdırlar.

Örneğin bir API anahtarını, değerini REST'e geçirerek doğrudan kullanabilirsiniz. Sorgu parametresi olarak API çağrısı. Bu örnekte, Dynamic Links bağlantı kısaltıcı API'ye nasıl istek gönderebileceğiniz gösterilmektedir:

POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key=API_KEY

Uygulamanız, mobil/web istemcisi tarafından sağlanan bir API anahtarı gerektiren bir Firebase API'sine çağrı yaptığında, projenizin API anahtarını otomatik olarak Firebase yapılandırma dosyasında/nesnesinde arar. Ancak, Uygulamanız için ortam da dahil olmak üzere farklı bir mekanizma kullanarak API anahtarları sağlayın değişkenlerine karşılık gelir.

API anahtarlarını inceleyip uygun kısıtlamaları uygulayın (önerilir)

Firebase hizmetleri için API anahtarının gizli olması durumunda, kısıtlamaları ve sınırları bu makalede açıklandığı şekilde inceleyip uygulamanız bölümüne ekleyin.

Üretim uygulamaları tarafından kullanılan API anahtarlarının kısıtlamalarını veya sınırlarını değiştirme konusunda dikkatli olun. Yeni ayarları test uygulaması ve bir test API anahtarı ile Üretim API anahtarınız için kısıtlamaları veya sınırları değiştirme.

Not: Firebase hizmetleri için kullandığınız API anahtarında "API kısıtlamaları" varsa ve API_KEY_SERVICE_BLOCKED veya Forbidden (403) hatası alıyorsanız API anahtarında anahtarın "API kısıtlamaları" izin verilenler listesine dahil edilen tüm API'lerin bulunduğundan emin olun.

Firebase API anahtarlarınız için izin verilenler listesine otomatik olarak eklenen API'leri inceleyin

Firebase, projenizde bir API anahtarı oluşturduğunda bu anahtara otomatik olarak "API kısıtlamaları" ekler. Bu izin verilenler listesine eklenen API'ler, Firebase'le ilgili olan ve istemcinin çağrıyla birlikte bir API anahtarı sağlamasını gerektirir. Firebase hizmetlerinin kullanımı için gereken API'lerin çoğunun, API anahtarlarınızın izin verilenler listesinde olması gerekmediğini unutmayın.

Firebase, tüm Firebase hizmetleri için gerekli API'leri eklediğinden, API anahtarının izin verilenler listesi kullanmadığınız ürünlerin API'lerini içerebilir. İzin verilenler listesinden API'leri kaldırabilirsiniz ancak API'leri kaldırmamaya çok dikkat etmeniz gerekir. Firebase ve kullandığınız Firebase hizmetleri için gereken API'leri kaldırın (bkz. Firebase ile ilgili API'lerin listesi her hizmet / ürünün izin verilenler listesinde olması gerekir. Aksi halde Firebase hizmetleri çağrılırken hata alır.

Not: Firebase, Mayıs 2024'te mevcut ve kısıtlanmamış tüm Firebase tarafından sağlanan API anahtarlarına otomatik olarak API kısıtlamaları uyguladı. SSS bölümünde daha fazla bilgi edinin Firebase hizmetleri için API anahtarları varsayılan olarak kısıtlı mıdır?.

Şifre tabanlı Authentication kullanıyorsanız kotayı daha da daraltın

Hangi kimlik doğrulama seçeneğini kullanırsanız kullanın, Realtime Database, Cloud Firestore ve Cloud Storage cihazınızın güvenliğini sağlayın veri verilerini kullanarak Firebase Security Rules başlıklı makaleyi inceleyin.

Şifre tabanlı Firebase Authentication kullanıyorsanız ve API anahtarınız ele geçirilirse Firebase Security Rules tarafından korunan Firebase projenizin veritabanına veya Cloud Storage verilerine erişemez. Ancak Firebase'in kimlik doğrulama uç noktalarına erişmek ve projenizle ilgili kimlik doğrulama istekleri göndermek için API anahtarınızı kullanabilirler.

Kullanıcıların API anahtarının hatalı şekilde kullanılması ihtimalini azaltmak amacıyla, bir kaba kuvvet saldırısına maruz kalırsanız, şuranın varsayılan kotasını Normal trafiği yansıtacak identitytoolkit.googleapis.com uç nokta beklentilerini karşılayabileceksiniz. Bu kotayı ve uygulamanızı daraltırsanız aniden kullanıcı kazandığında, kotayı yükseltene kadar oturum açma hataları alabilirsiniz. Projenizin API kotalarını şuradan değiştirebilirsiniz: Google Cloud konsolu.

Firebase dışı tüm hizmetler için ayrı, kısıtlanmış API anahtarları kullanın

Firebase hizmetleri için kullanılan API anahtarlarının genellikle ele alınması gerekmese de olarak gizli hale getirmek için, kullandığınız API anahtarlarıyla ilgili bazı ek önlemler diğer Google Cloud API'leriyle yapabilirsiniz.

Firebase hizmeti/ürünü için olmayan bir Google Cloud API'yi (herhangi bir platformda) kullanıyorsanız bu API'lerle kullanmak üzere ayrı ve kısıtlanmış API anahtarları oluşturmanızı önemle tavsiye ederiz. Bu, API faturalandırılabilir bir Google Cloud hizmeti içinse özellikle önemlidir.

Örneğin, iOS'te Firebase ML ve Cloud Vision API'lerini kullanıyorsanız yalnızca Cloud Vision API'lerine erişmek için kullanacağınız ayrı API anahtarları oluşturmanız gerekir.

Firebase dışı API'ler için ayrı, kısıtlanmış API anahtarları kullanarak gerektiğinde anahtarları döndürebilir veya değiştirebilir ve Firebase hizmetlerini kullanmanızı kesintiye uğratmadan API anahtarlarına ek kısıtlamalar ekleyebilirsiniz.

API'ye özel anahtar oluşturma talimatlarını görüntüleyin.

Bu talimatlarda, bir Super Service API adlı sahte API.

1. adım: Mevcut API anahtarlarınızı Super Service API'e erişime izin vermeyecek şekilde yapılandırın

1. Google Cloud konsolunun Kimlik bilgileri sayfasını açın. İstendiğinde projenizi seçin.

2. Listedeki mevcut her API anahtarı için düzenleme görünümünü açın.

3. API kısıtlamaları bölümünde Anahtarı kısıtla'yı seçin, ardından API anahtarının erişmesini istediğiniz tüm API'leri listeye ekleyin. Ayrı bir API anahtarı oluşturduğunuz API'yi (bu örnekte Super Service API) dahil etmediğinizden emin olun.

   Bir API anahtarının API kısıtlamalarını yapılandırdığınızda, anahtarın erişebildiği API'leri açıkça belirtirsiniz. Varsayılan olarak, API kısıtlamaları bölümünde Anahtarı kısıtlama seçili olduğunda, proje için etkinleştirilen herhangi bir API'ye erişmek için API anahtarı kullanılabilir.

Mevcut API anahtarlarınız artık Super Service API uygulamasına erişim izni vermeyecek ancak her bir anahtar, kendi API'nize eklediğiniz API'ler için çalışmaya devam eder API kısıtlamaları listesi.

Önemli: Gelecekte başka API'leri etkinleştirirseniz bunları şuraya eklemeniz gerekir: Geçerli API anahtarının API kısıtlamaları listesini inceleyin.

2. Adım: Super Service API'e erişmek için yeni bir API anahtarı oluşturun ve kullanın

1. Kimlik Bilgileri sayfasına dönün. Firebase projenizin hâlâ seçili olduğundan emin olun.

2. Kimlik bilgileri oluştur > API anahtarı. Yeni API anahtarını not edin, ardından Anahtarı kısıtla'yı tıklayın.

3. API kısıtlamaları bölümünde Anahtarı kısıtla'yı seçin ve Super Service API'yi yalnızca listeye ekleyin.

   Bu yeni API anahtarı yalnızca Super Service API öğesine erişim izni verir.

4. Uygulamanızı ve hizmetlerinizi yeni API anahtarını kullanacak şekilde yapılandırın.

Ortama özel API anahtarları kullan (önerilir)

Farklı ortamlar için farklı Firebase projeleri oluşturursanız (ör. her bir uygulama örneğinin kendi kendini geliştirme ve üretim ortamındaki ilgili Firebase projesi için geçerlidir. Örneğin, hazırlık uygulaması örneğiniz: hiçbir zaman üretim Firebase projenizle konuşmayın. Bu aynı zamanda sizin hazırlık uygulamasının, hazırlık Firebase projenizle ilişkili API anahtarlarını kullanması gerekir.

Geliştirme aşamasından hazırlık aşamasına koda API anahtarları eklemek yerine, bunları en üst düzeye çıkarmak için ortam değişkenlerini veya bunları bir yapılandırma dosyasına dahil etmenizi öneririz.

Firebase ML ile birlikte geliştirme için Firebase Local Emulator Suite kullanıyorsanız yalnızca hata ayıklama amaçlı bir API anahtarı oluşturmanız ve kullanmanız gerektiğini unutmayın. Bu tür bir anahtar oluşturmayla ilgili talimatları Firebase ML belgelerinde bulabilirsiniz.

SSS ve sorun giderme

SSS

API anahtarlarıdır Firebase hizmetleri varsayılan olarak kısıtlanır mı?

Evet, varsayılan olarak Firebase'in otomatik olarak sağladığı tüm API anahtarları, şunlarla birlikte kullanılır: Firebase'le ilgili API'ler "API Kısıtlamaları" otomatik olarak uygulanır. Bu izin verilenler listesinde yer alan Firebase ile ilgili API'lerin listesini inceleyin.

Bu izin verilenler listesine eklenen API'ler, Firebase hizmetleri tarafından Firebase projenizin tanımlanması için API anahtarları gerektirmesi veya uygulamasını indirin. Firebase hizmetlerinin kullanımı için gereken çoğu API'nin aslında API anahtarlarınızın izin verilenler listesinde olması gerekir.

Firebase, tüm Firebase hizmetleri için gerekli API'leri eklediğinden, izin verilenler listesi, kullanmadığınız ürünlerin API'lerini içerebilir. API'leri izin verilenler listesinden kaldırabilirsiniz ancak Firebase ve kullandığınız Firebase hizmetleri için gereken API'leri kaldırmamaya çok dikkat etmeniz gerekir (her hizmet/ürün için izin verilenler listesinde olması gereken Firebase ile ilgili API'lerin listesine bakın). Aksi takdirde, Firebase hizmetlerini çağırırken hata alırsınız.

Önemli: Firebase ile ilgili API'lerin hiçbiri yetkilendirme olarak API anahtarı kullanmaz . API çağrısıyla iletilen API anahtarı yalnızca şunun için kullanılır: Firebase projesinin veya uygulamasının tanımlanması.

Tüm API anahtarlarınızı ve bunların "API kısıtlamalarını" Google Cloud konsolundaki API'ler ve Hizmetler > Kimlik bilgileri panelinde görüntüleyebilirsiniz.

Firebase'in bu "API kısıtlamalarını" nasıl uyguladığıyla ilgili aşağıdakileri unutmayın:

• Mayıs 2024'ten itibaren Firebase tarafından otomatik olarak temel hazırlığı yapılan tüm yeni API anahtarları, Firebase ile ilgili API'lerin listesiyle otomatik olarak kısıtlanır.

• Mayıs 2024'te, Firebase'in daha önce otomatik olarak sağladığı tüm mevcut ve sınırsız API anahtarları, Firebase ile ilgili API'lerin listesi ve projenin etkin API'lerinden herhangi biri ile sınırlandırılacak.

• Firebase'in daha önce otomatik olarak temel hazırlığı yaptığı mevcut ve kısıtlanmış API anahtarları değiştirilmedi.

• Firebase tarafından otomatik olarak sağlanmamış mevcut API anahtarları sağlanmamıştır değiştirildi.

Önemli: Firebase hizmeti/ürününe ait olmayan bir Google Cloud API'si (herhangi bir platformda) kullanıyorsanız bu API'lerle kullanmak için ayrı, kısıtlanmış API anahtarları oluşturmanızı önemle tavsiye ederiz.

Hangi API anahtarını nasıl belirleyebilirim? Firebase uygulamamla ilişkilendirilir mi?

Firebase uygulamanızla ilişkili API anahtarını belirlemek için aşağıdaki seçeneklerden herhangi birini kullanabilirsiniz:

Firebase konsol

1. adlı yayıncıya git Proje ayarları, ve ardından Uygulamalarınız kartına ilerleyin.

2. İlgili uygulamayı seçin.

3. İstediğiniz uygulamanın Firebase yapılandırma dosyasını/nesnesini edinin, ardından API anahtarını bulun:

   • Apple: GoogleService-Info.plist uygulamasını indirin ve ardından API_KEY alanı

   • Android: google-services.json uygulamasını indirin, istediğiniz uygulamayı (paket adını arayın) ve ardından current_key alanı

   • Web: Yapılandırma seçeneğini belirleyin ve ardından apiKey alanını bulun.

Firebase CLI

1. Aşağıdaki komutu çalıştırarak ilgilendiğiniz uygulamanın Firebase yapılandırma dosyasını/nesnesini edinin:

   firebase apps:sdkconfig PLATFORM FIREBASE_APP_ID

   • PLATFORM (şunlardan biri): IOS | ANDROID | WEB
   • FIREBASE_APP_ID: Firebase uygulamanız için Firebase tarafından atanan benzersiz tanımlayıcı (uygulama kimliğinizi bulma)

2. Uygulamanın basılı Firebase yapılandırmasında API anahtarını bulun:

   • Apple: API_KEY alanını bulun

   • Android: İlgili uygulamanın yapılandırmasını (paket adını arayın) ve ardından current_key alanını bulun

   • Web: apiKey alanını bulun

REST API

1. Şu kodu çağırarak API anahtarının apiKeyId'sini (UID) edinin: uç noktayı koyabilir ve ardından apiKeyId değeri sonraki adıma eklendi.

   • Apple: projects.iosApps.get numaralı telefonu ara
   • Android: projects.androidApps.get numaralı telefonu arayın
   • Web: projects.webApps.get numaralı telefonu arayın

2. projects.locations.keys.getKeyString işlevini çağırarak API anahtarı dizesini alın.

   Bu keyString, Uygulamanın yapılandırma yapısı (Elma | Android | Web).

Firebase yapılandırma dosyamda/nesnemde aynı Firebase uygulaması için iki API anahtarı listeleyebilir miyim?

• Firebase Apple Apps: Her uygulamanın kendi yapılandırma dosyası vardır ve yalnızca listelenen bir API anahtarı var.

• Firebase Android Uygulamaları: Firebase projesindeki tüm Android uygulamaları aynı yapılandırma dosyasında listelenmeli ve her uygulamanın yalnızca bir API anahtarı olabilir listelendi. Ancak bu yapılandırma dosyasındaki her uygulamanın listelenen farklı bir anahtarı olabilir.

• Firebase Web Uygulamaları: Her uygulamanın kendi yapılandırma nesnesi vardır ve yalnızca listelenen bir API anahtarı var.

Bununla birlikte, bir uygulamayla birden çok API anahtarı kullanabilirsiniz. Uygulamanızın bu diğer API anahtarlarına erişmesi için bir mekanizma (ör. ortam değişkeni) sağlamanız gerekir. Diğer API anahtarlarına erişim mekanizması bu anahtarlara bağlı olamaz Firebase yapılandırma dosyanızda/nesnenizde listelenen API anahtarları.

Firebase'in Bir uygulamayla hangi API anahtarının eşleştirileceğini bilmek (Firebase yapılandırmasında olduğu gibi) dosyası/nesne) olabilir mi?

Uygulamanızın Firebase yapılandırmasını ilk kez aldığınızda dosya/nesne dosyası oluşturun. Firebase, projenizde Search Console'a yönelik olarak "Uygulama Kısıtlamaları" (örneğin, Apple uygulaması için eşleşen paket kimliği).

Firebase eşleşen herhangi bir kısıtlanmış anahtar bulamazsa Apple uygulamaları için iOS key, Android key için yapılandırma dosyası/nesne Android uygulamaları ve web uygulamaları için Browser key (bu anahtarların mevcut olduğu varsayılır) ve "Uygulama Kısıtlamaları" bulunmamalıdır. eşleşmelerini önleyen uygulamasında).

Manuel olarak API anahtarı ve alanı, Firebase yapılandırma dosyamdan/nesnemden silinsin mi?

Evet, API anahtarınızı yapılandırma dosyanızdan/nesnenizden manuel olarak silebilirsiniz. Ancak, Uygulamanızın bir API anahtarına erişmesi için başka bir mekanizma sağlamanız gerekir (bir ortam değişkeni aracılığıyla) Aksi halde, Firebase hizmetlerine yapılan tüm çağrılar başarısız olur.

Firebase yapılandırma dosyamı/nesnemi farklı API anahtarlarıyla manuel olarak düzenleyebilir miyim?

Evet, farklı bir API anahtarı ilişkilendirmek için bir yapılandırma dosyasını/nesneyi manuel olarak düzenleyebilirsiniz bir uygulamadır.

Firebase yapılandırma dosyanızdaki/nesnesindeki API anahtarını manuel olarak düzenlemek mümkündür ancak genellikle önerilmez. Bu, Firebase hizmetlerine erişmeyle ilgili sorun yaşama olasılığını artırır. Ancak, yapılandırma dosyanızı/nesnenizi düzenlemeyi seçerseniz aşağıdakileri yapın:

• API anahtarının, şurada listelenen Proje Kimliği kapsamına alındığından emin olun: yapılandırma dosyası/nesne.
• Herhangi bir API'yi engelleyecek "API Anahtarı Kısıtlamaları" o uygulamayla kullanılmasını önler.
• API anahtarında uygun "API kısıtlamaları" bulunduğundan emin olun uyguladı. Her Firebase hizmeti/ürünü için izin verilenler listesinde olması gereken Firebase ile ilgili API'lerin listesine bakın.

uygulamanızın yapılandırma dosyasını/nesnesini yeniden alma her zaman bu listedeki tüm API anahtarlarını Firebase otomatik olarak bu uygulamayla eşleşir. Dolayısıyla, manuel düzenlemelerinizi gerektiği gibi tekrarlamanız gerekir.

CANNOT TRANSLATE Bir Firebase projesinden diğerine API anahtarı kullanmalı mıyım?

Hayır, API anahtarları yalnızca belirli bir projeyi tanımlar ve başka bir projeye taşınamaz.

Şu durumda ne olur? Google Cloud konsolunda listelenen bir API anahtarı silinsin mi?

Bir uygulama tarafından kullanılan bir API anahtarını silerseniz söz konusu uygulamadan API çağırır başarısız olur. Kullanmaya çalıştığınız raporlar, e-postalar veya hatalar alabilirsiniz geçersiz bir API anahtarı.

API anahtarı silme kalıcı bir işlemdir ve geri alınamaz.

Firebase API anahtarının "API kısıtlamaları" izin verilenler listesinde hangi API'lerin bulunması gerekir?

Firebase API anahtarı için anahtarın üzerinde olması gereken tek API "API kısıtlamaları" izin verilenler listesi, istemcinin izin verilenler listesine eklemesi gereken Çağrıyla birlikte API anahtarı. Firebase'le ilgili çok az sayıda API'de bu özelliğe sahip olduğunu unutmayın. gerekir. Projenizde etkinleştirilen Firebase ile ilgili API'lerin çoğunun, anahtarın "API kısıtlamaları" izin verilenler listesinde olması gerekmez.

Önemli: Firebase ile ilgili API'lerin hiçbiri yetkilendirme olarak API anahtarı kullanmaz . API çağrısıyla iletilen API anahtarı yalnızca şunun için kullanılır: Firebase projesinin veya uygulamasının tanımlanması.

Bir Firebase API anahtarının "API kısıtlamaları" izin verilenler listesine hangi Firebase API'lerinin dahil edilmesi gerektiğini belirlemek için aşağıdaki tabloyu kullanın. Firebase API anahtarlarının yalnızca Firebase hizmetleri için kullanılabileceğini unutmayın. Daha fazla bilgi: oluşturuluyor Belirli API türleri için ayrı, kısıtlanmış API anahtarları.

Projenizin API anahtarlarını Google Cloud konsolundaki API'ler ve Hizmetler > Kimlik bilgileri panelinde görüntüleyebilir ve yönetebilirsiniz.

Not: Firebase ile ilgili bir API'yi çağırmaya çalışırken API_KEY_SERVICE_BLOCKED veya Forbidden 403 hatası alıyorsanız ve kullandığınız API anahtarında bu tabloda listelenen tüm gerekli API'ler varsa Firebase Destek Ekibi ile iletişime geçin.

API adı (hizmet adı)	API görünen adı	İlişkili Firebase hizmeti/ürünü
firebase.googleapis.com	Firebase Management API	tüm ürünler
logging.googleapis.com	Cloud Logging API'sı	tüm ürünler
firebaseinstallations.googleapis.com	Firebase Yüklemeler API'sı	Cloud Messaging, Crashlytics, In-App Messaging, Performance Monitoring, Remote Config, Firebase ML
firebaseappcheck.googleapis.com	Firebase Uygulama Kontrolü API'si	App Check
firebaseappdistribution.googleapis.com	Firebase App Distribution API'si	App Distribution
firebaseapptesters.googleapis.com	Firebase App Testers API'si	App Distribution
identitytoolkit.googleapis.com	Identity Toolkit API	Authentication
securetoken.googleapis.com	Jeton Hizmeti API'si	Authentication
firebaserules.googleapis.com *	Firebase Kuralları API'si	Cloud Firestore, Cloud Storage, Realtime Database
datastore.googleapis.com	Cloud Datastore API	Cloud Firestore
firestore.googleapis.com	Google Cloud Firestore API	Cloud Firestore
fcmregistrations.googleapis.com	FCM Registration API	Cloud Messaging
firebasestorage.googleapis.com	Cloud Storage for Firebase API	Cloud Storage
firebasedynamiclinks.googleapis.com	Firebase Dynamic Links API'sı	Dynamic Links
firebasehosting.googleapis.com *	Firebase Hosting API	Hosting
firebaseinappmessaging.googleapis.com	Firebase In-App Messaging API'si	In-App Messaging
firebaseml.googleapis.com	Firebase ML API	Firebase ML
mlkit.googleapis.com **	ML Kit API'sı	Firebase ML
mobilecrashreporting.googleapis.com	Mobile Crash Reporting API	Performance Monitoring
play.googleapis.com	Google Play Android Geliştirici API'sı	Performance Monitoring
firebaseremoteconfig.googleapis.com	Firebase Remote Config API'sı	Performance Monitoring, Remote Config
firebaseremoteconfigrealtime.googleapis.com	Firebase Remote Config Realtime API	Performance Monitoring, Remote Config
cloudconfig.googleapis.com **	Yok	Remote Config
firebasedatabase.googleapis.com *	Firebase Realtime Database API	Realtime Database
firebasevertexai.googleapis.com	Firebase API'de Vertex AI	Vertex AI in Firebase

^{* Yalnızca Firebase API anahtarını üçüncü taraf araçlarıyla veya Firebase hizmetine/ürüne doğrudan REST erişimi ile kullanıyorsanız gereklidir.}

^{** Ürün SDK'sının önceki sürümleri için gereklidir. Şunu kullanıyorsanız: SDK'nın en son sürümünü kullanıyorsanız, API'nin anahtarın izin verilenler listesine ekleyin.}

Sorun giderme

Nasıl yaparım? şöyle bir API_KEY_SERVICE_BLOCKED veya Yasak 403 hatasını düzelt: bu API'ye yapılan istekler engelleniyor mu?

API_KEY_SERVICE_BLOCKEDhatası veya aşağıdakine benzeyen bir hata alıyorsanız bu SSS'deki talimatları uygulayın:

Forbidden: 403 POST https://example-service.googleapis.com/method: Requests to this API example-service.googleapis.com method google.example-service.rest.method are blocked.

Uygulamanızın API'yi çağırmak için kullandığı API anahtarında muhtemelen "API Kısıtlamaları" ve anahtarın izin verilenler listesi bu API'yi içermiyor.

• Firebase ile ilgili bir hizmeti/ürünü kullanmaya çalışırken bu hatayı alıyorsanız kullandığınız API anahtarının "API kısıtlamaları" izin verilenler listesine dahil edilen tüm gerekli API'leri içerdiğinden emin olun.

• Firebase dışı bir hizmeti kullanmaya çalışırken bu hatayı alıyorsanız bu hizmet için özel olarak yeni bir API anahtarı oluşturmanızı ve API'ye gidin. Firebase API anahtarları yalnızca Firebase hizmetleri/ürünleri için kullanılmalıdır. Belirli API türleri için ayrı, kısıtlanmış API anahtarları oluşturma hakkında daha fazla bilgi edinin.

Nasıl yaparım? bu hata düzeltilsin mi? "Bu Firebase uygulamasının ölçüm kimliği sunucudan getirilemedi."

Web uygulamanız tarafından kullanılan API anahtarına muhtemelen "API Kısıtlamaları" uygulanmıştır. Bu durumda, Firebase Management API'nin izin verilen API'ler listesinde olduğundan emin olun.

API anahtarım geçersiz. Ne oldu ve bu sorunu nasıl düzeltebilirim?

Geçersiz API anahtarlarının en yaygın nedenlerinden bazıları şunlardır:

• API anahtarında "API Anahtarı Kısıtlamaları" anahtarı kullanmaya çalışan uygulamayla eşleştirilemez hale getiren ("Uygulama Kısıtlamaları") ya da çağrılan API için kullanılamaz ("API") Kısıtlamalar").

• API anahtarı, Google Cloud konsolundaki projeden silindi.

• Uygulamanın Firebase yapılandırma dosyası/nesnesi.

Bu sorunu düzeltmenin bir yolu, uygulamanızın Firebase yapılandırma dosyasının/nesnesinin güncel sürümünü edinmek ve ardından eski yapılandırma dosyanızı/nesnenizi güncellenmiş yeni dosyayla/nesneyle değiştirmektir. Firebase, indirilmek üzere bir yapılandırma dosyası göndermeden veya konsolda bir yapılandırma nesnesi göstermeden önce, listelenen API anahtarlarının uygulamalarla eşleşip eşleşmediğini kontrol eder.