SecurityRules class

La interfaz del servicio SecurityRules de Firebase

Firma:

export declare class SecurityRules 

Propiedades

Propiedad Teclas modificadoras Tipo Descripción
app App

Métodos

Método Teclas modificadoras Descripción
createRuleset(archivo) Crea un Ruleset nuevo a partir del RulesFile especificado.
createRulesFileFromSource(nombre, fuente) Crea un RulesFile con el nombre y la fuente especificados. Muestra un error si alguno de los argumentos no es válido. Esta es una operación local y no implica ninguna llamada a la API de la red.
deleteRuleset(nombre) Borra el Conjunto de reglas que se identifica con el nombre dado. El nombre de entrada debe ser la cadena de nombre corto sin el prefijo de ID del proyecto. Por ejemplo, para borrar el projects/project-id/rulesets/my-ruleset, pasa el nombre corto "my-ruleset". Se rechaza con un error not-found si no se puede encontrar el Ruleset especificado.
getFirestoreRuleset() Obtiene el conjunto de reglas que se aplica actualmente a Cloud Firestore. Se rechaza con un error not-found si no se aplica ningún conjunto de reglas en Firestore.
getRuleset(nombre) Obtiene el conjunto de reglas identificado mediante el nombre dado. El nombre de entrada debe ser la cadena de nombre corto sin el prefijo de ID del proyecto. Por ejemplo, para recuperar el projects/project-id/rulesets/my-ruleset, pasa el nombre corto "my-ruleset". Se rechaza con un error not-found si no se puede encontrar el Ruleset especificado.
getStorageRuleset(bucket) Obtiene el conjunto de reglas que se aplica actualmente a un bucket de Cloud Storage. Se rechaza con un error not-found si no se aplica ningún conjunto de reglas en el bucket.
listRulesetMetadata(pageSize, nextPageToken) Recupera una página de metadatos de conjunto de reglas.
releaseFirestoreRuleset(ruleset) Aplica el conjunto de reglas del conjunto de reglas especificado a Cloud Firestore.
releaseFirestoreRulesetFromSource(fuente) Crea un conjunto de reglas nuevo a partir de la fuente determinada y lo aplica a Cloud Firestore.
releaseStorageRuleset(ruleset, bucket) Aplica el conjunto de reglas del conjunto de reglas especificado a un bucket de Cloud Storage.
releaseStorageRulesetFromSource(source, bucket) Crea un conjunto de reglas nuevo a partir de la fuente determinada y lo aplica a un bucket de Cloud Storage.

ReglasDeSeguridad.app

Firma:

readonly app: App;

SecurityRules.createRuleset()

Crea un Ruleset nuevo a partir del RulesFile especificado.

Firma:

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

Parámetros

Parámetro Tipo Descripción
en el archivo. Archivo de reglas Archivo de reglas que se incluirán en el nuevo Ruleset.

Muestra:

Promesa<Conjunto de reglas>

Una promesa que se cumple con el Ruleset recién creado.

SecurityRules.createRulesFileFromSource()

Crea un RulesFile con el nombre y la fuente especificados. Muestra un error si alguno de los argumentos no es válido. Esta es una operación local y no implica ninguna llamada a la API de la red.

Firma:

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

Parámetros

Parámetro Tipo Descripción
nombre string Nombre que se asignará al archivo de reglas. Por lo general, es un nombre de archivo corto que ayuda a identificar el archivo en un conjunto de reglas.
source cadena | Margen de seguridad Contenidos del archivo de reglas

Muestra:

Archivo de reglas

Una nueva instancia de archivo de reglas.

Ejemplo

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

SecurityRules.deleteRuleset()

Borra el Conjunto de reglas que se identifica con el nombre dado. El nombre de entrada debe ser la cadena de nombre corto sin el prefijo de ID del proyecto. Por ejemplo, para borrar el projects/project-id/rulesets/my-ruleset, pasa el nombre corto "my-ruleset". Se rechaza con un error not-found si no se puede encontrar el Ruleset especificado.

Firma:

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

Parámetros

Parámetro Tipo Descripción
nombre string Nombre de la Ruleset que se borrará.

Muestra:

Promesa<void>

Una promesa que se cumple cuando se borra Ruleset.

SecurityRules.getFirestoreRuleset()

Obtiene el conjunto de reglas que se aplica actualmente a Cloud Firestore. Se rechaza con un error not-found si no se aplica ningún conjunto de reglas en Firestore.

Firma:

getFirestoreRuleset(): Promise<Ruleset>;

Muestra:

Promesa<Conjunto de reglas>

Una promesa que se cumple con el conjunto de reglas de Firestore.

SecurityRules.getRuleset()

Obtiene el conjunto de reglas identificado mediante el nombre dado. El nombre de entrada debe ser la cadena de nombre corto sin el prefijo de ID del proyecto. Por ejemplo, para recuperar el projects/project-id/rulesets/my-ruleset, pasa el nombre corto "my-ruleset". Se rechaza con un error not-found si no se puede encontrar el Ruleset especificado.

Firma:

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

Parámetros

Parámetro Tipo Descripción
nombre string Nombre de la Ruleset que se recuperará.

Muestra:

Promesa<Conjunto de reglas>

Una promesa que se cumple con el Ruleset especificado.

SecurityRules.getStorageRuleset()

Obtiene el conjunto de reglas que se aplica actualmente a un bucket de Cloud Storage. Se rechaza con un error not-found si no se aplica ningún conjunto de reglas en el bucket.

Firma:

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

Parámetros

Parámetro Tipo Descripción
bucket string Nombre opcional del bucket de Cloud Storage que se recuperará. Si no se especifica, recupera el conjunto de reglas aplicado en el bucket predeterminado que se configuró a través de AppOptions.

Muestra:

Promesa<Conjunto de reglas>

Una promesa que se cumple con el conjunto de reglas de Cloud Storage.

SecurityRules.listRulesetMetadata()

Recupera una página de metadatos de conjunto de reglas.

Firma:

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

Parámetros

Parámetro Tipo Descripción
pageSize número Es el tamaño de la página, 100 si no está definido. Este también es el límite máximo permitido.
Tokendedelapáginasiguiente string El token de la página siguiente. Si no se especifica, muestra conjuntos de reglas que comienzan sin desplazamiento.

Muestra:

Promesa<RulesetMetadataList>

Una promesa que se cumple con una página de conjuntos de reglas.

SecurityRules.releaseFirestoreRuleset()

Aplica el conjunto de reglas del conjunto de reglas especificado a Cloud Firestore.

Firma:

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

Parámetros

Parámetro Tipo Descripción
conjunto de reglas cadena | RulesetMetadata Nombre del conjunto de reglas que se aplicará o un objeto RulesetMetadata que contenga el nombre.

Muestra:

Promesa<void>

Una promesa que se cumple cuando se lanza el conjunto de reglas.

SecurityRules.releaseFirestoreRulesetFromSource()

Crea un conjunto de reglas nuevo a partir de la fuente determinada y lo aplica a Cloud Firestore.

Firma:

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

Parámetros

Parámetro Tipo Descripción
source cadena | Margen de seguridad Fuente de las reglas a aplicar.

Muestra:

Promesa<Conjunto de reglas>

Una promesa que se cumple cuando se crea y se lanza el conjunto de reglas.

SecurityRules.releaseStorageRuleset()

Aplica el conjunto de reglas del conjunto de reglas especificado a un bucket de Cloud Storage.

Firma:

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

Parámetros

Parámetro Tipo Descripción
conjunto de reglas cadena | RulesetMetadata Nombre del conjunto de reglas que se aplicará o un objeto RulesetMetadata que contenga el nombre.
bucket string Nombre opcional del bucket de Cloud Storage al que se aplicarán las reglas. Si no se especifica, aplica el conjunto de reglas en el bucket predeterminado que se configuró mediante AppOptions.

Muestra:

Promesa<void>

Una promesa que se cumple cuando se lanza el conjunto de reglas.

SecurityRules.releaseStorageRulesetFromSource()

Crea un conjunto de reglas nuevo a partir de la fuente determinada y lo aplica a un bucket de Cloud Storage.

Firma:

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

Parámetros

Parámetro Tipo Descripción
source cadena | Margen de seguridad Fuente de las reglas a aplicar.
bucket string Nombre opcional del bucket de Cloud Storage al que se aplicarán las reglas. Si no se especifica, aplica el conjunto de reglas en el bucket predeterminado que se configuró mediante AppOptions.

Muestra:

Promesa<Conjunto de reglas>

Una promesa que se cumple cuando se crea y se lanza el conjunto de reglas.