📚 Permissions (access control) in web apps
At Wasp, we are working on a config language / DSL for building web apps that integrates with React & Node.js.
This requires us to deeply understand different parts of what constitutes a web app, in order to be able to model them in our DSL.
Recently our focus was on access control, and I decided to capture the learnings in this blog post, to help others quickly get up to speed on how to do access control in web apps.
So, if you are new to access control in web apps, or have been doing it for some time but want to get a better idea of standard practices, read along!
Quick overview of what this blog post covers:
- Permissions, yay! Wait, what are they though? (quick overview of basic terms)
- Where do we check permissions in a web app: frontend vs backend vs db
- Common approaches (RBAC, ABAC, …)
- OWASP recommendations
- Implementing access control in practice
1. Permissions, yay! Wait, what are they though?
Unless your web app is mostly about static content or is a form of art, it will likely have a notion of users and user accounts.
In such a case, you will need to know which user has permissions to do what -> who can access which resources, and who can execute which operations.
Some common examples of permissions in action:
- User can access only their own user account.
- If the user is an admin, they can ban other users’ accounts.
- User can read other users’ articles, but can't modify them.
- The title and description of the article behind the paywall are publicly accessible, but the content is not.
- User can send an email invitation to up to 10 future users per day.
Aha, you mean access control! Sorry, authorization! Hmm, authentication?
There are different terms out there (authentication, authorization, access control, permissions) that are often confused for each other, so let's quickly clarify what each one of them stands for.
1) Authentication (or as cool kids would say: authN)
Act of verifying the user's identity.
Answers the question "Who are they?"
A: Knock Knock
B: Who is it?
B: User who?
A: Authorization: Basic myusername:mypassword
-> yes, you noticed correctly, this is an example of common authentication method but HTTP header is called "Authorization"! Weird! But it all makes sense if you squint hard enough: (https://stackoverflow.com/questions/30062024/why-is-the-http-header-for-authentication-called-authorization).
2) Authorization (or as cool kids would say: authZ)
Process of determining access rights that user has.
Answers the question "Are they allowed to do this?"
Normally you will want the user to be authenticated at this point already, so you have information about them based on which you will decide if they are allowed to do something.
3) Access Control
A higher-level term (compared to authN and authZ) that encompasses the whole process of ensuring that only allowed parties can access specific resources (controlling access to resources -> access control).
Often consists of authentication and/or authorization as its steps.
Also often used in the wild interchangeably with just "authorization".
Reference (OWASP): https://www.cgisecurity.com/owasp/html/ch08.html
A more general/informal term, closest in meaning to "authorization" when used in the context of computer science.
Permission to access a resource is called authorization.
Let’s see these terms used in a sentence by observing the following imagined pull request (PR):
Title: Added access control to the app.
I implemented a way for users to authenticate via email and password or via Google.
On the server-side, I added permission checks to most of our REST API handlers, to ensure an authenticated user is authorized to execute them.
If the user is not authorized, we throw an HTTP error 403.
There are also some public parts of REST API where the user doesn’t have to be authenticated.
2. Where do we check permissions in a web app: frontend vs backend vs database
We explained a bunch of terms, let's see now how access permission checks are actually done in practice!
In a typical web app, you will have a frontend, backend (server), and database.
The frontend will be issuing commands to the server, which then executes operations and possibly modifies the database (on their behalf). Since users don’t have direct access to the database, and since the frontend is inherently not secure, that leaves the server as the central place where all the crucial access control needs to happen.
By frontend we mean web client -> code (e.g. JS) that executes in the browser.
The frontend is here to help users issue commands towards the server via which users can access and/or modify the resources of our web app (which are most often stored in the database).
Since users can manipulate the frontend code as they wish, we can't really do any permissions checks in the frontend code, we can't trust it!
Any permission checks we do on the frontend, we will need to repeat on the server in any case.
If that is so, should we at all check permissions on the frontend, and what is the purpose of that?
The main reason for doing any permissions checks on the frontend is ergonomics/user experience -> by having UI focus only on resources they can change, we make it easier for users to understand what they can do in our web app and make sure they don't waste time on trying to describe complex operations that server will then not be able to execute.
So, for example, our frontend code can hide/omit certain fields in the UI form if the user shouldn't be able to access them, it can prevent opening certain pages, or hide/omit certain buttons if they trigger operations that the user is not allowed to perform.
Takeaway: Permission checks on frontend are not there for security, but only for ergonomics / improving user experience.
The server is a crucial place to implement access control. It exposes an API that the frontend (browser) and/or other services consume. While doing that, they authenticate with the server, so that server knows who they are, and then they ask (i.e. via REST API or GraphQL API) the server to execute certain operations (i.e. creating, updating, or fetching something). It is the server’s job to figure out if they are allowed (authorized) to perform those operations (on specified resources / with provided arguments) and to reject them if they are not.
At its core, permissions checks on the server are here to check for each API endpoint if the caller is allowed to execute it. Often they are executed at the very start of the API endpoint logic, but often they are also intertwined with the rest of the endpoint handler logic.
Example of doing permission check at the start of API endpoint (is user authenticated) and then also doing another check as part of the database query (is user owner of the article they are trying to delete).
Besides defining checks at API/operation level, they are also often defined at the data/model level. This means that they are tied to specific data models (normally from the database), as part of data access logic (ORM), and are defining who can access specific field(s), or even the whole data model.
Example of attaching permission checks to the data model directly in the GraphQL schema (from this blog post):
For a more sophisticated RBAC approach, with an additional layer of indirection (permissions), read on.
Usually, users don’t have direct access to the database at all, instead, they affect it via the server. In such a case, there is no need to do specific database access control besides normal constraints that you will have in your DB to ensure data model integrity, like uniqueness, validations, and similar. That said, in some situations, you might want to do it, but we will not get into that in this article.
3. Common approaches (RBAC, ABAC, …)
The most common approaches to access control are RBAC (Role-Based Access Control) and ABAC (Attribute-Based Access Control), with RBAC having the strong lead (but ABAC is picking up).
Although less popular, we will also shortly mention ReBAC as an “in-between” option.
RBAC - Role-based access control
Roles rule :D! In RBAC, roles are the central concept. Some example roles might be
moderator, …. When determining if a certain user has access, we check their roles and determine their access rights based on it. For example,
admin can delete other users, articles, and projects, but
guest can’t modify any resources, only read articles.
Pro advice (thanks Karan!): While we could be checking the user’s roles directly in the permission checks, it is even better (and recommended by OWASP) to add a layer of indirection → permissions. So roles are attached to users, permissions are attached to roles, and permission checks check permissions (who would expect that :)!?).
For example, a user might have role
admin, and role
admin has permissions
deleteArticle attached to it. Then, when determining if a user can delete the article, we first fetch his role, then we fetch the permissions attached to that role, and finally check if
deleteArticle is present among those → if so, they can continue with the deletion!
This way, if we decide a certain role should have more or fewer permissions, we just add or remove the permission in question to the role, and that is it! We don’t have to go through every permission check and update its logic (which we would have to do if we were checking directly against roles).
RBAC is popular because it is relatively simple and it reflects the basic business domain pretty well - often we are thinking in the terms of roles in the real world, so it is easy to grasp and understand. There are plenty of solutions and frameworks out there that implement RBAC.
While a good match for many common use cases, there is a drawback to RBAC - when access control becomes complex (which usually happens as the web app evolves and grows big), RBAC sometimes fails in offering needed granularity in an elegant way, resulting in unwieldy and overly-complex access control logic.
ABAC - Attribute-based access control
In ABAC, key idea is that you define a bunch of access control rules where each rule takes different “attributes” as input. When you need to check if a user is authorized to do smth, you run the rules and if all the rules pass, it is a go, but if a single rule fails, it is a no go.
Rule attributes can be anything, but usually, they fall into 4 categories:
- Subject: information about a user (i.e. user’s id or name)
- Action: operation they want to perform (i.e. reading an Article)
- Object: resources they want to operate on (i.e. an Article),
- Environment/context: i.e. current time of the day or number of previous requests that the user did in the last hour.
Let’s observe the example from before where we wanted to know if user is allowed to delete an article.
In ABAC, we could define an action “deleteArticle”, and then define a rule that takes user(subject), action, object, and additional context. That rule would check if action is “deleteArticle” → if so, it would evaluate if user is allowed to delete the article specified as an object, by checking some properties of user, maybe even role, or by checking if user is owner of that article.
Then, when user actually issues a command to delete an article, we would ask our access control system to run it against all the rules it has, while giving it the (user, “deleteArticle”, article, context) tuple → most of the rules would say all is ok since they are not concerned with “deleteArticle” action, but the ones that are (like the one we defined above) must all pass in order to actually allow the access.
ABAC is very flexible and general as an approach, and you could easily implement RBAC (and many other approaches) in ABAC (by checking the user’s role as one of the attributes) → therefore it is more general/expressive than RBAC.
However, ABAC is more complex to implement, and it is also more expensive performance-wise, due to needing to check multiple rules each time that access control check is being performed.
ReBAC - Relationship-based access control
Roles (RBAC) can be lacking when you need to grant access based on relationship-related questions like “is this user owner of this article” or “does this user belong to this workspace”.
While ABAC can easily handle this, you could also consider it a bit too powerful if all you need to describe are relationships → and this is where ReBAC comes in.
While there are different ways one could go about implementing ReBAC, the simplest one is to build on top of RBAC by introducing a concept of “relationship” rules to your access control logic and then checking those alongside the roles. So RBAC with a dash of ABAC (focused on relationships).
4. OWASP recommendations
When looking online for “official”/standardized recommendations on how to do access control in web apps, you will most likely find resources produced by OWASP.
Definition of OWASP: The Open Web Application Security Project® (OWASP) is a nonprofit foundation that works to improve the security of software.
I found that they have quite a few resources on how to do access control in web apps, the most interesting being the following:
From their materials I extracted a couple of main points that made the most sense to me:
- Centralize the access control logic so it is easy to review.
- Deny access by default.
- Prefer ABAC over RBAC.
5. Implementing access control in practice
Here’s a Reddit poll I did on r/webdev.
An interesting finding is that even though the sample is pretty small, it is clear that devs prefer RBAC over OWASP-recommended ABAC.
I believe this is due to 2 main reasons: RBAC is simpler + there are more libraries/frameworks out there supporting RBAC than ABAC (again, due to it being simpler).
It does seem that ABAC is picking up recently though, so it would be interesting to repeat this poll in the future and see what changes.
Often, we add permission checks to our web app one by one, as needed. For example, if we are using NodeJS with ExpressJS for our server and writing middleware that handles HTTP API requests, we will add a bit of logic into that middleware that does some checks to ensure a user can actually perform that action. Or maybe we will embed “checks” into our database queries so that we query only what the user is allowed to access. Often a combination.
What can be dangerous with such an organic approach is the complexity that arises as the codebase grows - if we don’t put enough effort into centralizing and structuring our access control logic, it can become very hard to reason about it and to do consistent updates to it, leading to mistakes and vulnerabilities.
Imagine having to modify the web app so that user can now only read their own articles and articles of their friends, while before they were allowed to read any article. If there is only one place where we can make this update, we will have a nice time, but if there are a bunch of places and we need to hunt those down first and then make sure they are all updated in the same way, we are in for a lot of trouble and lot of space to make mistakes.
Using an existing solution
Instead of figuring out on our own how to structure the access control code, often it is a better choice to use an existing access control solution! Besides not having to figure and implement everything on your own, another big advantage is that these solutions are battle-tested, which is very important for the code dealing with the security of your web app.
We can roughly divide these solutions into frameworks and (external) providers, where frameworks are embedded into your web app and shipped together with it, while providers are externally hosted and usually paid services.
A couple of popular solutions:
https://casbin.org/ (multiple approaches, multiple languages, provider)
- Open source authZ library that has support for many access control models (ACL, RBAC, ABAC, …) and many languages (Go, Java, Node.js, JS, Rust, …). While somewhat complex, it is also powerful and flexible. They also have their Casdoor platform, which is authN and authZ provider.
- Open source JS/TS library for ABAC. CASL gives you a nice way to define the ABAC rules in your web / NodeJS code, and then also check them and call them. It has a bunch of integrations with popular solutions like React, Angular, Prisma, Mongoose, … .
https://github.com/CanCanCommunity/cancancan (Ruby on Rails ABAC)
- Same like casl.js, but for Ruby on Rails! Casl.js was actually inspired and modeled by cancancan.
- Popular open-source Ruby library focused around the notion of policies, giving you the freedom to implement your own approach based on that.
- Open source authN and authZ framework for Spring (Java).
- A generic, approachable open source framework for building rule-based systems in Django (Python).
- Auth0 has been around for some time and is probably the most popular authN provider out there. While authN is their main offering (they give you SDKs for authentication + they store user profiles and let you manage them through their SaaS), they also allow you to define authZ to some degree, via RBAC and policies.
https://www.osohq.com/ (provider, DSL)
- OSO is an authZ provider, unique in a way that they have a specialized language for authorization (DSL, called Polar) in which you define your authorization rules. They come with support for common approaches (e.g. RBAC, ABAC, ReBAC) but also support custom ones. Then, you can use their open source library embedded in your application, or use their managed cloud offering.
- Relatively new authZ provider, they have a dashboard where you can manage your rules in a central location and then use them from multiple languages via their SDKs, even on the client to perform UI checks. Rules can also be managed programmatically via SDK.
- AuthZed brings a specialized SpiceDB permissions database which they use as a centralized place for storing and managing rules. Then, you can use their SDKs to query, store, and validate application permissions.
- Authentication (authN) answers “who are they”, authorization (authZ) answers “are they allowed to”, while access control is the overarching term for the whole process of performing authN and authZ.
- Doing access control on the frontend is just for show (for improving UX) and you can’t rely on it. Any and all real access control needs to be done on the server (possibly a bit in the db, but normally not needed).
- While it is ok to start with a simple access control approach at the beginning, you should be ready to switch to a more advanced approach once the complexity grows. The most popular approaches for doing access control are RBAC (role-based) and ABAC (attribute-based). RBAC is easier to get going with, but ABAC is more powerful.
- You should make sure your access control has as little duplication as possible and is centralized, in order to reduce the chance of introducing bugs.
- It is usually smart to use existing solutions, like access control frameworks or external providers.
Access control in Wasp
In Wasp, we don’t yet have special support for access control, although we are planning to add it in the future. As it seems at the moment, we will probably go for ABAC, and we would love to provide a way to define access rules both at the Operations level and at Entity (data model) level. Due to Wasp’s mission to provide a highly integrated full-stack experience, we are excited about the possibilities this offers to provide an access control solution that is integrated tightly with the whole web app, through the whole stack!
You can check out our discussion about this in our “Support for Permissions” RFC.
Thanks to the reviewers
Karan Kajla (pro advice on RBAC!), Graham Neray (great general advice + pointed out ReBAC), Dennis Walsh (awesome suggestions how to have article read better), Shayne Czyzewski, Matija Sosic, thank you for taking the time to review this article and make it better! Your suggestions, corrections, and ideas were invaluable....