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

API anahtarı, istekleri Firebase'e yönlendirmek için kullanılan benzersiz bir dizedir. projenize dahil etmeniz gerekir. Bu sayfada aşağıdakiler açıklanmaktadır: API anahtarları hakkında temel bilgilerin yanı sıra Firebase uygulamalarıyla API anahtarlarını yönetme.

API anahtarları ve Firebase hakkında genel bilgiler

Firebase için API anahtarları tipik 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 Güvenlik Kuralları'nı kullanarak (hangi son kullanıcıların kaynaklara erişebileceğini kontrol etmek için) ve Firebase Uygulama Kontrolü (kaynaklara hangi uygulamaların erişebileceğini kontrol etmek için).

Genellikle API anahtarlarını aceleyle korumanız gerekir (örneğin, Apps Kasası hizmeti kullanmanız veya anahtarları ortam değişkenleri olarak ayarlamanız gerekir. ancak, Firebase hizmetleri için API anahtarları koda veya giriş yapılan yapılandırmaya eklenebilir dosyası olarak da kaydedebilir.

Firebase hizmetlerine yönelik API anahtarlarını koda eklemek güvenli olsa da, bunlar için uygun kısıtlamaları ve sınırlamaları inceleyip uygulayın.

API anahtarları oluşturma

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

Firebase uygulamalarınız için Firebase tarafından otomatik olarak oluşturulan API anahtarları

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şturun > Browser key otomatik oluşturuldu
  • Firebase Apple Uygulaması oluşturun > iOS key otomatik oluşturuldu
  • Firebase Android uygulaması oluşturun > Android key otomatik oluşturuldu
ziyaret edin.

Ayrıca, Google Cloud konsolunuza örneğin geliştirme veya hata ayıklama için kullanılabilir. Daha fazla bilgi: bu sayfanın ilerleyen bölümlerinde önerilebilir.

API anahtarlarınızı bulma

Projenizin tüm API anahtarlarını şurada görüntüleyebilir ve yönetebilirsiniz: API'ler ve Hizmetler > Kimlik bilgileri Google Cloud Console'da görebilirsiniz.

Ayrıca, hangi API anahtarının otomatik olarak bir Firebase Uygulaması'nı tıklayın. Ölçüt varsayılan olarak, projenizin tüm Firebase Uygulamaları aynı platform için (Apple veya Android - Web) 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ı — Firebase'de otomatik eşleşen API anahtarını bulun apiKey alanına config nesnesini ekleyin.

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. Bu ekranlar, belirli bir kitleye erişmek için herkese açık veriler.

Örneğin bir API anahtarını, değerini REST'e geçirerek doğrudan kullanabilirsiniz. Sorgu parametresi olarak API çağrısı. Bu örnekte, nasıl talep edebileceğiniz gösterilmektedir değerini Dynamic Links link shorter API'si:

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

Uygulamanız, API anahtarı sağlanması gereken bir Firebase API'ye çağrı yaptığında kullanırsanız uygulamanız otomatik olarak Projenizin API anahtarı için Firebase yapılandırma dosyası/nesnesi. 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ı inceleyin ve anahtarlara 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 bakın.

ziyaret edin.

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

Firebase, projenizde bir API anahtarı oluşturduğunda, "API kısıtlamaları" anahtara ekleyin. Bu izin verilenler listesine eklenen API'ler, Firebase'le ilgili olan ve istemcinin çağrıyla birlikte bir API anahtarı sağlamasını gerektirir. Çoğunun Firebase hizmetlerinin kullanımı için gereken API'lerin aslında izin verilenler listesine ekleyin.

Firebase, tüm Firebase hizmetleri için gerekli API'leri eklediğinden, 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.

Şifre tabanlı kimlik doğrulama kullanıyorsanız kotayı daraltın

Şifre tabanlı Firebase Authentication kullanıyorsanız ve birisi API'nizi ele geçirirse anahtarı yoksa Firebase projenizin hiçbir veritabanına erişemez veya Cloud Storage verilerini (bu veriler Firebase Güvenlik Kuralları. Ancak şuna erişmek için API anahtarınızı kullanabilirler: Firebase kimlik doğrulama uç noktaları ve kimlik doğrulama isteklerinde bulunma akılda kalıcı bir yolunu sunar.

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 konsolunuza giriş yapın.

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 Google Cloud API'leriyle birleştirin.

Firebase'e yönelik olmayan bir Google Cloud API (herhangi bir platformda) kullanıyorsanız hizmet / ürün için ayrı, kısıtlanmış API anahtarları oluşturmanızı önemle öneririz bu API'lerle kullanılabilir. Bu, özellikle API'nin yalnızca faturalandırılabilir Google Cloud hizmeti.

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

Firebase dışı API'ler için ayrı ve kısıtlanmış API anahtarları kullanarak, gerektiğinde anahtarları değiştirmeli ve API'ye ek kısıtlamalar eklemelidir anahtarlar ve Firebase'i kullanmaya devam edebilirsiniz.

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.

Geliştirme için Firebase Local Emulator Suite kullanıyorsanız yalnızca hata ayıklamaya yönelik bir API anahtarı oluşturup kullanmanız gerekir. Talimatlar oluşturmak için bu anahtarların kullanılabilir. Firebase ML belgeleri.

SSS ve sorun giderme

SSS

Sorun giderme