gns3-server/gns3server/db/repositories/rbac.py

394 lines
13 KiB
Python
Raw Normal View History

2021-05-25 12:04:59 +03:00
#!/usr/bin/env python
#
# Copyright (C) 2023 GNS3 Technologies Inc.
2021-05-25 12:04:59 +03:00
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
from uuid import UUID
from typing import Optional, List, Union
from sqlalchemy import select, update, delete, null
2021-05-25 12:04:59 +03:00
from sqlalchemy.ext.asyncio import AsyncSession
from sqlalchemy.orm import selectinload
from .base import BaseRepository
import gns3server.db.models as models
from gns3server import schemas
import logging
log = logging.getLogger(__name__)
class RbacRepository(BaseRepository):
def __init__(self, db_session: AsyncSession) -> None:
super().__init__(db_session)
async def get_role(self, role_id: UUID) -> Optional[models.Role]:
2021-05-27 10:58:44 +03:00
"""
Get a role by its ID.
"""
2021-05-25 12:04:59 +03:00
query = select(models.Role).\
options(selectinload(models.Role.privileges)).\
2021-05-25 12:04:59 +03:00
where(models.Role.role_id == role_id)
result = await self._db_session.execute(query)
return result.scalars().first()
async def get_role_by_name(self, name: str) -> Optional[models.Role]:
2021-05-27 10:58:44 +03:00
"""
Get a role by its name.
"""
2021-05-25 12:04:59 +03:00
query = select(models.Role).\
options(selectinload(models.Role.privileges)).\
2021-05-25 12:04:59 +03:00
where(models.Role.name == name)
result = await self._db_session.execute(query)
return result.scalars().first()
async def get_roles(self) -> List[models.Role]:
2021-05-27 10:58:44 +03:00
"""
Get all roles.
"""
2021-05-25 12:04:59 +03:00
query = select(models.Role).options(selectinload(models.Role.privileges))
2021-05-25 12:04:59 +03:00
result = await self._db_session.execute(query)
return result.scalars().all()
async def create_role(self, role_create: schemas.RoleCreate) -> models.Role:
2021-05-27 10:58:44 +03:00
"""
Create a new role.
"""
2021-05-25 12:04:59 +03:00
db_role = models.Role(
name=role_create.name,
description=role_create.description,
)
self._db_session.add(db_role)
await self._db_session.commit()
return await self.get_role(db_role.role_id)
async def update_role(
self,
role_id: UUID,
role_update: schemas.RoleUpdate
) -> Optional[models.Role]:
2021-05-27 10:58:44 +03:00
"""
Update a role.
"""
2021-05-25 12:04:59 +03:00
2023-08-04 11:20:06 +03:00
update_values = role_update.model_dump(exclude_unset=True)
query = update(models.Role).\
where(models.Role.role_id == role_id).\
values(update_values)
2021-05-25 12:04:59 +03:00
await self._db_session.execute(query)
await self._db_session.commit()
role_db = await self.get_role(role_id)
if role_db:
await self._db_session.refresh(role_db) # force refresh of updated_at value
return role_db
2021-05-25 12:04:59 +03:00
async def delete_role(self, role_id: UUID) -> bool:
2021-05-27 10:58:44 +03:00
"""
Delete a role.
"""
2021-05-25 12:04:59 +03:00
query = delete(models.Role).where(models.Role.role_id == role_id)
result = await self._db_session.execute(query)
await self._db_session.commit()
return result.rowcount > 0
async def add_privilege_to_role(
2021-05-25 12:04:59 +03:00
self,
role_id: UUID,
privilege: models.Privilege
2021-05-25 12:04:59 +03:00
) -> Union[None, models.Role]:
2021-05-27 10:58:44 +03:00
"""
Add a privilege to a role.
2021-05-27 10:58:44 +03:00
"""
2021-05-25 12:04:59 +03:00
query = select(models.Role).\
options(selectinload(models.Role.privileges)).\
2021-05-25 12:04:59 +03:00
where(models.Role.role_id == role_id)
result = await self._db_session.execute(query)
role_db = result.scalars().first()
if not role_db:
return None
role_db.privileges.append(privilege)
2021-05-25 12:04:59 +03:00
await self._db_session.commit()
await self._db_session.refresh(role_db)
return role_db
async def remove_privilege_from_role(
2021-05-25 12:04:59 +03:00
self,
role_id: UUID,
privilege: models.Privilege
2021-05-25 12:04:59 +03:00
) -> Union[None, models.Role]:
2021-05-27 10:58:44 +03:00
"""
Remove a privilege from a role.
2021-05-27 10:58:44 +03:00
"""
2021-05-25 12:04:59 +03:00
query = select(models.Role).\
options(selectinload(models.Role.privileges)).\
2021-05-25 12:04:59 +03:00
where(models.Role.role_id == role_id)
result = await self._db_session.execute(query)
role_db = result.scalars().first()
if not role_db:
return None
role_db.privileges.remove(privilege)
2021-05-25 12:04:59 +03:00
await self._db_session.commit()
await self._db_session.refresh(role_db)
return role_db
async def get_role_privileges(self, role_id: UUID) -> List[models.Privilege]:
2021-05-27 10:58:44 +03:00
"""
Get all the role privileges.
2021-05-27 10:58:44 +03:00
"""
2021-05-25 12:04:59 +03:00
query = select(models.Privilege).\
join(models.Privilege.roles).\
2021-05-25 12:04:59 +03:00
filter(models.Role.role_id == role_id)
result = await self._db_session.execute(query)
return result.scalars().all()
async def get_privilege(self, privilege_id: UUID) -> Optional[models.Privilege]:
2021-05-27 10:58:44 +03:00
"""
Get a privilege by its ID.
2021-05-27 10:58:44 +03:00
"""
2021-05-25 12:04:59 +03:00
query = select(models.Privilege).where(models.Privilege.privilege_id == privilege_id)
2021-05-25 12:04:59 +03:00
result = await self._db_session.execute(query)
return result.scalars().first()
async def get_privilege_by_name(self, name: str) -> Optional[models.Privilege]:
2021-05-27 10:58:44 +03:00
"""
Get a privilege by its name.
2021-05-27 10:58:44 +03:00
"""
2021-05-25 12:04:59 +03:00
query = select(models.Privilege).where(models.Privilege.name == name)
2021-05-25 12:04:59 +03:00
result = await self._db_session.execute(query)
return result.scalars().first()
async def get_privileges(self) -> List[models.Privilege]:
2021-05-27 10:58:44 +03:00
"""
Get all privileges.
2021-05-27 10:58:44 +03:00
"""
2021-05-25 12:04:59 +03:00
query = select(models.Privilege)
2021-05-25 12:04:59 +03:00
result = await self._db_session.execute(query)
return result.scalars().all()
async def get_ace(self, ace_id: UUID) -> Optional[models.ACE]:
2021-05-27 10:58:44 +03:00
"""
Get an ACE by its ID.
2021-05-27 10:58:44 +03:00
"""
2021-05-25 12:04:59 +03:00
query = select(models.ACE).where(models.ACE.ace_id == ace_id)
2021-05-27 10:58:44 +03:00
result = await self._db_session.execute(query)
return result.scalars().first()
2021-05-25 12:04:59 +03:00
async def get_ace_by_path(self, path: str) -> Optional[models.ACE]:
2021-05-27 10:58:44 +03:00
"""
Get an ACE by its path.
2021-05-27 10:58:44 +03:00
"""
2021-05-25 12:04:59 +03:00
query = select(models.ACE).where(models.ACE.path == path)
2021-05-25 12:04:59 +03:00
result = await self._db_session.execute(query)
return result.scalars().first()
2021-05-27 10:58:44 +03:00
async def get_aces(self) -> List[models.ACE]:
"""
Get all ACEs.
"""
query = select(models.ACE)
result = await self._db_session.execute(query)
return result.scalars().all()
2021-05-27 10:58:44 +03:00
async def check_ace_exists(self, path: str) -> bool:
2021-05-27 10:58:44 +03:00
"""
Check if an ACE exists.
2021-05-27 10:58:44 +03:00
"""
query = select(models.ACE).\
where(models.ACE.path == path)
2021-05-27 10:58:44 +03:00
result = await self._db_session.execute(query)
return result.scalars().first() is not None
2021-05-27 10:58:44 +03:00
async def create_ace(self, ace_create: schemas.ACECreate) -> models.ACE:
2021-06-03 09:10:12 +03:00
"""
Create a new ACE
2021-06-03 09:10:12 +03:00
"""
2021-05-27 10:58:44 +03:00
create_values = ace_create.model_dump(exclude_unset=True)
db_ace = models.ACE(**create_values)
self._db_session.add(db_ace)
2021-06-03 09:10:12 +03:00
await self._db_session.commit()
await self._db_session.refresh(db_ace)
return db_ace
2021-06-03 09:10:12 +03:00
async def update_ace(
2021-06-03 09:10:12 +03:00
self,
ace_id: UUID,
ace_update: schemas.ACEUpdate
) -> Optional[models.ACE]:
2021-06-03 09:10:12 +03:00
"""
Update an ACE
2021-06-03 09:10:12 +03:00
"""
update_values = ace_update.model_dump(exclude_unset=True)
query = update(models.ACE).\
where(models.ACE.ace_id == ace_id).\
values(update_values)
2021-06-03 09:10:12 +03:00
await self._db_session.execute(query)
2021-06-03 09:10:12 +03:00
await self._db_session.commit()
ace_db = await self.get_ace(ace_id)
if ace_db:
await self._db_session.refresh(ace_db) # force refresh of updated_at value
return ace_db
2021-05-27 10:58:44 +03:00
async def delete_ace(self, ace_id: UUID) -> bool:
2021-05-27 10:58:44 +03:00
"""
Delete an ACE
2021-05-27 10:58:44 +03:00
"""
query = delete(models.ACE).where(models.ACE.ace_id == ace_id)
2021-05-27 10:58:44 +03:00
result = await self._db_session.execute(query)
await self._db_session.commit()
return result.rowcount > 0
2021-05-27 10:58:44 +03:00
# async def prune_permissions(self) -> int:
# """
# Prune orphaned permissions.
# """
#
# query = select(models.Permission).\
# filter((~models.Permission.roles.any()) & (models.Permission.user_id == null()))
# result = await self._db_session.execute(query)
# permissions = result.scalars().all()
# permissions_deleted = 0
# for permission in permissions:
# if await self.delete_permission(permission.permission_id):
# permissions_deleted += 1
# log.info(f"{permissions_deleted} orphaned permissions have been deleted")
# return permissions_deleted
#
# def _match_permission(
# self,
# permissions: List[models.Permission],
# method: str,
# path: str
# ) -> Union[None, models.Permission]:
# """
# Match the methods and path with a permission.
# """
#
# for permission in permissions:
# log.debug(f"RBAC: checking permission {permission.methods} {permission.path} {permission.action}")
# if method not in permission.methods:
# continue
# if permission.path.endswith("/*") and path.startswith(permission.path[:-2]):
# return permission
# elif permission.path == path:
# return permission
async def delete_all_ace_starting_with_path(self, path: str) -> None:
"""
Delete all ACEs starting with path.
"""
query = delete(models.ACE).\
where(models.ACE.path.startswith(path)).\
2021-05-27 10:58:44 +03:00
execution_options(synchronize_session=False)
result = await self._db_session.execute(query)
log.debug(f"{result.rowcount} ACE(s) have been deleted")
async def check_user_has_privilege(self, user_id: UUID, path: str, privilege_name: str) -> bool:
# query = select(models.Privilege.name).\
# join(models.Privilege.roles).\
# join(models.Role.acl_entries).\
# join(models.ACE.user).\
# filter(models.Privilege.name == privilege). \
# filter(models.User.user_id == user_id).\
# filter(models.ACE.path == path).\
# distinct()
#query = select(models.ACE.path)
#result = await self._db_session.execute(query)
#res = result.scalars().all()
#print("ACL TABLE ==>", res)
#for ace in res:
# print(ace)
query = select(models.Privilege.name, models.ACE.path, models.ACE.propagate).\
join(models.Privilege.roles).\
join(models.Role.acl_entries).\
join(models.ACE.user).\
filter(models.User.user_id == user_id).\
filter(models.Privilege.name == privilege_name).\
filter(models.ACE.path == path).\
order_by(models.ACE.path.desc())
result = await self._db_session.execute(query)
privileges = result.all()
#print(privileges)
for privilege, privilege_path, propagate in privileges:
if privilege_path == path:
return True
return False
2021-06-03 09:10:12 +03:00
async def check_user_is_authorized(self, user_id: UUID, path: str) -> bool:
2021-06-03 09:10:12 +03:00
"""
Check if a user is authorized to access a resource.
2021-06-03 09:10:12 +03:00
"""
return True
2021-06-03 09:10:12 +03:00
query = select(models.Permission).\
join(models.Permission.roles).\
join(models.Role.groups).\
join(models.UserGroup.users).\
2021-06-03 09:10:12 +03:00
filter(models.User.user_id == user_id).\
order_by(models.Permission.path.desc())
2021-06-03 09:10:12 +03:00
result = await self._db_session.execute(query)
permissions = result.scalars().all()
log.debug(f"RBAC: checking authorization for user '{user_id}' on {method} '{path}'")
matched_permission = self._match_permission(permissions, method, path)
if matched_permission:
log.debug(f"RBAC: matched role permission {matched_permission.methods} "
f"{matched_permission.path} {matched_permission.action}")
if matched_permission.action == "DENY":
return False
return True
log.debug(f"RBAC: could not find a role permission, checking user permissions...")
permissions = await self.get_user_permissions(user_id)
matched_permission = self._match_permission(permissions, method, path)
if matched_permission:
log.debug(f"RBAC: matched user permission {matched_permission.methods} "
f"{matched_permission.path} {matched_permission.action}")
if matched_permission.action == "DENY":
return False
return True
return False