İstekleri yalnızca kimliği doğrulanmış kullanıcılarla kısıtlama

Firebase projeniz için kimliği doğrulanmış kullanıcılar modunu zorunlu kılabilirsiniz. Zorunlu kılındığında, Firebase AI Logic üzerinden gönderilen tüm Gemini API isteklerinin uygulamanızın kimliği doğrulanmış kullanıcılarından gelmesi gerekir. Özellikle, uygulamanızın son kullanıcısının uygulamanızdan Firebase AI Logic hizmetine istek göndermeden önce Firebase Authentication kullanılarak kimliğinin doğrulanması gerekir. Son kullanıcının kimliği doğrulanmamışsa istek engellenir.

Bir istek engellendiğinde yanıt olarak 401: unauthenticated hatası döndürülür.

Dikkat edilecek önemli noktalar

Kimliği doğrulanmış kullanıcılar moduyla ilgili aşağıdaki önemli noktaları göz önünde bulundurun.

Kimliği doğrulanmış kullanıcılar modu zorunlu kılındığında

Kimliği doğrulanmış kullanıcılar modu zorunlu kılındığında aşağıdakileri göz önünde bulundurun:

• Bu ayar, Firebase AI Logic için proje genelinde geçerli olan bir ayardır.

  • Projede kayıtlı tüm uygulamalar için geçerlidir.
  • Yalnızca uygulandığı proje için geçerlidir.

• Bu ayar, Firebase AI Logic üzerinden Firebase Authentication kimlik bilgilerini göndermeyen tüm istekleri engeller.

  • Kullanıcının, isteği Firebase AI Logic adresine göndermeden önce Firebase Authentication üzerinden kimlik doğrulaması yapması gerekir.
  • Bu ayar, Firebase AI Logic üzerinden hem Gemini Developer API hem de Agent Platform Gemini API (formerly Vertex AI) için gönderilen tüm isteklerde geçerlidir.
  • Bu ayar, sunucu istem şablonlarını kullanan tüm istekler için geçerlidir.
  • Bu ayar kullanıcı, API veya şablon bazında uygulanamaz.

• Bu ayar, projenizde Firebase AI Logic üzerinden yapılmayan Gemini API isteklerini engellemez.

• Karma/cihaz üzerinde kullanıyorsanız:

  • Bu ayar, kullanıcının kimliği doğrulanmamışsa bulutta barındırılan modele yönelik istekleri engeller.
  • Bu ayar, kullanıcının kimlik doğrulama durumundan bağımsız olarak cihaz üzerinde modele yönelik istekleri engellemez.

• Gemini Live API kullanıyorsanız:

  • Bu ayar, Firebase AI Logic kullanılırken web uygulamaları için Gemini Live API'nin kullanımını engeller (kimliği doğrulanmış kullanıcılar için bile). Firebase JS SDK'sını kullanan web uygulamaları veya Flutter web uygulamaları da buna dahildir.

• Firebase AI Logic REST API'yi kullanıyorsanız:

  • Bu ayar, Firebase Authentication kimlik bilgilerini göndermeyen çıkarım isteklerini engeller. templateGenerateContent veya templateStreamGenerateContent gibi sunucu istem şablonu istekleri de buna dahildir.
  • Bu ayar, IAM tarafından korundukları için kontrol düzlemi isteklerini (şablonları ve yapılandırmaları yönetme istekleri gibi) engellemez.

• Bu ayar, countTokens (Count Tokens API) isteklerini engellemez.

Kimliği doğrulanmış kullanıcılar modunu zorunlu kılmadan önce

Kimliği doğrulanmış kullanıcılar modunu zorunlu kılmadan önce aşağıdakilere dikkat edin:

• Uygulamanızın Firebase Authentication kullanmayan mevcut sürümleri varsa:

  • Bu ayar, mevcut uygulama sürümlerinden Firebase AI Logic aracılığıyla gelen istekleri engeller.
  • Kimliği doğrulanmış kullanıcılar modunu zorunlu kılmadan önce tüm etkin istemcilerin Firebase Authentication kullanacak şekilde güncellendiğinden emin olun.

• Eski Flutter eklentisi sürümleri, isteklerle birlikte Firebase Authentication kimlik bilgilerini göndermek için özel örneklendirme gerektirir.

  • Uygulamanız Flutter eklentisi firebase_ai v3.11.0 veya daha eski bir sürümü (BoM v4.12.0 veya daha eski bir sürüm) kullanıyorsa ve örneklendirme sırasında Authentication değerini iletmiyorsa bu ayar, kimliği doğrulanmış kullanıcılar için bile Firebase AI Logic üzerinden gelen istekleri engeller.
  • Kimliği doğrulanmış kullanıcılar modunu zorunlu kılmadan önce Flutter için tüm etkin istemcilerin eklentinin daha yeni bir sürümüne güncellendiğinden emin olun.

// ...

final ai = await FirebaseAI.googleAI(
  auth: FirebaseAuth.instance, // for Flutter, pass in Authentication explicitly
);

// ...

Firebase Authentication ayarlarını yapın

Firebase Authentication belgelerinde, desteklenen kimlik doğrulama sağlayıcıları için açıklamalar ve uygulama talimatları yer alır. Şifreler, telefon numaraları, popüler birleşik kimlik sağlayıcılar (ör. Google, Facebook ve GitHub) ve daha fazlası bu kapsamdadır.

Uygulamanızda Firebase Authentication uygulandıktan sonra uygulamanız, kimliği doğrulanmış kullanıcının Firebase Authentication kimlik bilgilerini her Firebase AI Logic isteğinde otomatik olarak gönderir.

Kimlik doğrulama sağlayıcılarından bazıları hakkında aşağıdakilere dikkat edin:

• Özel kimlik doğrulama: Firebase AI Logic adresine gönderilecek istekle birlikte gönderilecek imzalı bir kimlik doğrulama jetonu almanız gerekir. Ayrıntılar için Özel Kimlik Doğrulama başlıklı makaleyi inceleyin.

• Anonim veya E-posta/Şifre kimlik doğrulama yöntemleri: Bu kullanıcılar kimliği doğrulanmış kullanıcılar olarak kabul edilir. Bu nedenle, Firebase AI Logic istekleri engellenmez.

  Anonim ve e-posta/şifre kimlik doğrulama yöntemleri, kullanıcıların Firebase Authentication kimlik bilgileri oluşturmak için uygulamanızı ziyaret etmesini gerektirse de, güçlü kimlik doğrulama biçimleri değildir (özellikle ücretli bir kaynağı korumak için). Çünkü varsayılan olarak kullanıcıdan kimlik doğrulaması istemezler. Uygulamanız bu kimlik doğrulama yöntemlerinin varsayılan uygulamasını kullanıyorsa kimliği doğrulanmış kullanıcılar modunu zorunlu kılsanız bile daha az koruma sağlanabilir. Firebase App Check politikasını da zorunlu kıldığınızdan emin olun.

Kimliği doğrulanmış kullanıcılar modu ayarını yönetme

Kimliği doğrulanmış kullanıcılar modu ayarını Firebase konsolunda yönetirsiniz.

Gerekli IAM izinleri ve rolleri

Kimliği doğrulanmış kullanıcılar modu ayarını yönetmek için firebasevertexai.configs.update izni gerekir. Bu izin, şu IAM rollerine varsayılan olarak dahildir: Sahip, Düzenleyici, Firebase Yöneticisi ve Firebase AI Logic Yöneticisi.

Kimliği doğrulanmış kullanıcılar modunu zorunlu kıl

Firebase projeniz için kimliği doğrulanmış kullanıcılar modunu zorunlu kılmak için aşağıdaki adımları uygulayın:

1. Henüz yapmadıysanız bu kılavuzun önceki bölümlerinde yer alan, kimliği doğrulanmış kullanıcılar moduyla ilgili önemli hususları inceleyin.

2. Henüz yapmadıysanız uygulamanızda Firebase Authentication ayarlarını yapın (bu kılavuzda daha önce açıklandığı gibi).

3. Kimliği doğrulanmış kullanıcılar modunu zorunlu kılma:

   1. Firebase konsolunda AI Services (Yapay Zeka Hizmetleri) > AI Logic (Yapay Zeka Mantığı) > Settings (Ayarlar) sekmesine gidin.

   2. Kimliği doğrulanmış kullanıcılar modu bölümünde, Kimliği doğrulanmış kullanıcılar modunu zorunlu kıl seçeneğini Zorunlu kılındı olarak ayarlayın.

   3. Onay iletişim kutusunu inceleyin ve ardından Onayla'yı tıklayın.

Kimliği doğrulanmış kullanıcılar modunun zorunlu kılınmasını durdurma

Kimliği doğrulanmış kullanıcılar modunun yaptırımını durdurursanız aşağıdakilere dikkat edin:

• Firebase AI Logic üzerinden Firebase Authentication kimlik bilgilerini göndermeyen isteklere izin verilir.
• Bu, Firebase AI Logic için proje genelinde geçerli bir ayardır.

Firebase projeniz için kimliği doğrulanmış kullanıcılar modunun zorunlu kılınmasını şu şekilde durdurabilirsiniz:

1. Firebase konsolunda AI Services (Yapay Zeka Hizmetleri) > AI Logic (Yapay Zeka Mantığı) > Settings (Ayarlar) sekmesine gidin.

2. Kimliği doğrulanmış kullanıcılar modu bölümünde Kimliği doğrulanmış kullanıcılar modunu zorunlu kıl'ı devre dışı bırakın.

3. Onay iletişim kutusunu inceleyin ve ardından Onayla'yı tıklayın.