A interface de serviço do Firebase SecurityRules
.
Assinatura:
export declare class SecurityRules
Propriedades
Propriedade | Modificadores | Tipo | Descrição |
---|---|---|---|
aplicativo | Aplicativo |
Métodos
Método | Modificadores | Descrição |
---|---|---|
criarRuleset(arquivo) | Cria um novo conjunto de regras a partir do RulesFile fornecido . | |
createRulesFileFromSource(nome,fonte) | Cria um RulesFile com o nome e a fonte fornecidos. Lança um erro se algum dos argumentos for inválido. Esta é uma operação local e não envolve chamadas de API de rede. | |
deleteRuleset(nome) | Exclui o conjunto de regras identificado pelo nome fornecido. O nome de entrada deve ser a sequência de nome abreviada sem o prefixo do ID do projeto. Por exemplo, para excluir projects/project-id/rulesets/my-ruleset , passe o nome abreviado "my-ruleset". Rejeita com um erro not-found se o Ruleset especificado não puder ser encontrado. | |
getFirestoreRuleset() | Obtém o conjunto de regras atualmente aplicado ao Cloud Firestore. Rejeita com erro not-found se nenhum conjunto de regras for aplicado no Firestore. | |
getRuleset(nome) | Obtém o conjunto de regras identificado pelo nome fornecido. O nome de entrada deve ser a sequência de nome abreviada sem o prefixo do ID do projeto. Por exemplo, para recuperar projects/project-id/rulesets/my-ruleset , passe o nome abreviado "my-ruleset". Rejeita com um erro not-found se o Ruleset especificado não puder ser encontrado. | |
getStorageRuleset(balde) | Obtém o conjunto de regras atualmente aplicado a um intervalo do Cloud Storage. Rejeita com um erro not-found se nenhum conjunto de regras for aplicado ao bucket. | |
listRulesetMetadata(pageSize, nextPageToken) | Recupera uma página de metadados do conjunto de regras. | |
releaseFirestoreRuleset(conjunto de regras) | Aplica o conjunto de regras especificado ao Cloud Firestore. | |
releaseFirestoreRulesetFromSource(fonte) | Cria um novo conjunto de regras a partir da origem fornecida e aplica-o ao Cloud Firestore. | |
releaseStorageRuleset(conjunto de regras, bucket) | Aplica o conjunto de regras especificado a um bucket do Cloud Storage. | |
releaseStorageRulesetFromSource(fonte, bucket) | Cria um novo conjunto de regras a partir da origem especificada e aplica-o a um intervalo do Cloud Storage. |
SecurityRules.app
Assinatura:
readonly app: App;
SecurityRules.createRuleset()
Cria um novo conjunto de regras a partir do RulesFile fornecido .
Assinatura:
createRuleset(file: RulesFile): Promise<Ruleset>;
Parâmetros
Parâmetro | Tipo | Descrição |
---|---|---|
arquivo | Arquivo de regras | Arquivo de regras a ser incluído no novo Ruleset . |
Retorna:
Promessa < Conjunto de regras >
Uma promessa que cumpre o Ruleset
recém-criado .
SecurityRules.createRulesFileFromSource()
Cria um RulesFile com o nome e a fonte fornecidos. Lança um erro se algum dos argumentos for inválido. Esta é uma operação local e não envolve chamadas de API de rede.
Assinatura:
createRulesFileFromSource(name: string, source: string | Buffer): RulesFile;
Parâmetros
Parâmetro | Tipo | Descrição |
---|---|---|
nome | corda | Nome a ser atribuído ao arquivo de regras. Geralmente é um nome de arquivo curto que ajuda a identificar o arquivo em um conjunto de regras. |
fonte | corda | Amortecedor | Conteúdo do arquivo de regras. |
Retorna:
Uma nova instância de arquivo de regras.
Exemplo
const source = '// Some rules source';
const rulesFile = admin.securityRules().createRulesFileFromSource(
'firestore.rules', source);
SecurityRules.deleteRuleset()
Exclui o conjunto de regras identificado pelo nome fornecido. O nome de entrada deve ser a sequência de nome abreviada sem o prefixo do ID do projeto. Por exemplo, para excluir o projects/project-id/rulesets/my-ruleset
, passe o nome abreviado "my-ruleset". Rejeita com um erro not-found
se o Ruleset
especificado não puder ser encontrado.
Assinatura:
deleteRuleset(name: string): Promise<void>;
Parâmetros
Parâmetro | Tipo | Descrição |
---|---|---|
nome | corda | Nome do Ruleset a ser excluído. |
Retorna:
Promessa<void>
Uma promessa que se cumpre quando o Ruleset
é excluído.
SecurityRules.getFirestoreRuleset()
Obtém o conjunto de regras atualmente aplicado ao Cloud Firestore. Rejeita com erro not-found
se nenhum conjunto de regras for aplicado no Firestore.
Assinatura:
getFirestoreRuleset(): Promise<Ruleset>;
Retorna:
Promessa < Conjunto de regras >
Uma promessa que cumpre o conjunto de regras do Firestore.
SecurityRules.getRuleset()
Obtém o conjunto de regras identificado pelo nome fornecido. O nome de entrada deve ser a sequência de nome abreviada sem o prefixo do ID do projeto. Por exemplo, para recuperar o projects/project-id/rulesets/my-ruleset
, passe o nome abreviado "my-ruleset". Rejeita com um erro not-found
se o Ruleset
especificado não puder ser encontrado.
Assinatura:
getRuleset(name: string): Promise<Ruleset>;
Parâmetros
Parâmetro | Tipo | Descrição |
---|---|---|
nome | corda | Nome do Ruleset a ser recuperado. |
Retorna:
Promessa < Conjunto de regras >
Uma promessa que cumpre o Ruleset
especificado .
SecurityRules.getStorageRuleset()
Obtém o conjunto de regras atualmente aplicado a um intervalo do Cloud Storage. Rejeita com um erro not-found
se nenhum conjunto de regras for aplicado ao bucket.
Assinatura:
getStorageRuleset(bucket?: string): Promise<Ruleset>;
Parâmetros
Parâmetro | Tipo | Descrição |
---|---|---|
balde | corda | Nome opcional do bucket do Cloud Storage a ser recuperado. Se não for especificado, recupera o conjunto de regras aplicado no bucket padrão configurado por meio de AppOptions . |
Retorna:
Promessa < Conjunto de regras >
Uma promessa que cumpre o conjunto de regras do Cloud Storage.
SecurityRules.listRulesetMetadata()
Recupera uma página de metadados do conjunto de regras.
Assinatura:
listRulesetMetadata(pageSize?: number, nextPageToken?: string): Promise<RulesetMetadataList>;
Parâmetros
Parâmetro | Tipo | Descrição |
---|---|---|
tamanho da página | número | O tamanho da página, 100 se indefinido. Este também é o limite máximo permitido. |
nextPageToken | corda | O token da próxima página. Se não for especificado, retorna conjuntos de regras começando sem qualquer deslocamento. |
Retorna:
Promessa< RegrasMetadataList >
Uma promessa que se cumpre com uma página de conjuntos de regras.
SecurityRules.releaseFirestoreRuleset()
Aplica o conjunto de regras especificado ao Cloud Firestore.
Assinatura:
releaseFirestoreRuleset(ruleset: string | RulesetMetadata): Promise<void>;
Parâmetros
Parâmetro | Tipo | Descrição |
---|---|---|
conjunto de regras | corda | Conjunto de regrasMetadados | Nome do conjunto de regras a ser aplicado ou um objeto RulesetMetadata que contém o nome. |
Retorna:
Promessa<void>
Uma promessa que se cumpre quando o conjunto de regras é lançado.
SecurityRules.releaseFirestoreRulesetFromSource()
Cria um novo conjunto de regras a partir da origem fornecida e aplica-o ao Cloud Firestore.
Assinatura:
releaseFirestoreRulesetFromSource(source: string | Buffer): Promise<Ruleset>;
Parâmetros
Parâmetro | Tipo | Descrição |
---|---|---|
fonte | corda | Amortecedor | Fonte de regras a serem aplicadas. |
Retorna:
Promessa < Conjunto de regras >
Uma promessa que se cumpre quando o conjunto de regras é criado e lançado.
SecurityRules.releaseStorageRuleset()
Aplica o conjunto de regras especificado a um intervalo do Cloud Storage.
Assinatura:
releaseStorageRuleset(ruleset: string | RulesetMetadata, bucket?: string): Promise<void>;
Parâmetros
Parâmetro | Tipo | Descrição |
---|---|---|
conjunto de regras | corda | Conjunto de regrasMetadados | Nome do conjunto de regras a ser aplicado ou um objeto RulesetMetadata que contém o nome. |
balde | corda | Nome opcional do bucket do Cloud Storage ao qual as regras serão aplicadas. Se não for especificado, aplica o conjunto de regras no bucket padrão configurado por meio de AppOptions . |
Retorna:
Promessa<void>
Uma promessa que se cumpre quando o conjunto de regras é lançado.
SecurityRules.releaseStorageRulesetFromSource()
Cria um novo conjunto de regras a partir da origem especificada e aplica-o a um intervalo do Cloud Storage.
Assinatura:
releaseStorageRulesetFromSource(source: string | Buffer, bucket?: string): Promise<Ruleset>;
Parâmetros
Parâmetro | Tipo | Descrição |
---|---|---|
fonte | corda | Amortecedor | Fonte de regras a serem aplicadas. |
balde | corda | Nome opcional do bucket do Cloud Storage ao qual as regras serão aplicadas. Se não for especificado, aplica o conjunto de regras no bucket padrão configurado por meio de AppOptions . |
Retorna:
Promessa < Conjunto de regras >
Uma promessa que se cumpre quando o conjunto de regras é criado e lançado.