Cloud Storage için Firebase Security Rules, Cloud Storage paketlerinde depolanan nesnelere erişimi kontrol etmenize olanak tanır. Esnek kural söz dizimi, Cloud Storage paketinizdeki tüm yazma işlemlerinden belirli bir dosyadaki işlemlere kadar her işlemi kontrol edecek kurallar oluşturmanıza olanak tanır.
Yapay Zeka Desteği için yapay zeka istemi
Yapay zeka desteği için aşağıdaki istemi yapay zeka kodlama temsilcinize (ör. Android Studio'da Gemini, Antigravity, Claude Code, Codex ve Cursor) kopyalayın. İstemi özelleştirebilir ve temsilcinizle birlikte üzerinde çalışabilirsiniz. Ayrıntılı kurulum bilgileri için Firebase aracı becerileri sayfasını ziyaret edin.
Help me use Firebase in my app.
1. Make sure that **Firebase agent skills** are installed and updated. For Claude Code, Codex, or Cursor agents, help me install the Firebase plugin. For other agents, run `npx skills add firebase/agent-skills`. Always try to use **Firebase agent skills** for Firebase-related tasks.
2. Help me write, validate, and deploy Firebase Security Rules to protect my app's Cloud Storage data.
Bu kılavuzda, eksiksiz kural kümeleri oluşturmak için Cloud Storage Security Rules temel söz dizimi ve yapısı açıklanmaktadır.
Hizmet ve veritabanı beyanı
Cloud Storage için Firebase Security Rules her zaman aşağıdaki beyanla başlar:
service firebase.storage {
// ...
}
service firebase.storage bildirimi, kuralları Cloud Storage için kapsamlandırarak Cloud Storage Security Rules ile Cloud Firestore gibi diğer ürünlerin kuralları arasında çakışmaları önler.
Temel okuma/yazma kuralları
Temel kurallar, Cloud Storage paketlerini tanımlayan bir match ifadesinden, dosya adını belirten bir eşleşme ifadesinden ve belirtilen verilerin okunmasına ne zaman izin verildiğini ayrıntılı olarak açıklayan bir allow ifadesinden oluşur. allow ifadeleri, ilgili erişim yöntemlerini (ör. okuma, yazma) ve erişime izin verilen veya erişimin reddedildiği koşulları belirtir.
Varsayılan kural grubunuzda, ilk match ifadesi, kuralların projenizdeki tüm paketler için geçerli olduğunu belirtmek üzere {bucket} joker karakter ifadesini kullanır. Joker karakter eşleşmeleri konusunu bir sonraki bölümde daha ayrıntılı olarak ele alacağız.
service firebase.storage {
// The {bucket} wildcard matches files in all Cloud Storage buckets
match /b/{bucket}/o {
// Match filename
match /filename {
allow read: if <condition>;
allow write: if <condition>;
}
}
}
Tüm eşleşme ifadeleri dosyalara işaret eder. Eşleşme ifadesi, match /images/profilePhoto.png örneğinde olduğu gibi belirli bir dosyayı işaret edebilir.
Joker karakterleri eşleştirme
Security Rules, tek bir dosyayı işaret etmenin yanı sıra adında belirli bir dize ön eki bulunan tüm dosyaları işaret etmek için joker karakterler kullanabilir. Buna, match /images/{imageId} örneğinde olduğu gibi eğik çizgiler de dahildir.
Yukarıdaki örnekte, eşleşme ifadesi {imageId} joker karakter söz dizimini kullanır.
Bu, kuralın adının başında /images/ olan tüm dosyalar (ör. /images/profilePhoto.png veya /images/croppedProfilePhoto.png) için geçerli olduğu anlamına gelir. Eşleşme ifadesindeki allow ifadeleri değerlendirildiğinde imageId değişkeni, profilePhoto.png veya croppedProfilePhoto.png gibi resim dosya adına çözümlenir.
Dosya adı veya yol yetkilendirmesi sağlamak için match içinden bir joker karakter değişkenine başvurulabilir:
// Another way to restrict the name of a file
match /images/{imageId} {
allow read: if imageId == "profilePhoto.png";
}
Hiyerarşik veriler
Daha önce de belirttiğimiz gibi, Cloud Storage paketinde hiyerarşik bir yapı yoktur. Ancak dosya adlandırma kuralı kullanarak, genellikle dosya adlarında eğik çizgi içeren bir kural kullanarak, iç içe geçmiş bir dizi dizin ve alt dizin gibi görünen bir yapıyı taklit edebiliriz. Firebase Security Rules ürününün bu dosya adlarıyla nasıl etkileşim kurduğunu anlamak önemlidir.
Adları /images/ köküyle başlayan bir dosya grubu olduğunu düşünelim. Firebase Security Rules yalnızca eşleşen dosya adında geçerlidir. Bu nedenle, /images/ kökünde tanımlanan erişim denetimleri /mp3s/ kökünde geçerli değildir.
Bunun yerine, farklı dosya adı kalıplarıyla eşleşen açık kurallar yazın:
service firebase.storage {
match /b/{bucket}/o {
match /images/{imageId} {
allow read, write: if <condition>;
}
// Explicitly define rules for the 'mp3s' pattern
match /mp3s/{mp3Id} {
allow read, write: if <condition>;
}
}
}
match ifadeleri iç içe yerleştirilirken içteki match ifadesinin yolu her zaman dıştaki match ifadesinin yoluna eklenir. Bu nedenle, aşağıdaki iki kural grubu eşdeğerdir:
service firebase.storage {
match /b/{bucket}/o {
match /images {
// Exact match for "images/profilePhoto.png"
match /profilePhoto.png {
allow write: if <condition>;
}
}
}
}
service firebase.storage {
match /b/{bucket}/o {
// Exact match for "images/profilePhoto.png"
match /images/profilePhoto.png {
allow write: if <condition>;
}
}
}
Yinelemeli eşleşme joker karakterleri
Dosya adının sonundaki dizeleri eşleştiren ve döndüren joker karakterlere ek olarak, joker karakter adına =** ekleyerek daha karmaşık eşleştirme için birden fazla segment joker karakteri tanımlanabilir (ör. {path=**}):
// Partial match for files that start with "images"
match /images {
// Exact match for "images/**"
// e.g. images/users/user:12345/profilePhoto.png is matched
// images/profilePhoto.png is also matched!
match /{allImages=**} {
// This rule matches one or more path segments (**)
// allImages is a path that contains all segments matched
allow read: if <other_condition>;
}
}
Bir dosya birden fazla kuralla eşleşirse sonuç, tüm kural değerlendirmelerinin sonucunun OR olur. Yani, dosyanın eşleştiği herhangi bir kural true olarak değerlendirilirse sonuç true olur.
Yukarıdaki kurallarda, condition veya other_condition doğru olarak değerlendirilirse "images/profilePhoto.png" dosyası okunabilir. "images/users/user:12345/profilePhoto.png" dosyası ise yalnızca other_condition sonucuna tabidir.
Cloud Storage Security Rules basamaklı değildir ve kurallar yalnızca istek yolu, kuralların belirtildiği bir yolla eşleştiğinde değerlendirilir.
Sürüm 1
Firebase Security Rules varsayılan olarak 1. sürümü kullanır. Sürüm 1'de, yinelemeli joker karakterler sıfır veya daha fazla öğeyle değil, bir veya daha fazla dosya adı öğesiyle eşleşir. Bu nedenle,
match /images/{filenamePrefixWildcard}/{imageFilename=**} /images/profilePics/profile.png gibi bir dosya adıyla eşleşir ancak /images/badge.png ile eşleşmez. Bunun yerine /images/{imagePrefixorFilename=**} kullanın.
Yinelemeli joker karakterler, eşleşme ifadesinin sonunda yer almalıdır.
Daha güçlü özelliklere sahip olduğu için 2. sürümü kullanmanızı öneririz.
Sürüm 2
Firebase Security Rules uygulamasının 2. sürümünde, yinelemeli joker karakterler sıfır veya daha fazla yol öğesiyle eşleşir. Bu nedenle /images/{filenamePrefixWildcard}/{imageFilename=**}, /images/profilePics/profile.png ve /images/badge.png dosya adlarıyla eşleşir.
Güvenlik kurallarınızın en üstüne rules_version = '2'; ekleyerek 2. sürümü etkinleştirmeniz gerekir:
rules_version = '2';
service cloud.storage {
match /b/{bucket}/o {
...
}
}
Eşleşme ifadesi başına en fazla bir özyinelemeli joker karakter kullanabilirsiniz ancak 2. sürümde bu joker karakteri eşleşme ifadesinin herhangi bir yerine yerleştirebilirsiniz. Örneğin:
rules_version = '2';
service firebase.storage {
match /b/{bucket}/o {
// Matches any file in a songs "subdirectory" under the
// top level of your Cloud Storage bucket.
match /{prefixSegment=**}/songs/{mp3filenames} {
allow read, write: if <condition>;
}
}
}
Ayrıntılı işlemler
Bazı durumlarda, read ve write işlemlerini daha ayrıntılı işlemlere bölmek faydalı olabilir. Örneğin, uygulamanız dosya oluşturma ve dosya silme işlemleri için farklı koşullar uygulamak isteyebilir.
read işlemi, get ve list olarak ikiye ayrılabilir.
write kuralı create, update ve delete olarak ayrılabilir:
service firebase.storage { match /b/{bucket}/o { // A read rule can be divided into read and list rules match /images/{imageId} { // Applies to single file read requests allow get: if <condition>; // Applies to list and listAll requests (Security Rules Version 2) allow list: if <condition>; // A write rule can be divided into create, update, and delete rules match /images/{imageId} { // Applies to writes to file contents allow create: if <condition>; // Applies to updates to (pre-existing) file metadata allow update: if <condition>; // Applies to delete operations allow delete: if <condition>; } } } }
Çakışan eşleşme ifadeleri
Bir dosya adı birden fazla match ifadesiyle eşleşebilir. Birden fazla allow ifadesinin bir istekle eşleştiği durumlarda, koşullardan herhangi biri true ise erişime izin verilir:
service firebase.storage {
match b/{bucket}/o {
// Matches file names directly inside of '/images/'.
match /images/{imageId} {
allow read, write: if false;
}
// Matches file names anywhere under `/images/`
match /images/{imageId=**} {
allow read, write: if true;
}
}
}
Yukarıdaki örnekte, adı /images/ ile başlayan dosyalara yönelik tüm okuma ve yazma işlemlerine izin verilir. Bunun nedeni, ilk kural false olsa bile ikinci kuralın her zaman true olmasıdır.
Kurallar filtre değildir
Verilerinizin güvenliğini sağlayıp dosya işlemlerini gerçekleştirmeye başladığınızda güvenlik kurallarının filtre olmadığını unutmayın. Bir dosya adı kalıbıyla eşleşen bir dosya grubu üzerinde işlem yapamaz ve Cloud Storage'in yalnızca mevcut istemcinin erişim izni olan dosyalara erişmesini bekleyemezsiniz.
Örneğin, aşağıdaki güvenlik kuralını ele alalım:
service firebase.storage {
match /b/{bucket}/o {
// Allow the client to read files with contentType 'image/png'
match /aFileNamePrefix/{aFileName} {
allow read: if resource.contentType == 'image/png';
}
}
}
Reddedildi: Bu kural, sonuç kümesi contentType değerinin image/png olmadığı dosyaları içerebileceğinden aşağıdaki isteği reddeder:
Web
filesRef = storage.ref().child("aFilenamePrefix"); filesRef.listAll() .then(function(result) { console.log("Success: ", result.items); }) });
Cloud Storage Security Rules içindeki kurallar, her sorguyu potansiyel sonucuna göre değerlendirir ve istemcinin okuma izni olmayan bir dosya döndürebilecekse isteği reddeder. Erişim istekleri, kurallarınız tarafından belirlenen kısıtlamalara uymalıdır.
Sonraki adımlar
Cloud Storage için Firebase Security Rules hakkında daha fazla bilgi edinebilirsiniz:
Kurallar dilinin bir sonraki önemli kavramı olan dinamik koşulları öğrenin. Bu koşullar, kurallarınızın kullanıcı yetkilendirmesini kontrol etmesine, mevcut ve gelen verileri karşılaştırmasına, gelen verileri doğrulamasına ve daha fazlasına olanak tanır.
Güvenlikle ilgili tipik kullanım alanlarını ve bunları ele alan Firebase Security Rules tanımlarını inceleyin.
Cloud Storage ile ilgili Firebase Security Rules kullanım alanını inceleyebilirsiniz: