SecurityRules class

Interfejs usługi Firebase SecurityRules.

Podpis:

export declare class SecurityRules 

Właściwości

Właściwość Modyfikatory Typ Opis
aplikacja Aplikacja

Metody

Metoda Modyfikatory Opis
createRuleset(plik) Tworzy nowy Ruleset (Zbiór reguł) na podstawie danego RulesFile (Plik reguły) .
createRulesFileFromSource(nazwa; źródło) Tworzy RulesFile o podanej nazwie i źródle. Jeśli jeden z argumentów jest nieprawidłowy, zwraca błąd. Jest to operacja lokalna i nie obejmuje żadnych wywołań sieciowych interfejsu API.
deleteRuleset(nazwa) Usuwa zbiór Ruleset (Zbiór reguł) określony przez podaną nazwę. Nazwa danych wejściowych powinna być ciągiem krótkiej nazwy bez prefiksu identyfikatora projektu. Na przykład aby usunąć regułę projects/project-id/rulesets/my-ruleset, przekaż krótką nazwę „my-ruleset”. Jeśli nie można znaleźć określonego elementu Ruleset, jest odrzucana z błędem not-found.
getFirestoreRuleset(), Pobiera zbiór reguł, który jest obecnie stosowany w Cloud Firestore. Jeśli w Firestore nie zastosowano zestawu reguł, zostanie odrzucony z błędem not-found.
getRuleset(nazwa) Pobiera Ruleset (Zbiór reguł) identyfikowany przez podaną nazwę. Nazwa danych wejściowych powinna być ciągiem krótkiej nazwy bez prefiksu identyfikatora projektu. Na przykład, aby pobrać projects/project-id/rulesets/my-ruleset, przekaż krótką nazwę „my-ruleset”. Jeśli nie można znaleźć określonego elementu Ruleset, jest odrzucana z błędem not-found.
getStorageRuleset(zasobnik) Pobiera Ruleset, który jest obecnie stosowany do zasobnika Cloud Storage. Jeśli w zasobniku nie zastosowano zestawu reguł, odrzuca z błędem not-found.
listRulesetMetadata(pageSize, nextPageToken) Pobiera stronę metadanych zestawu reguł.
releaseFirestoreRuleset(ruleset) Stosuje określony zestaw reguł do Cloud Firestore.
releaseFirestoreRulesetFromSource(source) Tworzy nowy zestaw reguł z podanego źródła i stosuje go do Cloud Firestore.
releaseStorageRuleset(reguła, zasobnik) Stosuje określony zestaw reguł Ruleset do zasobnika Cloud Storage.
releaseStorageRulesetFromSource(źródło; zasobnik) Tworzy nowy Zbiór reguł z podanego źródła i stosuje go do zasobnika Cloud Storage.

SecurityRules.app,

Podpis:

readonly app: App;

SecurityRules.createRuleset()

Tworzy nowy Ruleset (Zbiór reguł) na podstawie danego RulesFile (Plik reguły) .

Podpis:

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

Parametry

Parametr Typ Opis
plik Plik reguł Plik z regułami do uwzględnienia w nowym formacie Ruleset.

Zwroty:

Obietnica<zestaw reguł>

Obietnica, która spełnia się dzięki nowo utworzonym Ruleset.

SecurityRules.createRulesFileFromSource().

Tworzy RulesFile o podanej nazwie i źródle. Jeśli jeden z argumentów jest nieprawidłowy, zwraca błąd. Jest to operacja lokalna i nie obejmuje żadnych wywołań sieciowych interfejsu API.

Podpis:

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

Parametry

Parametr Typ Opis
nazwa ciąg znaków Nazwa, która ma zostać przypisana do pliku reguł. Zazwyczaj jest to krótka nazwa pliku, która ułatwia identyfikację pliku w zestawie reguł.
źródło ciąg znaków | Bufor Zawartość pliku reguł.

Zwroty:

Plik reguł

Nowa instancja pliku reguł.

Przykład

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

SecurityRules.deleteRuleset()

Usuwa zbiór Ruleset (Zbiór reguł) określony przez podaną nazwę. Nazwa danych wejściowych powinna być ciągiem krótkiej nazwy bez prefiksu identyfikatora projektu. Aby na przykład usunąć regułę projects/project-id/rulesets/my-ruleset, przekaż krótką nazwę „my-ruleset”. Odrzuca z błędem not-found, jeśli nie można znaleźć określonego pola Ruleset.

Podpis:

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

Parametry

Parametr Typ Opis
nazwa ciąg znaków Nazwa elementu Ruleset do usunięcia.

Zwroty:

Obietnica<void>

Obietnica spełniająca się po usunięciu elementu Ruleset.

SecurityRules.getFirestoreRuleset()

Pobiera zbiór reguł, który jest obecnie stosowany w Cloud Firestore. Jeśli w Firestore nie zastosowano zestawu reguł, zostanie odrzucony z błędem not-found.

Podpis:

getFirestoreRuleset(): Promise<Ruleset>;

Zwroty:

Obietnica<zestaw reguł>

Obietnica spełniająca się w zestawie reguł Firestore.

SecurityRules.getRuleset()

Pobiera Ruleset (Zbiór reguł) identyfikowany przez podaną nazwę. Nazwa danych wejściowych powinna być ciągiem krótkiej nazwy bez prefiksu identyfikatora projektu. Na przykład, aby pobrać projects/project-id/rulesets/my-ruleset, przekaż krótką nazwę „my-ruleset”. Jeśli nie można znaleźć określonego elementu Ruleset, jest odrzucana z błędem not-found.

Podpis:

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

Parametry

Parametr Typ Opis
nazwa ciąg znaków Nazwa elementu Ruleset do pobrania.

Zwroty:

Obietnica<zestaw reguł>

Obietnica spełniająca warunki określone w Ruleset.

SecurityRules.getStorageRuleset()

Pobiera Ruleset, który jest obecnie stosowany do zasobnika Cloud Storage. Jeśli w zasobniku nie zastosowano zestawu reguł, odrzuca z błędem not-found.

Podpis:

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

Parametry

Parametr Typ Opis
zasobnik ciąg znaków Opcjonalna nazwa zasobnika Cloud Storage do pobrania. Jeśli nie określono tego ustawienia, pobiera zestaw reguł zastosowany do domyślnego zasobnika skonfigurowanego przez AppOptions.

Zwroty:

Obietnica<zestaw reguł>

Obietnica, która spełnia wymagania zestawu reguł Cloud Storage.

SecurityRules.listRulesetMetadata()

Pobiera stronę metadanych zestawu reguł.

Podpis:

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

Parametry

Parametr Typ Opis
pageSize liczba Rozmiar strony (100, jeśli nie został określony). Jest to również maksymalny dozwolony limit.
nextPageToken ciąg znaków Token następnej strony. Jeśli nie określono tego ustawienia, zwraca zestawy reguł zaczynające się bez przesunięcia.

Zwroty:

Obietnica<RulesetMetadataList>

Obietnica, która spełnia się na stronie zestawów reguł.

SecurityRules.releaseFirestoreRuleset()

Stosuje określony zestaw reguł do Cloud Firestore.

Podpis:

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

Parametry

Parametr Typ Opis
zestaw reguł ciąg znaków | RulesetMetadata (Metadane zestawu reguł) Nazwa zestawu reguł do zastosowania lub obiekt RulesetMetadata zawierający nazwę.

Zwroty:

Obietnica<void>

Obietnica spełniająca się po zniesieniu zestawu reguł.

SecurityRules.releaseFirestoreRulesetFromSource(),

Tworzy nowy zestaw reguł z podanego źródła i stosuje go do Cloud Firestore.

Podpis:

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

Parametry

Parametr Typ Opis
źródło ciąg znaków | Bufor Źródło reguł do zastosowania.

Zwroty:

Obietnica<zestaw reguł>

Obietnica, która zostaje spełniony w momencie utworzenia i uwolnienia zestawu reguł.

SecurityRules.releaseStorageRuleset()

Stosuje określony zestaw reguł Ruleset do zasobnika Cloud Storage.

Podpis:

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

Parametry

Parametr Typ Opis
zestaw reguł ciąg znaków | RulesetMetadata (Metadane zestawu reguł) Nazwa zestawu reguł do zastosowania lub obiekt RulesetMetadata zawierający nazwę.
zasobnik ciąg znaków Opcjonalna nazwa zasobnika Cloud Storage, do którego chcesz zastosować reguły. Jeśli zestaw reguł nie zostanie określony, zostanie zastosowany do domyślnego zasobnika skonfigurowanego za pomocą AppOptions.

Zwroty:

Obietnica<void>

Obietnica spełniająca się po zniesieniu zestawu reguł.

SecurityRules.releaseStorageRulesetFromSource().

Tworzy nowy Zbiór reguł z podanego źródła i stosuje go do zasobnika Cloud Storage.

Podpis:

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

Parametry

Parametr Typ Opis
źródło ciąg znaków | Bufor Źródło reguł do zastosowania.
zasobnik ciąg znaków Opcjonalna nazwa zasobnika Cloud Storage, do którego chcesz zastosować reguły. Jeśli zestaw reguł nie zostanie określony, zostanie zastosowany do domyślnego zasobnika skonfigurowanego za pomocą AppOptions.

Zwroty:

Obietnica<zestaw reguł>

Obietnica, która zostaje spełniony w momencie utworzenia i uwolnienia zestawu reguł.