SecurityRules class

Die Firebase SecurityRules Dienstschnittstelle.

Unterschrift:

export declare class SecurityRules 

Eigenschaften

Eigentum Modifikatoren Typ Beschreibung
App App

Methoden

Methode Modifikatoren Beschreibung
createRuleset(datei) Erstellt einen neuen Regelsatz aus der angegebenen RulesFile .
createRulesFileFromSource(name, Quelle) Erstellt eine Regeldatei mit dem angegebenen Namen und der angegebenen Quelle. Gibt einen Fehler aus, wenn eines der Argumente ungültig ist. Dies ist ein lokaler Vorgang und erfordert keine Netzwerk-API-Aufrufe.
deleteRuleset(name) Löscht den durch den angegebenen Namen identifizierten Regelsatz . Der Eingabename sollte die Kurznamenzeichenfolge ohne das Projekt-ID-Präfix sein. Um beispielsweise projects/project-id/rulesets/my-ruleset zu löschen, übergeben Sie den Kurznamen „my-ruleset“. Lehnt mit der Fehlermeldung not-found ab, wenn der angegebene Ruleset nicht gefunden werden kann.
getFirestoreRuleset() Ruft den aktuell auf Cloud Firestore angewendeten Regelsatz ab. Wird mit der Fehlermeldung not-found abgelehnt, wenn kein Regelsatz auf Firestore angewendet wird.
getRuleset(name) Ruft den durch den angegebenen Namen identifizierten Regelsatz ab. Der Eingabename sollte die Kurznamenzeichenfolge ohne das Projekt-ID-Präfix sein. Um beispielsweise projects/project-id/rulesets/my-ruleset abzurufen, übergeben Sie den Kurznamen „my-ruleset“. Lehnt mit der Fehlermeldung not-found ab, wenn der angegebene Ruleset nicht gefunden werden kann.
getStorageRuleset(bucket) Ruft den Regelsatz ab, der derzeit auf einen Cloud Storage-Bucket angewendet wird. Lehnt mit der Fehlermeldung not-found ab, wenn kein Regelsatz auf den Bucket angewendet wird.
listRulesetMetadata(pageSize, nextPageToken) Ruft eine Seite mit Regelsatzmetadaten ab.
releaseFirestoreRuleset(Regelsatz) Wendet den angegebenen Regelsatz- Regelsatz auf Cloud Firestore an.
releaseFirestoreRulesetFromSource(Quelle) Erstellt einen neuen Regelsatz aus der angegebenen Quelle und wendet ihn auf Cloud Firestore an.
releaseStorageRuleset(Regelsatz, Bucket) Wendet den angegebenen Regelsatz- Regelsatz auf einen Cloud Storage-Bucket an.
releaseStorageRulesetFromSource(Quelle, Bucket) Erstellt einen neuen Regelsatz aus der angegebenen Quelle und wendet ihn auf einen Cloud Storage-Bucket an.

SecurityRules.app

Unterschrift:

readonly app: App;

SecurityRules.createRuleset()

Erstellt einen neuen Regelsatz aus der angegebenen RulesFile .

Unterschrift:

createRuleset(file: RulesFile): Promise<Ruleset>;

Parameter

Parameter Typ Beschreibung
Datei Regeldatei Regeldatei, die in den neuen Ruleset aufgenommen werden soll.

Kehrt zurück:

Versprechen< Regelsatz >

Ein Versprechen, das mit dem neu erstellten Ruleset eingelöst wird .

SecurityRules.createRulesFileFromSource()

Erstellt eine Regeldatei mit dem angegebenen Namen und der angegebenen Quelle. Gibt einen Fehler aus, wenn eines der Argumente ungültig ist. Dies ist ein lokaler Vorgang und erfordert keine Netzwerk-API-Aufrufe.

Unterschrift:

createRulesFileFromSource(name: string, source: string | Buffer): RulesFile;

Parameter

Parameter Typ Beschreibung
Name Zeichenfolge Name, der der Regeldatei zugewiesen werden soll. Dies ist normalerweise ein kurzer Dateiname, der dabei hilft, die Datei in einem Regelsatz zu identifizieren.
Quelle Zeichenfolge | Puffer Inhalt der Regeldatei.

Kehrt zurück:

Regeldatei

Eine neue Regeldateiinstanz.

Beispiel

const source = '// Some rules source';
const rulesFile = admin.securityRules().createRulesFileFromSource(
  'firestore.rules', source);

SecurityRules.deleteRuleset()

Löscht den durch den angegebenen Namen identifizierten Regelsatz . Der Eingabename sollte die Kurznamenzeichenfolge ohne das Projekt-ID-Präfix sein. Zum Beispiel, um projects/project-id/rulesets/my-ruleset zu löschen , übergeben Sie den Kurznamen „my-ruleset“. Lehnt mit der Fehlermeldung not-found ab, wenn der angegebene Ruleset nicht gefunden werden kann.

Unterschrift:

deleteRuleset(name: string): Promise<void>;

Parameter

Parameter Typ Beschreibung
Name Zeichenfolge Name des zu löschenden Ruleset .

Kehrt zurück:

Versprechen<void>

Ein Versprechen, das erfüllt wird, wenn der Ruleset gelöscht wird.

SecurityRules.getFirestoreRuleset()

Ruft den aktuell auf Cloud Firestore angewendeten Regelsatz ab. Wird mit der Fehlermeldung not-found abgelehnt, wenn kein Regelsatz auf Firestore angewendet wird.

Unterschrift:

getFirestoreRuleset(): Promise<Ruleset>;

Kehrt zurück:

Versprechen< Regelsatz >

Ein Versprechen, das mit dem Firestore-Regelsatz erfüllt wird.

SecurityRules.getRuleset()

Ruft den durch den angegebenen Namen identifizierten Regelsatz ab. Der Eingabename sollte die Kurznamenzeichenfolge ohne das Projekt-ID-Präfix sein. Zum Beispiel, um projects/project-id/rulesets/my-ruleset abzurufen , übergeben Sie den Kurznamen „my-ruleset“. Lehnt mit der Fehlermeldung not-found ab, wenn der angegebene Ruleset nicht gefunden werden kann.

Unterschrift:

getRuleset(name: string): Promise<Ruleset>;

Parameter

Parameter Typ Beschreibung
Name Zeichenfolge Name des abzurufenden Ruleset .

Kehrt zurück:

Versprechen< Regelsatz >

Ein Versprechen, das den angegebenen Ruleset erfüllt .

SecurityRules.getStorageRuleset()

Ruft den Regelsatz ab, der derzeit auf einen Cloud Storage-Bucket angewendet wird. Lehnt mit der Fehlermeldung not-found ab, wenn kein Regelsatz auf den Bucket angewendet wird.

Unterschrift:

getStorageRuleset(bucket?: string): Promise<Ruleset>;

Parameter

Parameter Typ Beschreibung
Eimer Zeichenfolge Optionaler Name des abzurufenden Cloud Storage-Buckets. Wenn nicht angegeben, wird der Regelsatz abgerufen, der auf den über AppOptions konfigurierten Standard-Bucket angewendet wird.

Kehrt zurück:

Versprechen< Regelsatz >

Ein Versprechen, das mit dem Cloud Storage-Regelwerk erfüllt wird.

SecurityRules.listRulesetMetadata()

Ruft eine Seite mit Regelsatzmetadaten ab.

Unterschrift:

listRulesetMetadata(pageSize?: number, nextPageToken?: string): Promise<RulesetMetadataList>;

Parameter

Parameter Typ Beschreibung
Seitengröße Nummer Die Seitengröße, 100, wenn nicht definiert. Dies ist auch die maximal zulässige Grenze.
nextPageToken Zeichenfolge Das Token für die nächste Seite. Wenn nicht angegeben, werden Regelsätze zurückgegeben, die ohne Offset beginnen.

Kehrt zurück:

Versprechen< RulesetMetadataList >

Ein Versprechen, das mit einer Seite voller Regelsätze erfüllt wird.

SecurityRules.releaseFirestoreRuleset()

Wendet den angegebenen Regelsatz- Regelsatz auf Cloud Firestore an.

Unterschrift:

releaseFirestoreRuleset(ruleset: string | RulesetMetadata): Promise<void>;

Parameter

Parameter Typ Beschreibung
Regelsatz Zeichenfolge | RulesetMetadata Name des anzuwendenden Regelsatzes oder ein RulesetMetadata Objekt, das den Namen enthält.

Kehrt zurück:

Versprechen<void>

Ein Versprechen, das erfüllt wird, wenn der Regelsatz veröffentlicht wird.

SecurityRules.releaseFirestoreRulesetFromSource()

Erstellt einen neuen Regelsatz aus der angegebenen Quelle und wendet ihn auf Cloud Firestore an.

Unterschrift:

releaseFirestoreRulesetFromSource(source: string | Buffer): Promise<Ruleset>;

Parameter

Parameter Typ Beschreibung
Quelle Zeichenfolge | Puffer Anzuwendende Regelquelle.

Kehrt zurück:

Versprechen< Regelsatz >

Ein Versprechen, das erfüllt wird, wenn der Regelsatz erstellt und veröffentlicht wird.

SecurityRules.releaseStorageRuleset()

Wendet den angegebenen Regelsatz- Regelsatz auf einen Cloud Storage-Bucket an.

Unterschrift:

releaseStorageRuleset(ruleset: string | RulesetMetadata, bucket?: string): Promise<void>;

Parameter

Parameter Typ Beschreibung
Regelsatz Zeichenfolge | RulesetMetadata Name des anzuwendenden Regelsatzes oder ein RulesetMetadata Objekt, das den Namen enthält.
Eimer Zeichenfolge Optionaler Name des Cloud Storage-Buckets, auf den die Regeln angewendet werden sollen. Wenn nicht angegeben, wird der Regelsatz auf den über AppOptions konfigurierten Standard-Bucket angewendet .

Kehrt zurück:

Versprechen<void>

Ein Versprechen, das erfüllt wird, wenn der Regelsatz veröffentlicht wird.

SecurityRules.releaseStorageRulesetFromSource()

Erstellt einen neuen Regelsatz aus der angegebenen Quelle und wendet ihn auf einen Cloud Storage-Bucket an.

Unterschrift:

releaseStorageRulesetFromSource(source: string | Buffer, bucket?: string): Promise<Ruleset>;

Parameter

Parameter Typ Beschreibung
Quelle Zeichenfolge | Puffer Anzuwendende Regelquelle.
Eimer Zeichenfolge Optionaler Name des Cloud Storage-Buckets, auf den die Regeln angewendet werden sollen. Wenn nicht angegeben, wird der Regelsatz auf den über AppOptions konfigurierten Standard-Bucket angewendet .

Kehrt zurück:

Versprechen< Regelsatz >

Ein Versprechen, das erfüllt wird, wenn der Regelsatz erstellt und veröffentlicht wird.