Changes between Version 5 and Version 6 of OtherTopics

Timestamp:

07/08/26 21:25:39 (4 days ago)

Author:

231118

Comment:

--

OtherTopics

@@ -100 +100 @@
 
 ---
-
 == Security Measures ==
 
 === Application-Level Security ===
 To secure database interactions within the application stack, the following measures have been programmatically enforced:
- * '''Prevention of SQL Injection (SQLi):''' All dynamic database interactions are implemented using Object-Relational Mapping (ORM) safe frameworks or parameterized prepared statements via native database drivers. String concats inside query definitions are structurally banned.
- * '''Authorization and Data Isolation:''' Multi-tenant isolation is programmatically guaranteed at the API layer. Every request session decrypts tokens verifying user scope, ensuring an authenticated user cannot view metrics from an external `tenant_id`.
- * '''Input Validation:''' Strict input sanitization rules drop unrecognized characters or illegal escape patterns before the values reach execution context.
+ * '''Prevention of SQL Injection (SQLi):''' Introduction of parameterized queries and ORM abstractions in Flask backend layer to strictly split code and parameters. String concats inside query definitions are structurally banned.
+ * '''Prevention of Un-authorized Access:''' Implementation of custom decorators `@require_user()` and `@require_tenant_admin()` to intercept endpoints and force strict validation.
 
 === Database-Level Security ===
 The specific architectural database configurations applied directly within PostgreSQL include:
- * '''Principle of Least Privilege (PoLP):''' The live web application authenticates using a dedicated runtime role (`app_runner`) restricted exclusively to DML operations (`SELECT`, `INSERT`, `UPDATE`). Destructive or structural privileges like `DROP`, `ALTER`, or schema catalog edits are blocked.
- * '''Handling Dynamic Queries Safely:''' Internal procedures or complex triggers generating dynamic SQL paths utilize native safe encapsulation routines (`quote_ident()` and `quote_literal()`) to protect executing buffers from raw injections.
- * '''Network and Transport Security:''' Database sockets are bound strictly to private loopback interfaces (`127.0.0.1`) and secure VPC spaces, completely shielding administrative ports from external public networks.
+ * '''Prevention of SQL Injection in Dynamic Queries:''' Avoiding the manual execution of raw string formatting (f-strings or %s concatenation). All dynamically evaluated filtering explicitly passes parameter tuples.
+ * '''Prevention of Un-authorized Access to Data:''' Multi-tenant structural architecture where every row manipulation isolates and constraints queries via a verified `tenant_id`.
+
+---
+
+== Other Developments ==
+
+=== JWT автентикација и авторизација ===
+Системот користи JWT (JSON Web Token) за автентикација на корисниците по успешна Google најава.
+
+Процесот се состои од следните чекори:
+ 1. Корисникот се најавува преку Google OAuth.
+ 2. Серверот го верификува Google токенот.
+ 3. Доколку најавата е успешна, серверот креира JWT токен кој содржи: `user_id`, `email`, `role`, `tenant_id`.
+ 4. JWT токенот се зачувува во HttpOnly cookie со име `session`.
+ 5. При секое наредно барање прелистувачот автоматски го испраќа cookie-то.
+ 6. Серверот го верификува JWT токенот и ги чита корисничките информации.
+
+'''Креирање на JWT токен:'''
+{{{
+#!python
+def make_jwt(payload: dict, minutes=60 * 24):
+    exp = datetime.utcnow() + timedelta(minutes=minutes)
+    data = {**payload, "iss": JWT_ISSUER, "exp": exp}
+    return jwt.encode(data, JWT_SECRET, algorithm="HS256")
+}}}
+
+'''Проверка на JWT токен:'''
+{{{
+#!python
+def read_jwt(token: str):
+    return jwt.decode(
+        token,
+        JWT_SECRET,
+        algorithms=["HS256"],
+        issuer=JWT_ISSUER
+    )
+}}}
+
+Пристапот до заштитените API рути е овозможен преку декораторите `@require_user` и `@require_tenant_admin`.
+{{{
+#!python
+@require_user()
+def api_me():
+    ...
+}}}
+
+=== CORS конфигурација ===
+Бидејќи frontend апликацијата и Flask серверот работат на различни адреси, потребно е овозможување на Cross-Origin Resource Sharing (CORS).
+
+Во системот е конфигурирана листа на дозволени домени:
+{{{
+#!python
+DEFAULT_ORIGINS = [
+    "http://localhost:5173",
+    "http://127.0.0.1:5173",
+]
+}}}
+
+Конфигурацијата се извршува преку Flask-CORS:
+{{{
+#!python
+CORS(
+    app,
+    supports_credentials=True,
+    origins=ALLOWED_ORIGINS,
+    allow_headers=[
+        "Content-Type",
+        "X-Admin-Session",
+        "X-Env",
+        "X-Env-Token",
+    ],
+    methods=["GET", "POST", "OPTIONS"],
+)
+}}}
+ * Се дозволуваат барања само од доверливи frontend адреси.
+ * Се дозволува испраќање на JWT cookie преку `supports_credentials=True`.
+ * Се ограничуваат HTTP методите на GET, POST и OPTIONS.
+ * Се контролира кои HTTP заглавија може да се испраќаат кон серверот.
+
+=== Безбедносен модел ===
+Системот користи повеќеслојна безбедност:
+ * Google OAuth за верификација на идентитетот.
+ * JWT токени за одржување на корисничка сесија.
+ * HttpOnly cookies за заштита од JavaScript пристап до токените.
+ * CORS политика за ограничување на дозволените клиентски апликации.
+ * Tenant изолација преку `tenant_id`.
+ * Посебни environment токени (`X-Env-Token`) за комуникација помеѓу агентите и серверот.