Repository files navigation

This project brings a backend server with its frontend for managing authorizations.

You can use both Role-Based Acccess Control (RBAC) and Attribute-Based Access Control (ABAC).

🌍 A centralized backend for all your applications authorizations

🙋‍♂️ Supports Role-Based Access Control (RBAC)

📌 Supports Attribute-Based Access Control (ABAC)

⚙️ Multiple language SDKs available

✅ Reliable: Authz uses Authz itself for managing its own internal authorizations

🔍 Audit: We log each check decisions and which policy matched

🔐 Single Sign-On: Use your enterprise SSO to log into the web UI, using OpenID Connect

🕵️‍♂️ Observability: Retrieve metrics and tracing data into your prefered tools

More information onauthz.fr

Authorization is simple: aprincipal wants to make anaction on aresource. That's it.

Authz allows you to manage all the authorizations you want to manage. All of them, centralized in a single application.

All you need to do is to host the backend server (a Go single binary), the frontend (static files) if you want it and use our SDKs.

All data are stored in a SQL database. We currently support:

• PostgreSQL
• MySQL
• SQLite

You can run a development environment using ourdocker-compose.mysql.yaml anddocker-compose.postgres.yaml files. Or, you can see below to run an example using SQLite.

In order to help you, we have the following available SDKs:

• Go -pkg.go.dev
• Python -pypi
• PHP -packagist
• NodeJS -npmjs

Please check their documentations for detailled usage. They all usegRPC for communicating with the Authz backend (server-to-server).

More SDKs are coming soon.

The best way to start trying Authz is to use the following standalone Docker image:

$ docker run --rm \    -e database_driver=sqlite \    -e database_name=:memory: \    -p 8080:8080 \    -p 8081:8081 \    -p 3000:80 \    ekofr/authz:v0.8.4-standalone

Here, we use SQLite in-memory as database.

Frontend will be available underhttp://localhost:3000 with default credentials:admin /changeme.

Alternatively, we also have separatedbackend andfrontend Docker images available here:https://hub.docker.com/repository/docker/ekofr/authz.

More technical documentations are available athttps://docs.authz.fr.

For more information about backend, please refer to theBackend README file.

For more information about frontend, please refer to theFrontend README file.

Please feel free to contribute on this project and do not hesitate to open an issue if you want to discuss about a feature.