Passer au contenu principal

Adapters

Dans Casbin, le stockage des politiques est implémenté sous forme d'adaptateur (alias middleware pour Casbin). Un utilisateur de Casbin peut utiliser un adaptateur pour charger des règles de politique à partir d'un stockage (alias LoadPolicy()), ou pour enregistrer des règles de politique dans celui-ci (alias SavePolicy()). للحفاظ على الوزن الخفيف، لا نضع رمز المحول في المكتبة الرئيسية.

المحولات المدعومة​

يتم توفير قائمة كاملة بمحولات Casbin أدناه. يُرحب بأي مساهمة من الجهات الخارجية على محول جديد، يرجى إبلاغنا وسنضعه في هذه القائمة:

AdapterTypeAuthorAutoSaveDescription
File Adapter (built-in)FileCasbin❌For .CSV (Comma-Separated Values) files
Filtered File Adapter (built-in)File@faceless-saint❌For .CSV (Comma-Separated Values) files with policy subset loading support
SQL AdapterSQL@Blank-Xu✅MySQL, PostgreSQL, SQL Server, SQLite3 are supported in master branch and Oracle is supported in oracle branch by database/sql
Xorm AdapterORMCasbin✅MySQL, PostgreSQL, TiDB, SQLite, SQL Server, Oracle are supported by Xorm
GORM AdapterORMCasbin✅MySQL, PostgreSQL, Sqlite3, SQL Server are supported by GORM
GORM Adapter ExORMCasbin✅MySQL, PostgreSQL, Sqlite3, SQL Server are supported by GORM
Ent AdapterORMCasbin✅MySQL, MariaDB, PostgreSQL, SQLite, Gremlin-based graph databases are supported by ent ORM
Beego ORM AdapterORMCasbin✅MySQL, PostgreSQL, Sqlite3 are supported by Beego ORM
SQLX AdapterORM@memwey✅MySQL, PostgreSQL, SQLite, Oracle are supported by SQLX
Sqlx AdapterORM@Blank-Xu✅MySQL, PostgreSQL, SQL Server, SQLite3 are supported in master branch and Oracle is supported in oracle branch by sqlx
GF ORM AdapterORM@vance-liu✅MySQL, SQLite, PostgreSQL, Oracle, SQL Server are supported by GoFrame ORM
GoFrame ORM AdapterORM@kotlin2018✅MySQL, SQLite, PostgreSQL, Oracle, SQL Server are supported by GoFrame ORM
gf-adapterORM@zcyc✅MySQL, SQLite, PostgreSQL, Oracle, SQL Server are supported by GoFrame ORM
Gdb AdapterORM@jxo-me✅MySQL, SQLite, PostgreSQL, Oracle, SQL Server are supported by GoFrame ORM
GoFrame V2 AdapterORM@hailaz✅MySQL, SQLite, PostgreSQL, Oracle, SQL Server are supported by GoFrame ORM
Bun AdapterORM@JunNishimura✅MySQL, SQLite, PostgreSQL, SQL Server are supported by Bun ORM
Filtered PostgreSQL AdapterSQLCasbin✅For PostgreSQL
Filtered pgx AdapterSQL@pckhoi✅PostgreSQL is supported by pgx
PostgreSQL AdapterSQL@cychiuae✅For PostgreSQL
RQLite AdapterSQLEDOMO Systems✅For RQLite
MongoDB AdapterNoSQLCasbin✅For MongoDB based on MongoDB Go Driver
RethinkDB AdapterNoSQL@adityapandey9✅For RethinkDB
Cassandra AdapterNoSQLCasbin❌For Apache Cassandra DB
DynamoDB AdapterNoSQLHOOQ❌For Amazon DynamoDB
DynacasbinNoSQLNewbMiao✅For Amazon DynamoDB
ArangoDB AdapterNoSQL@adamwasila✅For ArangoDB
Amazon S3 AdapterCloudSoluto❌For Minio and Amazon S3
Go CDK AdapterCloud@bartventer✅Adapter based on Go Cloud Dev Kit that supports: Amazon DynamoDB, Azure CosmosDB, GCP Firestore, MongoDB, In-Memory
Azure Cosmos DB AdapterCloud@spacycoder✅For Microsoft Azure Cosmos DB
GCP Firestore AdapterCloud@reedom❌For Google Cloud Platform Firestore
GCP Cloud Storage AdapterCloudqurami❌For Google Cloud Platform Cloud Storage
GCP Cloud Spanner AdapterCloud@flowerinthenight✅For Google Cloud Platform Cloud Spanner
Consul AdapterKV store@ankitm123❌For HashiCorp Consul
Redis Adapter (Redigo)KV storeCasbin✅For Redis
Redis Adapter (go-redis)KV store@mlsen✅For Redis
Etcd AdapterKV store@sebastianliu❌For etcd
BoltDB AdapterKV store@speza✅For Bolt
Bolt AdapterKV store@wirepair❌For Bolt
BadgerDB AdapterKV store@inits✅For BadgerDB
Protobuf AdapterStreamCasbin❌For Google Protocol Buffers
JSON AdapterStringCasbin❌For JSON
String AdapterString@qiangmzsx❌For String
HTTP File AdapterHTTP@h4ckedneko❌For http.FileSystem
FileSystem AdapterFile@naucon❌For fs.FS and embed.FS
note
  1. إذا تم استدعاء casbin.NewEnforcer() بمحول صريح أو ضمني، سيتم تحميل السياسة تلقائيًا.
  2. يمكنك استدعاء e.LoadPolicy() لإعادة تحميل قواعد السياسة من التخزين.
  3. Si l'adaptateur ne prend pas en charge la fonctionnalité Auto-Save, les règles de politique ne peuvent pas être enregistrées automatiquement dans le stockage lorsque vous ajoutez ou supprimez des politiques. Vous devez appeler SavePolicy() manuellement pour enregistrer toutes les règles de politique.

أمثلة​

Voici plusieurs exemples :

محول الملف (مدمج)​

Ci-dessous est illustré comment initialiser un enforcer à partir de l'adaptateur de fichier intégré :

import "github.com/casbin/casbin"

e := casbin.NewEnforcer("examples/basic_model.conf", "examples/basic_policy.csv")

C'est la même chose que :

import (
    "github.com/casbin/casbin"
    "github.com/casbin/casbin/file-adapter"
)

a := fileadapter.NewAdapter("examples/basic_policy.csv")
e := casbin.NewEnforcer("examples/basic_model.conf", a)

محول MySQL​

Ci-dessous est illustré comment initialiser un enforcer à partir de la base de données MySQL. Il se connecte à une base de données MySQL sur 127.0.0.1:3306 avec l'utilisateur root et un mot de passe vide.

import (
    "github.com/casbin/casbin"
    "github.com/casbin/mysql-adapter"
)

a := mysqladapter.NewAdapter("mysql", "root:@tcp(127.0.0.1:3306)/")
e := casbin.NewEnforcer("examples/basic_model.conf", a)

Utilisez votre propre adaptateur de stockage.​

يمكنك استخدام محولك الخاص كما يلي:

import (
    "github.com/casbin/casbin"
    "github.com/your-username/your-repo"
)

a := yourpackage.NewAdapter(params)
e := casbin.NewEnforcer("examples/basic_model.conf", a)

Migrer/Convertir entre différents adaptateurs.​

Si vous souhaitez convertir l'adaptateur de A à B, vous pouvez procéder comme suit :

  1. Charger la politique de A en mémoire.
e, _ := NewEnforcer(m, A)

أو

e.SetAdapter(A)
e.LoadPolicy()
  1. Convertir votre adaptateur de A à B.
e.SetAdapter(B)
  1. Sauvegarder la politique de la mémoire vers B.
e.SavePolicy()

Charger/Sauvegarder à l'exécution.​

Vous pouvez également souhaiter recharger le modèle, recharger la politique ou enregistrer la politique après l'initialisation :

// Reload the model from the model CONF file.
e.LoadModel()

// Reload the policy from file/database.
e.LoadPolicy()

// Save the current policy (usually after changed with Casbin API) back to file/database.
e.SavePolicy()

حفظ تلقائي​

Il existe une fonctionnalité appelée Auto-Save pour les adaptateurs. Lorsqu'un adaptateur prend en charge Auto-Save, cela signifie qu'il peut prendre en charge l'ajout d'une seule règle de politique dans le stockage, ou la suppression d'une seule règle de politique du stockage. Ceci est différent de SavePolicy(), car ce dernier supprimera toutes les règles de politique dans le stockage et enregistrera toutes les règles de politique de l'exécuteur Casbin dans le stockage. Ainsi, cela peut poser des problèmes de performance lorsque le nombre de règles de politique est important.

Lorsque l'adaptateur prend en charge Auto-Save, vous pouvez activer cette option via la fonction Enforcer.EnableAutoSave(). L'option est activée par défaut (si l'adaptateur la prend en charge).

note
  1. La fonctionnalité Auto-Save est facultative. Un adaptateur peut choisir de l'implémenter ou non.
  2. Auto-Save ne fonctionne que pour un enforcer Casbin lorsque l'adaptateur utilisé par l'enforcer le prend en charge.
  3. Consultez la colonne Auto-Save dans la liste des adaptateurs ci-dessus pour voir si Auto-Save est pris en charge par un adaptateur.

Voici un exemple sur la façon d'utiliser Auto-Save :

import (
    "github.com/casbin/casbin"
    "github.com/casbin/xorm-adapter"
    _ "github.com/go-sql-driver/mysql"
)

// By default, the AutoSave option is enabled for an enforcer.
a := xormadapter.NewAdapter("mysql", "mysql_username:mysql_password@tcp(127.0.0.1:3306)/")
e := casbin.NewEnforcer("examples/basic_model.conf", a)

// Disable the AutoSave option.
e.EnableAutoSave(false)

// Because AutoSave is disabled, the policy change only affects the policy in Casbin enforcer,
// it doesn't affect the policy in the storage.
e.AddPolicy(...)
e.RemovePolicy(...)

// Enable the AutoSave option.
e.EnableAutoSave(true)

// Because AutoSave is enabled, the policy change not only affects the policy in Casbin enforcer,
// but also affects the policy in the storage.
e.AddPolicy(...)
e.RemovePolicy(...)

Pour plus d'exemples, veuillez consulter : https://github.com/casbin/xorm-adapter/blob/master/adapter_test.go

Comment écrire un adaptateur​

Tous les adaptateurs doivent implémenter l'interface Adapter en fournissant au moins deux méthodes obligatoires : LoadPolicy(model model.Model) error et SavePolicy(model model.Model) error.

Les trois autres fonctions sont facultatives. Elles doivent être implémentées si l'adaptateur prend en charge la fonctionnalité Auto-Save.

MéthodeTypeDescription
ChargerPolitique()obligatoireCharger toutes les règles de politique à partir du stockage
SauvegarderPolitique()obligatoireSauvegarder toutes les règles de politique dans le stockage
AjouterPolitique()optionnelAjouter une règle de politique au stockage
RemovePolicy()optionnelإزالة قاعدة سياسة من التخزين
إزالةالسياسةالمصفاة()اختياريإزالة قواعد السياسة التي تطابق الفلتر من التخزين
note

Si un adaptateur ne prend pas en charge Sauvegarde automatique, il doit fournir une implémentation vide pour les trois fonctions optionnelles. إليك مثال لـ Golang:

// AddPolicy adds a policy rule to the storage.
func (a *Adapter) AddPolicy(sec string, ptype string, rule []string) error {
    return errors.New("not implemented")
}

// RemovePolicy removes a policy rule from the storage.
func (a *Adapter) RemovePolicy(sec string, ptype string, rule []string) error {
    return errors.New("not implemented")
}

// RemoveFilteredPolicy removes policy rules that match the filter from the storage.
func (a *Adapter) RemoveFilteredPolicy(sec string, ptype string, fieldIndex int, fieldValues ...string) error {
    return errors.New("not implemented")
}

Le validateur Casbin ignorera l'erreur non implémenté lors de l'appel de ces trois fonctions optionnelles.

Il y a des détails sur la façon d'écrire un adaptateur.

  • بنية البيانات. L'adaptateur doit prendre en charge la lecture d'au moins six colonnes.
  • اسم قاعدة البيانات. Le nom de la base de données par défaut doit être casbin.
  • اسم الجدول. Le nom de la table par défaut doit être casbin_rule.
  • عمود Ptype. Le nom de cette colonne doit être ptype au lieu de p_type ou Ptype.
  • La définition de la table doit être (id int clé primaire, ptype varchar, v0 varchar, v1 varchar, v2 varchar, v3 varchar, v4 varchar, v5 varchar).
  • L'index de clé unique doit être construit sur les colonnes ptype,v0,v1,v2,v3,v4,v5.
  • LoadFilteredPolicy nécessite un filter en paramètre. يجب أن يكون الفلتر شيئًا مثل هذا.
{
    "p":[ [ "alice" ], [ "bob" ] ],
    "g":[ [ "", "book_group" ], [ "", "pen_group" ] ],
    "g2":[ [ "alice" ] ]
}

Qui est responsable de créer la base de données (DB) ?​

وفقًا للاتفاقية، يجب أن يكون المحول قادرًا على إنشاء قاعدة بيانات تسمى casbin تلقائيًا إذا لم تكن موجودة واستخدامها لتخزين السياسة. Veuillez utiliser l'adaptateur Xorm comme implémentation de référence : https://github.com/casbin/xorm-adapter

Adaptateur de Contexte​

ContextAdapter fournit une interface contextuelle pour les adaptateurs Casbin.

Grâce au contexte, vous pouvez implémenter des fonctionnalités telles que le contrôle du délai d'attente pour l'API de l'Adaptateur.

مثال​

gormadapter prend en charge l'adaptateur avec contexte, ci-dessous un exemple de contrôle du délai d'attente implémenté à l'aide du contexte.

ca, _ := NewContextAdapter("mysql", "root:@tcp(127.0.0.1:3306)/", "casbin")
// Limited time 300s
ctx, cancel := context.WithTimeout(context.Background(), 300*time.Microsecond)
defer cancel()

err := ca.AddPolicyCtx(ctx, "p", "p", []string{"alice", "data1", "read"})
if err != nil {
    panic(err)
}

كيفية كتابة محول سياق​

L'API ContextAdapter a seulement une couche supplémentaire de traitement de contexte par rapport à l'API Adapter ordinaire,

Une référence simple à gormadapter : adapter.go