SecurityRules class

อินเทอร์เฟซบริการ Firebase SecurityRules

ลายเซ็น:

export declare class SecurityRules 

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้ คีย์ตัวปรับแต่ง ประเภท คำอธิบาย
แอป แอป

เมธอด

วิธีการ คีย์ตัวปรับแต่ง คำอธิบาย
createRuleset(ไฟล์) สร้าง Ruleset ใหม่จาก RulesFile ที่ระบุ
createRulesFileFromSource(ชื่อ, แหล่งที่มา) สร้าง RuleFile โดยใช้ชื่อและแหล่งที่มาที่ระบุ และจะแสดงข้อผิดพลาดหากมีอาร์กิวเมนต์ใดไม่ถูกต้อง นี่คือการดำเนินการภายในและไม่เกี่ยวข้องกับการเรียก API เครือข่ายใดๆ
deleteRuleset(name) ลบชุดกฎที่ระบุโดยชื่อตัวนั้นๆ ชื่ออินพุตควรเป็นสตริงชื่อย่อโดยไม่มีคำนำหน้ารหัสโปรเจ็กต์ เช่น หากต้องการลบ projects/project-id/rulesets/my-ruleset ให้ส่งชื่อย่อว่า "my-ruleset" ปฏิเสธโดยมีข้อผิดพลาด not-found หากไม่พบ Ruleset ที่ระบุ
getFirestoreRuleset() รับ Ruleset ที่ใช้กับ Cloud Firestore ในขณะนี้ ปฏิเสธโดยมีข้อผิดพลาด not-found หากไม่มีการใช้ชุดกฎใน Firestore
getRuleset(name) รับชุดกฎที่ระบุตามชื่อที่ต้องการ ชื่ออินพุตควรเป็นสตริงชื่อย่อโดยไม่มีคำนำหน้ารหัสโปรเจ็กต์ เช่น หากต้องการดึงข้อมูล projects/project-id/rulesets/my-ruleset ให้ส่งชื่อย่อว่า "my-ruleset" ปฏิเสธโดยมีข้อผิดพลาด not-found หากไม่พบ Ruleset ที่ระบุ
getStorageRuleset(bucket) รับชุดกฎที่ใช้กับที่เก็บข้อมูล Cloud Storage ในปัจจุบัน ปฏิเสธโดยมีข้อผิดพลาด not-found หากไม่มีการใช้ชุดกฎในที่เก็บข้อมูล
listRulesetMetadata(pageSize, nextPageToken) เรียกข้อมูลหน้าของข้อมูลเมตาของชุดกฎ
releaseFirestoreRuleset(ruleset) ปรับใช้ชุดกฎ Ruleset ที่ระบุกับ Cloud Firestore
releaseFirestoreRulesetFromSource(source) สร้าง Ruleset ใหม่จากแหล่งที่มาที่กำหนด และใช้กับ Cloud Firestore
releaseStorageRuleset(ruleset, ที่เก็บข้อมูล) นำชุดกฎ Ruleset ที่ระบุไปใช้กับที่เก็บข้อมูล Cloud Storage
releaseStorageRulesetFromSource(แหล่งที่มา, ที่เก็บข้อมูล) สร้าง Ruleset ใหม่จากแหล่งที่มาที่กำหนด และใช้กับที่เก็บข้อมูล Cloud Storage

SecurityRule.app

ลายเซ็น:

readonly app: App;

SecurityRule.createRuleset()

สร้าง Ruleset ใหม่จาก RulesFile ที่ระบุ

ลายเซ็น:

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

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
ไฟล์ ไฟล์กฎ ไฟล์กฎที่จะรวมไว้ใน Ruleset ใหม่

การคืนสินค้า:

สัญญา<Ruleset>

คำมั่นสัญญาที่จะเติมเต็มด้วย Ruleset ที่สร้างขึ้นใหม่

SecurityRule.createRulesFileFromSource()

สร้าง RuleFile โดยใช้ชื่อและแหล่งที่มาที่ระบุ และจะแสดงข้อผิดพลาดหากมีอาร์กิวเมนต์ใดไม่ถูกต้อง นี่คือการดำเนินการภายในและไม่เกี่ยวข้องกับการเรียก API เครือข่ายใดๆ

ลายเซ็น:

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

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
name สตริง ชื่อที่จะกำหนดให้กับไฟล์กฎ โดยปกติแล้วจะเป็นชื่อไฟล์สั้นๆ ที่จะช่วยระบุไฟล์ในชุดกฎ
source สตริง | บัฟเฟอร์ เนื้อหาของไฟล์กฎ

การคืนสินค้า:

ไฟล์กฎ

อินสแตนซ์ไฟล์กฎใหม่

ตัวอย่าง

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

SecurityRule.deleteRuleset()

ลบชุดกฎที่ระบุโดยชื่อตัวนั้นๆ ชื่ออินพุตควรเป็นสตริงชื่อย่อโดยไม่มีคำนำหน้ารหัสโปรเจ็กต์ เช่น หากต้องการลบ projects/project-id/rulesets/my-ruleset ให้ส่งชื่อย่อว่า "my-ruleset" ปฏิเสธโดยมีข้อผิดพลาด not-found หากไม่พบ Ruleset ที่ระบุ

ลายเซ็น:

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

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
name สตริง ชื่อของ Ruleset ที่จะลบ

การคืนสินค้า:

คำสัญญา<โมฆะ>

คำสัญญาที่จะทำตามได้เมื่อลบ Ruleset

SecurityRule.getFirestoreRuleset()

รับ Ruleset ที่ใช้กับ Cloud Firestore ในขณะนี้ ปฏิเสธโดยมีข้อผิดพลาด not-found หากไม่มีการใช้ชุดกฎใน Firestore

ลายเซ็น:

getFirestoreRuleset(): Promise<Ruleset>;

การคืนสินค้า:

สัญญา<Ruleset>

คำมั่นสัญญาที่บรรลุผลได้ด้วยชุดกฎ Firestore

SecurityRules.getRuleset()

รับชุดกฎที่ระบุตามชื่อที่ต้องการ ชื่ออินพุตควรเป็นสตริงชื่อย่อโดยไม่มีคำนำหน้ารหัสโปรเจ็กต์ เช่น หากต้องการดึงข้อมูล projects/project-id/rulesets/my-ruleset ให้ส่งชื่อย่อว่า "my-ruleset" ปฏิเสธโดยมีข้อผิดพลาด not-found หากไม่พบ Ruleset ที่ระบุ

ลายเซ็น:

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

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
name สตริง ชื่อของ Ruleset ที่จะดึงข้อมูล

การคืนสินค้า:

สัญญา<Ruleset>

คำมั่นสัญญาที่ทำตาม Ruleset ที่ระบุ

SecurityRule.getStorageRuleset()

รับชุดกฎที่ใช้กับที่เก็บข้อมูล Cloud Storage ในปัจจุบัน ปฏิเสธโดยมีข้อผิดพลาด not-found หากไม่มีการใช้ชุดกฎในที่เก็บข้อมูล

ลายเซ็น:

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

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
ที่เก็บข้อมูล สตริง ชื่อที่ไม่บังคับของที่เก็บข้อมูล Cloud Storage ที่จะดึงข้อมูล หากไม่ระบุ จะเรียกข้อมูลชุดกฎที่ใช้กับที่เก็บข้อมูลเริ่มต้นที่กำหนดค่าผ่าน AppOptions

การคืนสินค้า:

สัญญา<Ruleset>

คำมั่นสัญญาที่บรรลุผลได้ด้วยชุดกฎ Cloud Storage

SecurityRule.listRulesetMetadata()

เรียกข้อมูลหน้าของข้อมูลเมตาของชุดกฎ

ลายเซ็น:

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

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
pageSize ตัวเลข ขนาดหน้าคือ 100 ถ้าไม่ระบุ ซึ่งเป็นจำนวนสูงสุดที่อนุญาตด้วย
โทเค็นหน้าถัดไป สตริง โทเค็นหน้าถัดไป หากไม่ได้ระบุ จะแสดงผลชุดกฎที่เริ่มต้นโดยไม่มีออฟเซ็ต

การคืนสินค้า:

Promise<RulesetMetadataList>

คำสัญญาที่เติมเต็มได้ด้วยหน้าชุดกฎ

SecurityRule.releaseFirestoreRuleset()

ปรับใช้ชุดกฎ Ruleset ที่ระบุกับ Cloud Firestore

ลายเซ็น:

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

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
ชุดกฎ สตริง | RulesetMetadata ชื่อของชุดกฎที่จะใช้หรือออบเจ็กต์ RulesetMetadata ที่มีชื่อ

การคืนสินค้า:

คำสัญญา<โมฆะ>

คำมั่นสัญญาที่จะเป็นไปตามเวลาที่ปล่อยชุดกฎ

SecurityRule.releaseFirestoreRulesetFromSource()

สร้าง Ruleset ใหม่จากแหล่งที่มาที่กำหนด และใช้กับ Cloud Firestore

ลายเซ็น:

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

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
source สตริง | บัฟเฟอร์ แหล่งที่มาของกฎที่จะใช้

การคืนสินค้า:

สัญญา<Ruleset>

คำมั่นสัญญาที่จะบรรลุผลเมื่อมีการสร้างและเปิดตัวชุดกฎ

SecurityRule.releaseStorageRuleset()

นำชุดกฎ Ruleset ที่ระบุไปใช้กับที่เก็บข้อมูล Cloud Storage

ลายเซ็น:

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

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
ชุดกฎ สตริง | RulesetMetadata ชื่อของชุดกฎที่จะใช้หรือออบเจ็กต์ RulesetMetadata ที่มีชื่อ
ที่เก็บข้อมูล สตริง ชื่อที่ไม่บังคับของที่เก็บข้อมูล Cloud Storage ที่จะใช้กฎ หากไม่ได้ระบุ ระบบจะใช้ชุดกฎในที่เก็บข้อมูลเริ่มต้นที่กำหนดค่าผ่าน AppOptions

การคืนสินค้า:

คำสัญญา<โมฆะ>

คำมั่นสัญญาที่จะเป็นไปตามเวลาที่ปล่อยชุดกฎ

SecurityRule.releaseStorageRulesetFromSource()

สร้าง Ruleset ใหม่จากแหล่งที่มาที่กำหนด และใช้กับที่เก็บข้อมูล Cloud Storage

ลายเซ็น:

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

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
source สตริง | บัฟเฟอร์ แหล่งที่มาของกฎที่จะใช้
ที่เก็บข้อมูล สตริง ชื่อที่ไม่บังคับของที่เก็บข้อมูล Cloud Storage ที่จะใช้กฎ หากไม่ได้ระบุ ระบบจะใช้ชุดกฎในที่เก็บข้อมูลเริ่มต้นที่กำหนดค่าผ่าน AppOptions

การคืนสินค้า:

สัญญา<Ruleset>

คำมั่นสัญญาที่จะบรรลุผลเมื่อมีการสร้างและเปิดตัวชุดกฎ