SecurityRules class

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:

Arquivo de regras

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.