Firebase SDK'larını web uygulamanızla entegre etme

Firebase App Hosting, Firebase JavaScript SDK'sı ve Node.js için Firebase Admin SDK ile oluşturulan dinamik web uygulamaları için idealdir. Tam özellikli bir web uygulamasında, Authentication, Cloud Firestore ve App Check gibi Firebase SDK'larının önemli rolleri vardır. Bu kılavuzda, Firebase SDK'larını optimize etmenize ve Firebase App Hosting üzerinde web uygulamanıza Firebase oluşturmaya başlamanıza yardımcı olacak bazı temel stratejiler açıklanmaktadır.

Firebase Admin SDK ve web SDK'larını otomatik olarak başlatma

Firebase App Hosting gibi Google ortamları, derleme ve çalışma zamanında bağımsız değişken içermeyen bir kurucu çağrısı aracılığıyla basitleştirilmiş uygulama başlatma olanağı sunar. Bu, hem Node.js için Firebase Admin SDK'ın (Firebase işlevlerinin büyük bir kısmını kullanıma sunan ve web uygulamanızda çok yararlı olabilecek sunucu tarafı SDK'sı) hem de Firebase JavaScript SDK'sının bir özelliğidir.

initializeApp() ile Firebase App Hosting'ın web uygulaması yapılandırmasını sizin için otomatik olarak doldurmasına izin verebilir, varsayılan değerleri geçersiz kılmak isterseniz belirli değerler üzerinde ayrıntılı kontrol seçeneğini kullanmaya devam edebilirsiniz.

Bağımsız değişken olmadan başlatma

Firebase Admin SDK veya Firebase JavaScript SDK'sını varsayılan yapılandırma değerleriyle ilk kullanıma hazırlamak için herhangi bir bağımsız değişken sağlamadan initializeApp() yöntemini kullanın.

Admin SDK

import { initializeApp } from 'firebase-admin/app';
const app = initializeApp();

Admin SDK için bu başlatma stratejisi, App Hosting ve Cloud Run, App Engine ve Cloud Run işlevleri dahil olmak üzere diğer Google sunucu ortamlarında çalışır.

JavaScript SDK

import { initializeApp } from 'firebase/app';
const app = initializeApp();

JavaScript SDK'sı için bu başlatma stratejisi App Hosting sürümünde çalışır.

Otomatik olarak doldurulan değerleri geçersiz kılma

Otomatik olarak eklenen varsayılan yapılandırmayı geçersiz kılabilirsiniz. Bu seçeneklerin Admin SDK ve JavaScript SDK'sı arasında farklılık gösterdiğini unutmayın.

Admin SDK geçersiz kılma kuralı

Realtime Database, Cloud Storage veya Cloud Functions gibi hizmetler için isteğe bağlı olarak özel başlatma seçenekleri belirtmek istiyorsanız FIREBASE_CONFIG ortam değişkenini kullanın. FIREBASE_CONFIG değişkeninin içeriği { karakteriyle başlıyorsa JSON nesnesi olarak ayrıştırılır. Aksi takdirde SDK, dizeyi seçenekleri içeren bir JSON dosyasının yolu olarak kabul eder.

# apphosting.yaml

env:
  - variable: FIREBASE_CONFIG
    value: '{"databaseURL":"https://project-id-default-rtdb.firebaseio.com","projectId":"my-project-id"}'

JavaScript SDK'sını geçersiz kılma

App Hosting tarafından JavaScript SDK'sını başlatmak için eklenen varsayılan FIREBASE_WEBAPP_CONFIG değerlerini geçersiz kılmak istiyorsanız apphosting.yaml içinde değerler belirtebilirsiniz:

# apphosting.yaml

env:
  - variable: FIREBASE_WEBAPP_CONFIG
    value: '{"apiKey":"myApiKey","appId":"app:123","authDomain":"project-id.firebaseapp.com","databaseURL":"https://project-id-default-rtdb.firebaseio.com","messagingSenderId":"0123456789","projectId":"project-id","storageBucket":"project-id.firebasestorage.app"}'

Otomatik başlatmayı diğer ortamlarda kullanma

Firebase JavaScript SDK'sını yüklediğinizde otomatik başlatma, bir npm postinstall komut dosyası ile ayarlanır. postinstall komut dosyası, App Hosting Cloud Build derleme ortamında otomatik olarak ayarlanan FIREBASE_WEBAPP_CONFIG ortam değişkenini arar.

JS SDK'yı Cloud Build dışında yüklüyorsanız Firebase JavaScript SDK'yı yüklerken bu ortam değişkenini kendiniz ayarlamanız gerekir.

Yükleme sırasında ortamı manuel olarak ayarlamak için:

  1. Firebase konsolundan Firebase web uygulaması yapılandırma nesnenizi kopyalayın.

  2. npm install komutunu çalıştırmadan önce bir terminalden FIREBASE_WEBAPP_CONFIG ortam değişkenini ayarlayın.

FIREBASE_WEBAPP_CONFIG="{...}" npm install firebase

Firebase projenizi veya web uygulamanızı her değiştirdiğinizde bu komutu yeniden çalıştırın. Ara önbelleklerin de (.next/cache gibi) temizlenmesi gerekebilir.

FirebaseServerApp, SSR için kullanılmalıdır.

Web uygulamanızı geliştirirken Firebase JS SDK'sı veya diğer Firebase istemci SDK'larıyla çalıştıysanız FirebaseApp arayüzüne ve bu arayüzü kullanarak uygulama örneklerini nasıl yapılandıracağınıza muhtemelen aşinasınızdır. Firebase, sunucu tarafında benzer işlemleri kolaylaştırmak için FirebaseServerApp sunar.

FirebaseServerApp, sunucu tarafı oluşturma (SSR) ortamlarında kullanılmak üzere FirebaseApp'nin bir varyantıdır. İstemci taraflı oluşturma (CSR) ve sunucu taraflı oluşturma (SSR) arasındaki ayrımı kapsayan Firebase oturumlarını devam ettirmek için araçlar içerir.

FirebaseServerApp ile yapabilecekleriniz:

  • Tam yönetim haklarına sahip Firebase Admin SDK yerine kullanıcı bağlamında sunucu tarafı kodunu yürütme.
  • SSR ortamlarında App Check kullanımını etkinleştirin.
  • İstemcide oluşturulan bir Firebase Auth oturumunu devam ettirme

FirebaseServerApp hizmetini bu amaçlarla kullanma hakkında ayrıntılı bilgi için SSR ile dinamik web uygulamalarında Firebase'i kullanma başlıklı makaleyi inceleyin.

Web uygulamanızda App Check özelliğini etkinleştirme

App Hosting üzerinde dinamik web uygulamanızın güvenliğini artırmak için App Check kullanabilirsiniz. SSR ile dinamik web uygulamalarında Firebase'i kullanma bölümünde açıklanan sunucu tarafı stratejilerinden bazılarını uygulayarak App Hosting arka uçlarınızı kötüye kullanıma karşı koruyabilirsiniz.