From 698c7be20b14d720f4f11751586ec3bb7c5ec9f9 Mon Sep 17 00:00:00 2001
From: xfiderek <fiderek@student.agh.edu.pl>
Date: Mon, 6 Feb 2023 20:37:23 +0100
Subject: [PATCH 1/5] add first version of granular access control RFC

---
 assets/000/concept.png              | Bin 0 -> 67705 bytes
 rfcs/000-granular-access-control.md | 165 ++++++++++++++++++++++++++++
 2 files changed, 165 insertions(+)
 create mode 100644 assets/000/concept.png
 create mode 100644 rfcs/000-granular-access-control.md

diff --git a/assets/000/concept.png b/assets/000/concept.png
new file mode 100644
index 0000000000000000000000000000000000000000..bf980d8e30f4d16aff7ea6128c49f1e1950c6274
GIT binary patch
literal 67705
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

literal 0
HcmV?d00001

diff --git a/rfcs/000-granular-access-control.md b/rfcs/000-granular-access-control.md
new file mode 100644
index 0000000..17e9639
--- /dev/null
+++ b/rfcs/000-granular-access-control.md
@@ -0,0 +1,165 @@
+- Feature Name: Granular access control - Phase 1
+- Start Date: 2023-01-22
+- RFC PR: N/A
+- Amundsen Issue: N/A
+
+# Granular access control - Phase 1
+
+## Summary
+
+This RFC proposes first implementation of granular access control feature for Amundsen frontend.
+**Included in phase 1**
+
+* enforcing authorization rules specified in database
+* filtering search query results (prevent users from seeing content they are not authorized to access)
+* Basic UI (redirect to 'you are not authorized to access this resource' page)
+
+After implementation of Phase 1, Amundsen users will be able to define set of granular authorization rules for users and groups by inserting authorization rules into database. 
+
+I've also included [Demo PR](https://github.com/amundsen-io/amundsen/pull/2029), which aims to show an idea behind implementation of this feature. This PR implements authorization for "get_table_metadata" endpoint. Please take a look at `frontend/amundsen_application/authz_config.py`, as well as changes in `frontend/amundsen_application/api/metadata/v0.py` files.
+Note that code on this branch won't fully reflect final implementation as it is subject to change as concept evolves. 
+
+Phase 2 - see [Future possibilities](#Future-possibilities)
+
+## Motivation
+
+This feature was listed as one of mid-term plans in 2021 roadmap. Scenarios that may require granular access control include cases where:
+* metadata contains sensitive information and can not be shared with everyone
+* users should see only data from their business unit
+* only admins and owners should be allowed to modify list of dataset owners
+
+
+In longer term this feature could help with maintaning and administration of amundsen in more UI-driven fashion.
+
+
+## Guide-level Explanation (aka Product Details)
+
+### Authorization (Granular access control)
+When you enable authorization, you can control permissions on objects stored in Amundsen. You can define user groups and manage permissions on different scopes (e.g. database, table). Granular access control can also support filtering query results. By default, Amundsen is using [Casbin](https://casbin.org/docs/overview) as the authorization client. 
+
+### Default configuration
+Access Control List (ACL) is the default model used in Amundsen. Each user (or group of users) can be granted either `READ` or `WRITE` permissions on given resource type and scope. For example, we can add a rule that will allow user `bob@org.com` to view (READ) metadata of all tables from schema `hive`.
+
+
+### Config modification
+Default authorization behaviour can be changed by modifying `authz_config.py` configuration file. You can define new permission types or change the way authorization rules are applied to given endpoint.
+
+Apart from that, by modifying model configuration file of Casbin authorization client you can change access control model (for example to RBAC or ABAC).
+
+
+### Technical details
+Amundsen leverages Casbin to 
+* check if user is authorized to access particular resource
+* fetch permissions of user (in order to filter query results)
+
+Authorization model is based on checking if "subject {S} is allowed to perform action {A} on object {O}". Rules are stored in the database that can be deployed together with the application.
+
+Action permissions are defined on endpoint level. For example we define that 
+
+> Later this section could be extended with hands-on demo of modyfing permissions
+
+
+## UI/UX-level Explanation
+
+Whenever unauthorized principal tries to access a resource, user should be redirected to a page with text `You are not allowed to access this resource`. Component should be modifiable via `config-custom.ts` (e.g. same way Badge Config works).
+
+## Reference-level Explanation (aka Technical Details)
+
+### Authorization flow
+To abstract application code from access control model as much as possible, amundsen calls authorization client in order to verify that "subject {S} is allowed to perform action {A} on object {O}".
+
+There are 3 components added to Amundsen frontend, which are described below.
+
+**AuthorizationClient**
+Proxy class that encapsulates authorization model and provides access to the database where access rules are stored. It implements methods that i.a.:
+* Check if user is authorized to access the resource -  This method takes user context, resource type (e.g. table), resource id and action and returns a boolean.
+* Modify elasticsearch query to filter the records that user should not be able to see (this is not implemented yet)
+
+**RequestToActionMapper**
+Given a context of a request, returns the corresponding action (e.g. READ, WRITE, DELETE). Example when user calls 
+I’ve added this component, because access control based on the HTTP method and url may not be sufficient for some of the use cases and also in my opinion actions are more natural than POST or GET methods. Mappings can be configured by developers in a configuration file.
+
+**BaseAction enum**
+Enumerator with all possible actions (e.g READ, WRITE, DELETE) - developers can implement their own set of actions to meet  requirements for granularity.
+
+![alt concept](../assets/048/concept.png)
+
+### Authorization config
+Authorization flow components can be modified by changing config located in `frontend/amundsen_application/authz_config.py` file. Please take a look at Demo PR linked above to understand rough idea behind this config file.
+
+### Casbin policy
+Authorization model is defined as a single `model.conf` file.
+Take a look [here](https://casbin.org/docs/how-it-works) to understand how policies and models are defined. 
+
+Current implementation in Demo PR:
+
+`model.conf` file:
+```
+[request_definition]
+r = sub,type, obj, act
+
+[policy_definition]
+p = sub, type, obj, act
+
+
+[policy_effect]
+e = some(where (p.eft == allow))
+
+[matchers]
+# match subject (e.g. user), match action(e.g. read), regex match type (e.g table), regex match object (e.g. table id)
+m = r.sub == p.sub && r.act == p.act && regexMatch(r.type, p.type) && regexMatch(r.obj, p.obj)
+```
+
+Sample policy looks like this:
+```
+p, test_user_id, table, hive://*, read
+```
+Which can be read as "user 'test_user_id' has permission 'read' on resource type 'table' that matches 'hive://*'"
+
+Note that current implementation does not have notion of group of users, but it can be easily modified (Check [here](https://casbin.org/docs/rbac))
+
+
+## Drawbacks
+As current model works on level of endpoint, it would require relatively high effort to implement it for whole application, as we would need to modify every function of every blueprint. Despite this, once we ship authorization for a single endpoint, implementation for consecutive ones should be much easier and faster.
+
+## Alternatives
+Since Amundsen stores mostly metadata, for majority of use cases granular access is not required, however I think almost everyone could benefit from simple model that allows defining READ/WRITE permissions on application level. Outlined concept certainly makes such scenario possible, however it may be an overkill. I think logic of application would be simpler by making such assumption, however most of code for granular control is already in place in Demo PR linked above. I am sometimes a bit frustrated with applications making certain assumption about granularity, so for for me it is important that users can adjust granularity by modifying config files.
+
+
+## Prior art
+DataHub implemented [granular access control](https://datahubproject.io/docs/authorization) for their application.
+
+It supports two ways of managing permissions:
+* [Roles](https://datahubproject.io/docs/authorization/roles) - very simple permission mode with three roles (Admin, Editor, Reader) - roles are applied on application level, hence they are not really granular
+* [Policies](https://datahubproject.io/docs/authorization/policies) - Allow to define fine-grained access. This model follows 'Subject, Action, Object' paradigm. 
+
+Policies can be applied on scope of  
+* resource (URN)
+* domain (logical boundary)
+* type (dataset, chart) etc
+
+Main advantage of DataHub's granular access policies is very convenient [UI](https://datahubproject.io/docs/authorization/access-policies-guide/). Main limitation is that (contrary to Casbin) it does not support wildcards in policies. "Ability to define Metadata Policies against multiple reosurces scoped to particular 'Containers' (e.g. A 'schema', 'database', or collection')" is under consideration for implementation. Authorization enforcer used by DataHub is custom application-specific solution.
+
+
+## Unresolved questions
+### Default granularity
+Current default authorization model implements two possible actions (READ and WRITE) for every resource type (Table, Dashboard etc). Limitation of that is that it won't support complex scenarios such as "user should be able to modify **table tag**, but not to modify table description", however this level of granularity could be achieved by modifying [authz_config.py]() file*. For me this setting is good tradeoff between simplicity and granularity, but I am happy to discuss it.
+
+**Just to be 100% transparent, such granularity would possible, but cumbersome to enforce in current Demo implementation, however I know how to support it easier and I am happy to implement that*.
+
+### Which adapter should we use for casbin?
+Available [adapters](https://casbin.org/docs/adapters).
+I think using PostgreSQL with [Sql alchemy adapter](https://github.com/pycasbin/sqlalchemy-adapter) should be the easiest option.
+
+### How to make granular access control optional?
+It should not be necessary to download casbin and its dependencies unless granular access control is used.  
+What is the recommended way to skip installation of casbin if authorization is not used?
+Also, since casbin would require some backend for storing the data (e.g. postgres), how we would like to add it to docker compose? Should we have a separate file (e.g. `docker-compose-with-authz.yml`)?
+
+### Filtering elasticsearch results based on authorization rules
+In theory, it should be possible to whitelist elastic search records, by getting [all permissions of users](https://casbin.org/docs/rbac-api#getimplicitpermissionsforuser) and adding it as filter to search query, however i have never tested it so i am not sure how easy it will be to integrate it with current app.
+
+## Future possibilities
+* API for permission management (add group, add user, add user to group, add permission)
+* Syncing users and groups from IdP
+* UI for permission management (we could then extend default permission model by `MANAGE` permission type, which would allow to call permission management API on certain scope)

From e505cd943df1bcb2a4990566a1e65d2c92233502 Mon Sep 17 00:00:00 2001
From: xfiderek <fiderek@student.agh.edu.pl>
Date: Mon, 6 Feb 2023 20:41:59 +0100
Subject: [PATCH 2/5] fix png for the last time

---
 rfcs/000-granular-access-control.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/rfcs/000-granular-access-control.md b/rfcs/000-granular-access-control.md
index 17e9639..05c581b 100644
--- a/rfcs/000-granular-access-control.md
+++ b/rfcs/000-granular-access-control.md
@@ -82,7 +82,7 @@ I’ve added this component, because access control based on the HTTP method and
 **BaseAction enum**
 Enumerator with all possible actions (e.g READ, WRITE, DELETE) - developers can implement their own set of actions to meet  requirements for granularity.
 
-![alt concept](../assets/048/concept.png)
+![Concept Preview](../assets/000/concept.png)
 
 ### Authorization config
 Authorization flow components can be modified by changing config located in `frontend/amundsen_application/authz_config.py` file. Please take a look at Demo PR linked above to understand rough idea behind this config file.

From 296d80e1c8347dee27a377ef20d3fc3cb0f3ed48 Mon Sep 17 00:00:00 2001
From: xfiderek <fiderek@student.agh.edu.pl>
Date: Mon, 6 Feb 2023 20:44:27 +0100
Subject: [PATCH 3/5] change order of questions

---
 rfcs/000-granular-access-control.md | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/rfcs/000-granular-access-control.md b/rfcs/000-granular-access-control.md
index 05c581b..0d293f0 100644
--- a/rfcs/000-granular-access-control.md
+++ b/rfcs/000-granular-access-control.md
@@ -142,10 +142,6 @@ Main advantage of DataHub's granular access policies is very convenient [UI](htt
 
 
 ## Unresolved questions
-### Default granularity
-Current default authorization model implements two possible actions (READ and WRITE) for every resource type (Table, Dashboard etc). Limitation of that is that it won't support complex scenarios such as "user should be able to modify **table tag**, but not to modify table description", however this level of granularity could be achieved by modifying [authz_config.py]() file*. For me this setting is good tradeoff between simplicity and granularity, but I am happy to discuss it.
-
-**Just to be 100% transparent, such granularity would possible, but cumbersome to enforce in current Demo implementation, however I know how to support it easier and I am happy to implement that*.
 
 ### Which adapter should we use for casbin?
 Available [adapters](https://casbin.org/docs/adapters).
@@ -159,6 +155,11 @@ Also, since casbin would require some backend for storing the data (e.g. postgre
 ### Filtering elasticsearch results based on authorization rules
 In theory, it should be possible to whitelist elastic search records, by getting [all permissions of users](https://casbin.org/docs/rbac-api#getimplicitpermissionsforuser) and adding it as filter to search query, however i have never tested it so i am not sure how easy it will be to integrate it with current app.
 
+### Default granularity
+Current default authorization model implements two possible actions (READ and WRITE) for every resource type (Table, Dashboard etc). Limitation of that is that it won't support complex scenarios such as "user should be able to modify **table tag**, but not to modify table description", however this level of granularity could be achieved by modifying [authz_config.py]() file*. For me current setting is good tradeoff between simplicity and granularity, but I am happy to discuss it.
+
+**Just to be 100% transparent, such granularity would possible, but cumbersome to enforce in current Demo implementation, however I know how to support it easier and I am happy to implement that*.
+
 ## Future possibilities
 * API for permission management (add group, add user, add user to group, add permission)
 * Syncing users and groups from IdP

From 070a8b5022dbddfa0d9ff617ebf56c1524684b75 Mon Sep 17 00:00:00 2001
From: xfiderek <fiderek@student.agh.edu.pl>
Date: Mon, 6 Feb 2023 20:48:52 +0100
Subject: [PATCH 4/5] fix styling

---
 rfcs/000-granular-access-control.md | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/rfcs/000-granular-access-control.md b/rfcs/000-granular-access-control.md
index 0d293f0..b5b5338 100644
--- a/rfcs/000-granular-access-control.md
+++ b/rfcs/000-granular-access-control.md
@@ -7,14 +7,15 @@
 
 ## Summary
 
-This RFC proposes first implementation of granular access control feature for Amundsen frontend.
+This RFC proposes first implementation of granular access control feature for Amundsen frontend.  
+
 **Included in phase 1**
 
 * enforcing authorization rules specified in database
 * filtering search query results (prevent users from seeing content they are not authorized to access)
 * Basic UI (redirect to 'you are not authorized to access this resource' page)
 
-After implementation of Phase 1, Amundsen users will be able to define set of granular authorization rules for users and groups by inserting authorization rules into database. 
+After implementation of Phase 1, Amundsen users will be able to define set of granular authorization rules for users and groups by inserting them into database. 
 
 I've also included [Demo PR](https://github.com/amundsen-io/amundsen/pull/2029), which aims to show an idea behind implementation of this feature. This PR implements authorization for "get_table_metadata" endpoint. Please take a look at `frontend/amundsen_application/authz_config.py`, as well as changes in `frontend/amundsen_application/api/metadata/v0.py` files.
 Note that code on this branch won't fully reflect final implementation as it is subject to change as concept evolves. 
@@ -35,7 +36,7 @@ In longer term this feature could help with maintaning and administration of amu
 ## Guide-level Explanation (aka Product Details)
 
 ### Authorization (Granular access control)
-When you enable authorization, you can control permissions on objects stored in Amundsen. You can define user groups and manage permissions on different scopes (e.g. database, table). Granular access control can also support filtering query results. By default, Amundsen is using [Casbin](https://casbin.org/docs/overview) as the authorization client. 
+When you enable authorization, you can control permissions on objects stored in Amundsen. You can define groups and manage permissions on different scopes (such as database or table). Granular access control also supports filtering search results. By default, Amundsen uses [Casbin](https://casbin.org/docs/overview) as the authorization client. 
 
 ### Default configuration
 Access Control List (ACL) is the default model used in Amundsen. Each user (or group of users) can be granted either `READ` or `WRITE` permissions on given resource type and scope. For example, we can add a rule that will allow user `bob@org.com` to view (READ) metadata of all tables from schema `hive`.
@@ -68,6 +69,8 @@ Whenever unauthorized principal tries to access a resource, user should be redir
 ### Authorization flow
 To abstract application code from access control model as much as possible, amundsen calls authorization client in order to verify that "subject {S} is allowed to perform action {A} on object {O}".
 
+![Concept Preview](../assets/000/concept.png)
+
 There are 3 components added to Amundsen frontend, which are described below.
 
 **AuthorizationClient**
@@ -82,10 +85,9 @@ I’ve added this component, because access control based on the HTTP method and
 **BaseAction enum**
 Enumerator with all possible actions (e.g READ, WRITE, DELETE) - developers can implement their own set of actions to meet  requirements for granularity.
 
-![Concept Preview](../assets/000/concept.png)
 
 ### Authorization config
-Authorization flow components can be modified by changing config located in `frontend/amundsen_application/authz_config.py` file. Please take a look at Demo PR linked above to understand rough idea behind this config file.
+Authorization flow components can be modified by changing config located in `frontend/amundsen_application/authz_config.py` file. Please take a look at Demo PR linked above to understand rough idea behind it.
 
 ### Casbin policy
 Authorization model is defined as a single `model.conf` file.
@@ -120,7 +122,7 @@ Note that current implementation does not have notion of group of users, but it
 
 
 ## Drawbacks
-As current model works on level of endpoint, it would require relatively high effort to implement it for whole application, as we would need to modify every function of every blueprint. Despite this, once we ship authorization for a single endpoint, implementation for consecutive ones should be much easier and faster.
+As proposed model works on level of endpoint, it would require relatively high effort to implement it for whole application, as we would need to modify every function of every blueprint. Despite this, once we ship authorization for a single endpoint, implementation for consecutive ones should be much easier and faster.
 
 ## Alternatives
 Since Amundsen stores mostly metadata, for majority of use cases granular access is not required, however I think almost everyone could benefit from simple model that allows defining READ/WRITE permissions on application level. Outlined concept certainly makes such scenario possible, however it may be an overkill. I think logic of application would be simpler by making such assumption, however most of code for granular control is already in place in Demo PR linked above. I am sometimes a bit frustrated with applications making certain assumption about granularity, so for for me it is important that users can adjust granularity by modifying config files.

From 86b548cf32d3b3a40b02d7f75db396753fba1ee3 Mon Sep 17 00:00:00 2001
From: xfiderek <fiderek@student.agh.edu.pl>
Date: Wed, 8 Feb 2023 17:38:18 +0100
Subject: [PATCH 5/5] assign RFC number

---
 assets/{000 => 049}/concept.png                     | Bin
 ...ss-control.md => 049-granular-access-control.md} |   4 ++--
 2 files changed, 2 insertions(+), 2 deletions(-)
 rename assets/{000 => 049}/concept.png (100%)
 rename rfcs/{000-granular-access-control.md => 049-granular-access-control.md} (99%)

diff --git a/assets/000/concept.png b/assets/049/concept.png
similarity index 100%
rename from assets/000/concept.png
rename to assets/049/concept.png
diff --git a/rfcs/000-granular-access-control.md b/rfcs/049-granular-access-control.md
similarity index 99%
rename from rfcs/000-granular-access-control.md
rename to rfcs/049-granular-access-control.md
index b5b5338..80ae8ef 100644
--- a/rfcs/000-granular-access-control.md
+++ b/rfcs/049-granular-access-control.md
@@ -1,6 +1,6 @@
 - Feature Name: Granular access control - Phase 1
 - Start Date: 2023-01-22
-- RFC PR: N/A
+- RFC PR: [49](https://github.com/amundsen-io/rfcs/pull/49)
 - Amundsen Issue: N/A
 
 # Granular access control - Phase 1
@@ -69,7 +69,7 @@ Whenever unauthorized principal tries to access a resource, user should be redir
 ### Authorization flow
 To abstract application code from access control model as much as possible, amundsen calls authorization client in order to verify that "subject {S} is allowed to perform action {A} on object {O}".
 
-![Concept Preview](../assets/000/concept.png)
+![Concept Preview](../assets/049/concept.png)
 
 There are 3 components added to Amundsen frontend, which are described below.