Policy Storage

Casbin implements policy storage through adapters.

تحميل السياسة من ملف .CSV

Loading from a CSV file is the standard approach. This method is straightforward for beginners and convenient when seeking help from the Casbin team.

Here's an example CSV file examples/rbac_policy.csv:

p, alice, data1, read
p, bob, data2, write
p, data2_admin, data2, read
p, data2_admin, data2, write
g, alice, data2_admin

ملاحظة

When CSV fields contain commas, wrap them in double quotes:

p, alice, "data1,data2", read    --correct
p, alice, data1,data2, read        --incorrect (the whole phrase "data1,data2" should be wrapped in double quotes)

When fields contain both commas and double quotes, wrap the field in double quotes and escape embedded quotes by doubling them:

p, alice, data, "r.act in (""get"", ""post"")"        --correct
p, alice, data, "r.act in ("get", "post")"            --incorrect (you should use "" to escape "")

المشكلة ذات الصلة: casbin#886

واجهة برمجة تطبيقات Adapter

الطريقة	النوع	الوصف
LoadPolicy()	أساسي	تحميل جميع قواعد السياسة من التخزين
SavePolicy()	أساسي	حفظ جميع قواعد السياسة إلى التخزين
AddPolicy()	اختياري	إضافة قاعدة سياسة إلى التخزين
RemovePolicy()	اختياري	إزالة قاعدة سياسة من التخزين
RemoveFilteredPolicy()	اختياري	إزالة قواعد السياسة التي تطابق الفلتر من التخزين

تنسيق تخزين قاعدة البيانات

ملف السياسة الخاص بك

p, data2_admin, data2, read
p, data2_admin, data2, write
g, alice, admin

الهيكل المقابل لقاعدة البيانات (مثل MySQL)

id	ptype	v0	v1	v2
1	p	data2_admin	data2	read
2	p	data2_admin	data2	write
3	g	alice	admin

معنى كل عمود

id: Database primary key, not part of the Casbin policy. Generation method depends on the adapter implementation.
ptype: Corresponds to p, g, g2, etc.
v0-v5: Generic column names that map to policy CSV values from left to right. The number of columns depends on your policy definition. Most adapters implement 6 columns, though theoretically unlimited columns are possible. Submit an issue to the adapter repository if you need more columns.