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