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:
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.