https://github.com/apache/casbin-python-sqlalchemy-adapter
SQLAlchemy Adapter for PyCasbin
https://github.com/apache/casbin-python-sqlalchemy-adapter
abac acl adapter auth authz casbin orm pycasbin python rbac sql sqlalchemy
Last synced: 4 days ago
JSON representation
SQLAlchemy Adapter for PyCasbin
- Host: GitHub
- URL: https://github.com/apache/casbin-python-sqlalchemy-adapter
- Owner: apache
- License: apache-2.0
- Created: 2024-10-26T13:34:52.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2026-05-15T19:18:36.000Z (2 months ago)
- Last Synced: 2026-07-22T19:27:48.008Z (4 days ago)
- Topics: abac, acl, adapter, auth, authz, casbin, orm, pycasbin, python, rbac, sql, sqlalchemy
- Language: Python
- Homepage: https://github.com/casbin/pycasbin
- Size: 88.9 KB
- Stars: 7
- Watchers: 2
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
SQLAlchemy Adapter for PyCasbin
====
[](https://github.com/officialpycasbin/sqlalchemy-adapter/actions/workflows/build.yml)
[](https://coveralls.io/github/officialpycasbin/sqlalchemy-adapter)
[](https://pypi.org/project/sqlalchemy-adapter/)
[](https://pypi.org/project/sqlalchemy-adapter/)
[](https://pypi.org/project/sqlalchemy-adapter/)
[](https://pypi.org/project/sqlalchemy-adapter/)
[](https://pypi.org/project/sqlalchemy-adapter/)
SQLAlchemy Adapter is the [SQLAlchemy](https://www.sqlalchemy.org) adapter for [PyCasbin](https://github.com/casbin/pycasbin). With this library, Casbin can load policy from SQLAlchemy supported database or save policy to it.
Based on [Officially Supported Databases](http://www.sqlalchemy.org/), The current supported databases are:
- PostgreSQL
- MySQL
- SQLite
- Oracle
- Microsoft SQL Server
- Firebird
- Sybase
## Installation
```
pip install sqlalchemy_adapter
```
## Simple Example
You can save and load policy to database.
```python
import sqlalchemy_adapter
import casbin
adapter = sqlalchemy_adapter.Adapter('sqlite:///test.db')
e = casbin.Enforcer('path/to/model.conf', adapter)
sub = "alice" # the user that wants to access a resource.
obj = "data1" # the resource that is going to be accessed.
act = "read" # the operation that the user performs on the resource.
if e.enforce(sub, obj, act):
# permit alice to read data1
pass
else:
# deny the request, show an error
pass
```
By default, policies are stored in the `casbin_rule` table.
You can custom the table where the policy is stored by using the `table_name` parameter.
```python
import sqlalchemy_adapter
import casbin
custom_table_name = ""
# create adapter with custom table name.
adapter = sqlalchemy_adapter.Adapter('sqlite:///test.db', table_name=custom_table_name)
e = casbin.Enforcer('path/to/model.conf', adapter)
```
## Prevent Automatic Table Creation
By default, the adapter automatically creates the necessary database tables during initialization. If you want to use the adapter only as an intermediary without automatically creating tables, you can set the `create_table` parameter to `False`:
```python
import sqlalchemy_adapter
import casbin
# Create adapter without automatically creating tables
adapter = sqlalchemy_adapter.Adapter('sqlite:///test.db', create_table=False)
e = casbin.Enforcer('path/to/model.conf', adapter)
```
This is useful when:
- Tables are already created by your database migration system
- You want to manage table creation separately
- You are using the adapter as an intermediary between SQLAlchemy and your system
**Note:** When `create_table=False`, you are responsible for ensuring the required tables exist in the database before using the adapter.
### Getting Help
- [PyCasbin](https://github.com/casbin/pycasbin)
### License
This project is licensed under the [Apache 2.0 license](LICENSE).