Firebase SecurityRules
hizmeti arayüzü.
İmza:
export declare class SecurityRules
Özellikler
Özellik | Değiştiriciler | Tür | Açıklama |
---|---|---|---|
uygulama | Uygulama |
Yöntemler
Yöntem | Değiştiriciler | Açıklama |
---|---|---|
createRuleset(dosya) | Belirtilen RulesFiledan yeni bir Kural grubu oluşturur. | |
createRulesFileFromSource(ad, kaynak) | Belirtilen ad ve kaynakla bir RulesFile oluşturur. Bağımsız değişkenlerden herhangi biri geçersizse hata verir. Bu, yerel bir işlemdir ve ağ API çağrıları içermez. | |
deleteRuleset(ad) | Belirtilen adla tanımlanan Kural kümesini siler. Giriş adı, proje kimliği öneki içermeyen kısa ad dizesi olmalıdır. Örneğin, projects/project-id/rulesets/my-ruleset öğesini silmek için "my-ruleset" kısa adını iletin. Belirtilen Ruleset bulunamazsa not-found hatasıyla reddedilir. |
|
getFirestoreRuleset() | Cloud Firestore'a şu anda uygulanan Kural'ı alır. Firestore'da herhangi bir kural kümesi uygulanmazsa not-found hatasıyla reddedilir. |
|
getRuleset(ad) | Verilen adla tanımlanan Kural kümesini alır. Giriş adı, proje kimliği öneki içermeyen kısa ad dizesi olmalıdır. Örneğin, projects/project-id/rulesets/my-ruleset öğesini almak için "my-ruleset" kısa adını iletin. Belirtilen Ruleset bulunamazsa not-found hatasıyla reddedilir. |
|
getStorageRuleset(paket) | Bir Cloud Storage paketine uygulanmakta olan Kural kümesini alır. Pakete herhangi bir kural grubu uygulanmazsa not-found hatasıyla reddedilir. |
|
listRulesetMetadata(pageSize, nextPageToken) | Kural grubu meta verileri sayfasını alır. | |
releaseFirestoreRuleset(kural kümesi) | Belirtilen Kural kural kümesini Cloud Firestore'a uygular. | |
releaseFirestoreRulesetFromSource(kaynak) | Belirtilen kaynaktan yeni bir Kural oluşturur ve bunu Cloud Firestore'a uygular. | |
releaseStorageRuleset(kural kümesi, paket) | Belirtilen Kural kümesi kural kümesini bir Cloud Storage paketine uygular. | |
releaseStorageRulesetFromSource(kaynak; paket) | Belirtilen kaynaktan yeni bir Kural kümesi oluşturur ve bunu bir Cloud Storage paketine uygular. |
SecurityKuralları.uygulama
İmza:
readonly app: App;
SecurityRules.createRuleset()
Belirtilen RulesFiledan yeni bir Kural grubu oluşturur.
İmza:
createRuleset(file: RulesFile): Promise<Ruleset>;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
dosya | Kural Dosyası | Yeni Ruleset deneyimine dahil edilecek kurallar dosyası. |
Şunu döndürür:
Söz veriyorum<Kural>
Yeni oluşturulan Ruleset
ile gerçekleşebilecek bir söz.
SecurityRules.createRulesFileFromSource()
Belirtilen ad ve kaynakla bir RulesFile oluşturur. Bağımsız değişkenlerden herhangi biri geçersizse hata verir. Bu, yerel bir işlemdir ve ağ API çağrıları içermez.
İmza:
createRulesFileFromSource(name: string, source: string | Buffer): RulesFile;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
ad | dize | Kural dosyasına atanacak ad. Bu, genellikle bir kural grubundaki dosyayı tanımlamaya yardımcı olan kısa bir dosya adıdır. |
source | dize | Tampon | Kurallar dosyasının içeriği. |
Şunu döndürür:
Yeni bir kural dosyası örneği.
Örnek
const source = '// Some rules source';
const rulesFile = admin.securityRules().createRulesFileFromSource(
'firestore.rules', source);
SecurityKurallar.deleteRuleset()
Belirtilen adla tanımlanan Kural kümesini siler. Giriş adı, proje kimliği öneki içermeyen kısa ad dizesi olmalıdır. Örneğin, projects/project-id/rulesets/my-ruleset
öğesini silmek için "my-ruleset" kısa adını iletin. Belirtilen Ruleset
bulunamazsa not-found
hatasıyla reddedilir.
İmza:
deleteRuleset(name: string): Promise<void>;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
ad | dize | Silinecek Ruleset öğesinin adı. |
Şunu döndürür:
Taahhüt<void>
Ruleset
silindiğinde yerine getirecek bir taahhüt.
SecurityRules.getFirestoreRuleset()
Cloud Firestore'a şu anda uygulanan Kural'ı alır. Firestore'da herhangi bir kural kümesi uygulanmazsa not-found
hatasıyla reddedilir.
İmza:
getFirestoreRuleset(): Promise<Ruleset>;
Şunu döndürür:
Söz veriyorum<Kural>
Firestore kural grubuna uygun bir söz.
SecurityRules.getRuleset()
Verilen adla tanımlanan Kural kümesini alır. Giriş adı, proje kimliği öneki içermeyen kısa ad dizesi olmalıdır. Örneğin, projects/project-id/rulesets/my-ruleset
öğesini almak için "my-ruleset" kısa adını iletin. Belirtilen Ruleset
bulunamazsa not-found
hatasıyla reddedilir.
İmza:
getRuleset(name: string): Promise<Ruleset>;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
ad | dize | Alınacak Ruleset öğesinin adı. |
Şunu döndürür:
Söz veriyorum<Kural>
Belirtilen Ruleset
koşullarını karşılayan bir vaat.
SecurityKurallar.getStorageRuleset()
Bir Cloud Storage paketine uygulanmakta olan Kural kümesini alır. Pakete herhangi bir kural grubu uygulanmazsa not-found
hatasıyla reddedilir.
İmza:
getStorageRuleset(bucket?: string): Promise<Ruleset>;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
paket | dize | Alınacak Cloud Storage paketinin isteğe bağlı adı. Belirtilmezse AppOptions aracılığıyla yapılandırılan varsayılan pakete uygulanan kural kümesini alır. |
Şunu döndürür:
Söz veriyorum<Kural>
Cloud Storage kural grubuyla eşleşen bir taahhüt.
SecurityRules.listRulesetMetadata()
Kural grubu meta verileri sayfasını alır.
İmza:
listRulesetMetadata(pageSize?: number, nextPageToken?: string): Promise<RulesetMetadataList>;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
pageSize | sayı | Sayfa boyutu, tanımlanmamışsa 100. Bu aynı zamanda izin verilen maksimum sınırdır. |
sonrakiSayfaJetonu | dize | Sonraki sayfa jetonu. Belirtilmezse herhangi bir ofset olmadan başlayan kural kümelerini döndürür. |
Şunu döndürür:
Promise<RulesetMetadataList>
Kural kümeleriyle yerine getiren bir vaat.
SecurityRules.releaseFirestoreRuleset() işlevi
Belirtilen Kural kural kümesini Cloud Firestore'a uygular.
İmza:
releaseFirestoreRuleset(ruleset: string | RulesetMetadata): Promise<void>;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
kural kümesi | dize | RulesetMetadata | Uygulanacak kural grubunun veya adı içeren bir RulesetMetadata nesnesinin adı. |
Şunu döndürür:
Taahhüt<void>
Kural grubu yayınlandığında yerine getirecek bir vaat.
SecurityRules.releaseFirestoreRulesetFromSource() ile ilgili güvenlik kuralları
Belirtilen kaynaktan yeni bir Kural oluşturur ve bunu Cloud Firestore'a uygular.
İmza:
releaseFirestoreRulesetFromSource(source: string | Buffer): Promise<Ruleset>;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
source | dize | Tampon | Uygulanacak kural kaynağı. |
Şunu döndürür:
Söz veriyorum<Kural>
Kural grubu oluşturulduğunda ve yayınlandığında yerine getiren bir taahhüt.
SecurityRules.releaseStorageRuleset()
Belirtilen Kural kümesi kural kümesini bir Cloud Storage paketine uygular.
İmza:
releaseStorageRuleset(ruleset: string | RulesetMetadata, bucket?: string): Promise<void>;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
kural kümesi | dize | RulesetMetadata | Uygulanacak kural grubunun veya adı içeren bir RulesetMetadata nesnesinin adı. |
paket | dize | Kuralların uygulanacağı Cloud Storage paketinin isteğe bağlı adı. Belirtilmezse kural kümesini AppOptions aracılığıyla yapılandırılan varsayılan pakete uygular. |
Şunu döndürür:
Taahhüt<void>
Kural grubu yayınlandığında yerine getirecek bir vaat.
SecurityKurallar.releaseStorageRulesetFromSource()
Belirtilen kaynaktan yeni bir Kural kümesi oluşturur ve bunu bir Cloud Storage paketine uygular.
İmza:
releaseStorageRulesetFromSource(source: string | Buffer, bucket?: string): Promise<Ruleset>;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
source | dize | Tampon | Uygulanacak kural kaynağı. |
paket | dize | Kuralların uygulanacağı Cloud Storage paketinin isteğe bağlı adı. Belirtilmezse kural kümesini AppOptions aracılığıyla yapılandırılan varsayılan pakete uygular. |
Şunu döndürür:
Söz veriyorum<Kural>
Kural grubu oluşturulduğunda ve yayınlandığında yerine getiren bir taahhüt.