SecurityRules class

L'interfaccia del servizio Firebase SecurityRules .

Firma:

export declare class SecurityRules 

Proprietà

Proprietà Modificatori Tipo Descrizione
app App

Metodi

Metodo Modificatori Descrizione
creaset di regole(file) Crea un nuovo set di regole dal RulesFile specificato .
createRulesFileFromSource(nome, origine) Crea un RulesFile con il nome e l'origine specificati. Genera un errore se uno qualsiasi degli argomenti non è valido. Si tratta di un'operazione locale e non implica alcuna chiamata API di rete.
deleteRuleset(nome) Elimina il set di regole identificato dal nome dato. Il nome di input deve essere la stringa del nome breve senza il prefisso dell'ID progetto. Ad esempio, per eliminare projects/project-id/rulesets/my-ruleset , passare il nome breve "my-ruleset". Rifiuta con un errore not-found se non è possibile trovare il Ruleset specificato.
getFirestoreRuleset() Ottiene il set di regole attualmente applicato a Cloud Firestore. Rifiuta con un errore not-found se su Firestore non viene applicato alcun set di regole.
getRuleset(nome) Ottiene il set di regole identificato dal nome specificato. Il nome di input deve essere la stringa del nome breve senza il prefisso dell'ID progetto. Ad esempio, per recuperare projects/project-id/rulesets/my-ruleset , passare il nome breve "my-ruleset". Rifiuta con un errore not-found se non è possibile trovare il Ruleset specificato.
getStorageRuleset(bucket) Ottiene il set di regole attualmente applicato a un bucket Cloud Storage. Rifiuta con un errore not-found se al bucket non viene applicato alcun set di regole.
listRulesetMetadata(pageSize, nextPageToken) Recupera una pagina di metadati del set di regole.
releaseFirestoreRuleset(set di regole) Applica il set di regole del set di regole specificato a Cloud Firestore.
releaseFirestoreRulesetFromSource(fonte) Crea un nuovo set di regole dall'origine specificata e lo applica a Cloud Firestore.
releaseStorageRuleset(set di regole, bucket) Applica il set di regole del set di regole specificato a un bucket Cloud Storage.
releaseStorageRulesetFromSource(sorgente, bucket) Crea un nuovo set di regole dall'origine specificata e lo applica a un bucket Cloud Storage.

SecurityRules.app

Firma:

readonly app: App;

SecurityRules.createRuleset()

Crea un nuovo set di regole dal RulesFile specificato .

Firma:

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

Parametri

Parametro Tipo Descrizione
file RulesFile File di regole da includere nel nuovo Ruleset .

Ritorna:

Promessa< Regole >

Una promessa che si mantiene con il Ruleset appena creato .

SecurityRules.createRulesFileFromSource()

Crea un RulesFile con il nome e l'origine specificati. Genera un errore se uno qualsiasi degli argomenti non è valido. Si tratta di un'operazione locale e non implica alcuna chiamata API di rete.

Firma:

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

Parametri

Parametro Tipo Descrizione
nome corda Nome da assegnare al file delle regole. Di solito si tratta di un nome di file breve che aiuta a identificare il file in un set di regole.
fonte stringa | Respingente Contenuto del file delle regole.

Ritorna:

RulesFile

Una nuova istanza del file di regole.

Esempio

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

SecurityRules.deleteRuleset()

Elimina il set di regole identificato dal nome dato. Il nome di input deve essere la stringa del nome breve senza il prefisso dell'ID progetto. Ad esempio, per eliminare projects/project-id/rulesets/my-ruleset , passa il nome breve "my-ruleset". Rifiuta con un errore not-found se non è possibile trovare il Ruleset specificato.

Firma:

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

Parametri

Parametro Tipo Descrizione
nome corda Nome del Ruleset da eliminare.

Ritorna:

Promesso<vuoto>

Una promessa che viene mantenuta quando il Ruleset viene eliminato.

SecurityRules.getFirestoreRuleset()

Ottiene il set di regole attualmente applicato a Cloud Firestore. Rifiuta con un errore not-found se su Firestore non viene applicato alcun set di regole.

Firma:

getFirestoreRuleset(): Promise<Ruleset>;

Ritorna:

Promessa< Regole >

Una promessa che viene mantenuta con il set di regole Firestore.

SecurityRules.getRuleset()

Ottiene il set di regole identificato dal nome specificato. Il nome di input deve essere la stringa del nome breve senza il prefisso dell'ID progetto. Ad esempio, per recuperare projects/project-id/rulesets/my-ruleset , passa il nome breve "my-ruleset". Rifiuta con un errore not-found se non è possibile trovare il Ruleset specificato.

Firma:

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

Parametri

Parametro Tipo Descrizione
nome corda Nome del Ruleset da recuperare.

Ritorna:

Promessa< Regole >

Una promessa che soddisfa il Ruleset specificato .

SecurityRules.getStorageRuleset()

Ottiene il set di regole attualmente applicato a un bucket Cloud Storage. Rifiuta con un errore not-found se al bucket non viene applicato alcun set di regole.

Firma:

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

Parametri

Parametro Tipo Descrizione
secchio corda Nome facoltativo del bucket Cloud Storage da recuperare. Se non specificato, recupera il set di regole applicato al bucket predefinito configurato tramite AppOptions .

Ritorna:

Promessa< Regole >

Una promessa che viene mantenuta con il set di regole di Cloud Storage.

SecurityRules.listRulesetMetadata()

Recupera una pagina di metadati del set di regole.

Firma:

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

Parametri

Parametro Tipo Descrizione
dimensioni della pagina numero La dimensione della pagina, 100 se non definita. Questo è anche il limite massimo consentito.
tokenPaginasuccessiva corda Il token della pagina successiva. Se non specificato, restituisce i set di regole che iniziano senza alcun offset.

Ritorna:

Promessa< RulesetMetadataList >

Una promessa che si mantiene con una pagina di regole.

SecurityRules.releaseFirestoreRuleset()

Applica il set di regole del set di regole specificato a Cloud Firestore.

Firma:

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

Parametri

Parametro Tipo Descrizione
set di regole stringa | Metadati del set di regole Nome del set di regole da applicare o un oggetto RulesetMetadata contenente il nome.

Ritorna:

Promesso<vuoto>

Una promessa che si mantiene quando le regole vengono rilasciate.

SecurityRules.releaseFirestoreRulesetFromSource()

Crea un nuovo set di regole dall'origine specificata e lo applica a Cloud Firestore.

Firma:

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

Parametri

Parametro Tipo Descrizione
fonte stringa | Respingente Origine delle regole da applicare.

Ritorna:

Promessa< Regole >

Una promessa che si mantiene quando le regole vengono create e rilasciate.

SecurityRules.releaseStorageRuleset()

Applica il set di regole del set di regole specificato a un bucket Cloud Storage.

Firma:

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

Parametri

Parametro Tipo Descrizione
set di regole stringa | Metadati del set di regole Nome del set di regole da applicare o un oggetto RulesetMetadata contenente il nome.
secchio corda Nome facoltativo del bucket Cloud Storage a cui applicare le regole. Se non specificato, applica il set di regole sul bucket predefinito configurato tramite AppOptions .

Ritorna:

Promesso<vuoto>

Una promessa che si mantiene quando le regole vengono rilasciate.

SecurityRules.releaseStorageRulesetFromSource()

Crea un nuovo set di regole dall'origine specificata e lo applica a un bucket Cloud Storage.

Firma:

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

Parametri

Parametro Tipo Descrizione
fonte stringa | Respingente Origine delle regole da applicare.
secchio corda Nome facoltativo del bucket Cloud Storage a cui applicare le regole. Se non specificato, applica il set di regole sul bucket predefinito configurato tramite AppOptions .

Ritorna:

Promessa< Regole >

Una promessa che si mantiene quando le regole vengono create e rilasciate.