Row Level Security والـ Multi-tenancy: كل عميل يشوف بياناته بس
الـ multi-tenancy (عملاء كتير على نفس الجداول بـ tenant_id)، والـ bug اللي بيسرّب بيانات عميل لعميل لما query تنسى WHERE. RLS في Postgres: ENABLE و FORCE و CREATE POLICY بـ USING و WITH CHECK و current_setting. تمرير الـ tenant بـ set_config(…, true) جُوّه transaction، وليه false خطر مع الـ connection pool. والـ helper اللي بيبقى الطريق الوحيد للبيانات.
نص شرح المعلم والكود الذي كتبه ونتيجة تشغيله، بنفس ترتيب الدرس.
أهلًا بيك. أغلب الـ SaaS: شركات كتير على نفس الـ database، وكل صف عليه tenant_id بيقول تبع أنهي شركة. وكل query لازم يكون فيها WHERE tenant_id. لحد ما developer جديد يكتب search بسرعة وينسى. جدول invoices فيه فواتير شركتين، والـ search ده نسي الشرط. نشغّل.
import { pool, setup } from "./db.js";
await setup();
// كل الـ queries لازم فيها WHERE tenant_id… لحد ما حد ينسى
async function listInvoices(tenantId, search) {
const { rows } = await pool.query(
"SELECT tenant_id, customer FROM invoices WHERE customer LIKE $1",
[`%${search}%`],
);
return rows;
}
console.log("tenant 1 بيدوّر على «م»:", await listInvoices(1, "م"));
await pool.end();المخرجات
$ node main.js
tenant 1 بيدوّر على «م»: [
{ tenant_id: '1', customer: 'مكتبة الأمل' },
{ tenant_id: '2', customer: 'مطعم الفلّ' }
]tenant واحد بيدوّر، ولقى فاتورة مطعم الفلّ، وده عميل tenant اتنين! الـ bug ده من أخطر الـ bugs في الـ SaaS: بيانات عميل بتبان لعميل تاني. وبيتكرر في شركات كبيرة، لأن الحماية معتمدة على إن كل developer يفتكر كل مرة. Row Level Security: Postgres نفسه بيفلتر الصفوف. ENABLE: فعّل الحماية على الجدول. FORCE: حتى صاحب الجدول يخضع ليها، وده مهم لأن الـ app غالبًا هو صاحب الجداول. POLICY: USING بيقول مين الصفوف اللي تتشاف، و WITH CHECK بيقول مين الصفوف اللي يتكتب. والاتنين: tenant_id لازم يطابق إعداد اسمه app dot tenant_id. asTenant بتفتح transaction، وتحط الإعداد بـ set_config، والـ true معناها: local للـ transaction دي بس. وبعدين بنجرّب: نقرا، ونقرا من غير tenant، ونكتب لشركة تانية، ونمسح كل حاجة. نشغّل.
import { pool, setup } from "./db.js";
await setup();
await pool.query(`
ALTER TABLE invoices ENABLE ROW LEVEL SECURITY;
ALTER TABLE invoices FORCE ROW LEVEL SECURITY; -- حتى صاحب الجدول
CREATE POLICY tenant_isolation ON invoices
USING (tenant_id = NULLIF(current_setting('app.tenant_id', true), '')::bigint)
WITH CHECK (tenant_id = NULLIF(current_setting('app.tenant_id', true), '')::bigint);
`);
async function asTenant(tenantId, sql, params) {
const c = await pool.connect();
try {
await c.query("BEGIN");
// true = local: الإعداد ده للـ transaction دي بس
await c.query("SELECT set_config('app.tenant_id', $1, true)", [String(tenantId)]);
const { rows } = await c.query(sql, params);
await c.query("COMMIT");
return rows;
} catch (err) {
await c.query("ROLLBACK");
throw err;
} finally {
c.release();
}
}
console.log("tenant 1:", await asTenant(1, "SELECT customer FROM invoices WHERE customer LIKE $1", ["%م%"]));
console.log("tenant 2:", await asTenant(2, "SELECT customer FROM invoices"));
console.log("من غير tenant:", (await pool.query("SELECT count(*)::int AS n FROM invoices")).rows);
try {
await asTenant(1, "INSERT INTO invoices (tenant_id, customer, amount) VALUES (2, 'دسيسة', 1)");
} catch (err) {
console.log("tenant 1 بيكتب لـ tenant 2:", err.message);
}
console.log("tenant 1 بيمسح كل حاجة:", await asTenant(1, "DELETE FROM invoices RETURNING customer"));
console.log("tenant 2 بعدها:", await asTenant(2, "SELECT customer FROM invoices"));
await pool.end();المخرجات
$ node main.js
tenant 1: [ { customer: 'مكتبة الأمل' } ]
tenant 2: [ { customer: 'مطعم الفلّ' } ]
من غير tenant: [ { n: 0 } ]
tenant 1 بيكتب لـ tenant 2: new row violates row-level security policy for table "invoices"
tenant 1 بيمسح كل حاجة: [ { customer: 'شركة النور' }, { customer: 'مكتبة الأمل' } ]
tenant 2 بعدها: [ { customer: 'مطعم الفلّ' } ]tenant واحد بنفس الـ search: لقى مكتبة الأمل بس. tenant اتنين: مطعم الفلّ بس. من غير tenant: zero، الـ default آمن. وهنا تفصيلة مهمة جدًّا: current_setting بالـ true بيرجّع NULL لو الإعداد عمره ما اتعمل، بس بعد أول set_config local على الـ connection، بيفضل موجود كـ string فاضي! وفاضي cast لـ bigint بيرمي error. علشان كده NULLIF بتحوّل الفاضي لـ NULL، و NULL ما بيطابقش ولا صف. الكتابة لشركة تانية: new row violates row-level security policy. و DELETE من غير WHERE: مسح فواتير tenant واحد بس، و tenant اتنين لسه عنده فاتورته. يعني حتى لو حد كتب DELETE من غير WHERE، الضرر محدود. ليه الـ true في set_config مهمة جدًّا؟ لأن الـ connections في الـ pool بيتعاد استخدامها. هنحط الـ tenant بـ false، يعني للـ session كلها، والـ pool فيه connection واحدة. وبعدين request جديد من غير tenant خالص.
نشغّل.
import { pool, setup } from "./db.js";
await setup();
await pool.query(`
ALTER TABLE invoices ENABLE ROW LEVEL SECURITY;
ALTER TABLE invoices FORCE ROW LEVEL SECURITY;
CREATE POLICY tenant_isolation ON invoices
USING (tenant_id = NULLIF(current_setting('app.tenant_id', true), '')::bigint);
`);
// ❌ set_config بـ false = للـ session كلها، والـ connection بترجع للـ pool وهي شايلاه
await pool.query("SELECT set_config('app.tenant_id', '2', false)");
await pool.query("SELECT customer FROM invoices");
// request تاني من مستخدم مالوش tenant خالص… على نفس الـ connection
console.log("request جديد:", (await pool.query("SELECT customer FROM invoices")).rows);
await pool.end();المخرجات
$ node main.js
request جديد: [ { customer: 'مطعم الفلّ' } ]الـ request الجديد شاف فاتورة tenant اتنين! الـ connection رجعت للـ pool وهي لسه فاكرة الإعداد، وأول حد استخدمها بعدها خد الـ tenant ده. ولو بتستخدم PgBouncer في transaction mode، الـ session settings مالهاش معنى أصلًا. القاعدة: الـ tenant دايمًا local جُوّه transaction. التحدي: withTenant. جدول notes، والـ tenant_id بيتحط لوحده من الإعداد بالـ DEFAULT. policy بـ USING و WITH CHECK. withTenant: بتتأكد إن الـ tenant رقم صحيح، وبتفتح transaction، وتحط الإعداد local، وتنادي الـ function. وممنوع WHERE tenant_id في أي query. التفاصيل في الكومنت.
notes بـ RLS (ENABLE + FORCE + policy USING/WITH CHECK)، و withTenant(tenantId, fn) بـ validation و transaction و set_config(…, true). من غير WHERE tenant_id.
الحل. ENABLE و FORCE و policy. withTenant: Number، ولو مش صحيح موجب نرمي قبل أي query. connect و BEGIN و set_config بالـ true و fn و COMMIT. والـ inserts من غير tenant_id، والـ DEFAULT بيحطه. نشغّل.
import { pool, setup } from "./db.js";
await setup();
await pool.query(`
DROP TABLE IF EXISTS notes;
CREATE TABLE notes (
id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
tenant_id bigint NOT NULL DEFAULT NULLIF(current_setting('app.tenant_id', true), '')::bigint,
body text NOT NULL
);
`);
await pool.query(`
ALTER TABLE notes ENABLE ROW LEVEL SECURITY;
ALTER TABLE notes FORCE ROW LEVEL SECURITY;
CREATE POLICY notes_tenant ON notes
USING (tenant_id = NULLIF(current_setting('app.tenant_id', true), '')::bigint)
WITH CHECK (tenant_id = NULLIF(current_setting('app.tenant_id', true), '')::bigint);
`);
async function withTenant(tenantId, fn) {
const id = Number(tenantId);
if (!Number.isInteger(id) || id <= 0) throw new Error("tenant غلط");
const c = await pool.connect();
try {
await c.query("BEGIN");
await c.query("SELECT set_config('app.tenant_id', $1, true)", [String(id)]);
const result = await fn(c);
await c.query("COMMIT");
return result;
} catch (err) {
await c.query("ROLLBACK");
throw err;
} finally {
c.release();
}
}
await withTenant(1, (c) => c.query("INSERT INTO notes (body) VALUES ($1)", ["خطة 2027"]));
await withTenant(2, (c) => c.query("INSERT INTO notes (body) VALUES ($1)", ["منيو جديد"]));
for (const t of [1, 2]) {
const { rows } = await withTenant(t, (c) => c.query("SELECT body FROM notes"));
console.log(`tenant ${t}:`, rows.map((r) => r.body));
}
try {
await withTenant("1 OR 1=1", (c) => c.query("SELECT body FROM notes"));
} catch (err) {
console.log(String(err));
}
await pool.end();المخرجات
$ node main.js tenant 1: [ 'خطة 2027' ] tenant 2: [ 'منيو جديد' ] Error: tenant غلط
كل tenant شايف الـ note بتاعته بس، ومحاولة الـ injection اترفضت. الـ RLS طبقة دفاع تانية، مش بديل لـ authorization في الـ app، بس بتحوّل bug ممكن يسرّب بيانات كل العملاء، لـ bug بيرجّع نتيجة فاضية. الدرس الجاي: الـ migrations من غير ما الموقع يقف.
03 / دروس المسار (122)
- 01أهلًا بيك: يعني إيه backend، والكورس ده ماشي إزاي
- 02الملفات والفولدرات والـ terminal: تتحرك على جهازك زي المبرمجين
- 03Node وأول برنامج: تشغّل وتقرا رسالة الخطأ
- 04القيم والمتغيرات والأنواع: const و let و typeof
- 05القرارات والتكرار: if و === والـ truthy والـ loops
- 06الـ functions: parameters و return والـ arrow functions والـ scope
- 07الـ objects والـ arrays: destructuring و spread و map و filter و reduce
- 08JSON والنصوص والتواريخ: اللغة اللي الـ backend بيتكلم بيها
- 09الـ callbacks والـ closures وأول لمسة async: setTimeout
- 10الـ classes والـ errors: throw و try/catch و stack trace
- 11git: تحفَظ كل خطوة وترجعلها، وما تسرّبش أسرارك
- 12ESM و CommonJS و package exports: Node بيلاقي الـ modules إزاي
- 13الـ Promises و async/await: sequential و parallel والأخطاء والإلغاء
- 14الـ event loop والـ microtasks: Node بيعمل كل حاجة بـ thread واحد إزاي
- 15الـ Streams والـ Backpressure: ملفات أكبر من الـ memory
- 16الـ File System والـ paths: قراية وكتابة صح، ومن غير path traversal
- 17الـ Buffers والبيانات الـ binary: الـ bytes من جُوّه
- 18Crypto APIs والأسرار: random و hash و HMAC و AES-GCM
- 19الـ Worker Threads: شغل CPU تقيل من غير ما توقف الـ server
- 20الـ Errors على مستوى الـ process: operational و programmer و crash-only
- 21الـ Node test runner والـ debugging: tests من غير مكتبات
- 22HTTP من جُوّه: الـ methods والـ status codes والـ headers
- 23Express والـ Routing: الـ params والـ query والترتيب والـ Router
- 24Express 5: إيه اللي اتغيّر، وإزاي تنقل مشروع قديم
- 25الـ Middleware ودورة حياة الـ request جُوّه Express
- 26Validation للمدخلات بـ Zod: ما تصدّقش أي حاجة جاية من برة
- 27تصنيف الأخطاء و Problem Details: شكل واحد لكل الـ errors
- 28الـ CORS والـ Cookies: المتصفح بيحمي المستخدم إزاي
- 29رفع الملفات وحدود الحجم: multer من غير ثغرات
- 30الـ Realtime: Server-Sent Events و WebSockets
- 31OpenAPI والـ API Versioning: عقد مكتوب، وتغيير من غير ما تكسر حد
- 32PostgreSQL: الـ DDL وأنواع البيانات الصح لكل عمود
- 33الـ Constraints: PK و FK و UNIQUE و CHECK — الـ database بتحمي نفسها
- 34الـ Normalization والـ ERD: تقسّم البيانات صح من أول يوم
- 35الـ JOINs والتجميع: INNER و LEFT و GROUP BY و HAVING و window functions
- 36JSONB في PostgreSQL: إمتى تستخدمه، وإزاي تسأله وتعمله index
- 37الـ Indexes من جُوّه: B-tree و GIN و BRIN
- 38Partial و Covering indexes: indexes أصغر وأسرع
- 39الـ Pagination بالـ Keyset: ليه OFFSET بيبطّأ وبيكرر
- 40Full Text Search في Postgres: بحث بالكلمات، بالعربي والإنجليزي
- 41EXPLAIN ANALYZE والـ Planner: اقرا الـ plan وصلّح الـ query
- 42الـ Transactions بـ node-postgres: كله أو ولا حاجة
- 43الـ MVCC ومستويات الـ Isolation: transactions كتير في نفس الوقت
- 44الـ Locks والـ Deadlocks: مين مستني مين
- 45SKIP LOCKED و Job Leasing: Postgres كـ job queue
- 46Row Level Security والـ Multi-tenancy: كل عميل يشوف بياناته بسانت هنا
- 47Migrations من غير downtime: expand و backfill و contract
- 48الـ Replication والـ Read Replicas: نسخ حية من الـ database
- 49الـ Connection Pooling و PgBouncer: connections أقل، requests أكتر
- 50الـ Partitioning والـ VACUUM والمراقبة: Postgres على المدى الطويل
- 51Redis وأنواع البيانات: strings و hashes و lists و sets و sorted sets
- 52Cache-aside والـ TTL: Redis قدام الـ database
- 53الـ Cache invalidation والـ Stampede: لما الـ key الشهير يموت
- 54Lua والـ Atomicity في Redis: كام أمر كأنهم أمر واحد
- 55الـ Rate Limiting في Redis: fixed window و sliding window و token bucket
- 56الـ Sessions في Redis: تسجيل دخول تقدر تلغيه في أي وقت
- 57Redis Streams والـ Consumer Groups: log بيتوزع على workers
- 58Pub/Sub و BullMQ: إشارات بين الـ instances، وطوابير شغل محترمة
- 59Redis لما يقع: الـ persistence (RDB و AOF) والـ replication
- 60Redis في الإنتاج: الـ ACLs والـ Cluster والمراقبة
- 61تخزين الـ Passwords بـ Argon2id: صح من أول مرة
- 62Session Fixation والـ Rotation: id جديد مع كل صلاحية جديدة
- 63الـ Cookie Flags والـ CSRF: المتصفح بيبعت الـ cookie، فلازم تتأكد مين اللي طلب
- 64الـ XSS والـ Content Security Policy: ما تخليش النص يتحوّل لـ code
- 65الـ OAuth و OpenID Connect و PKCE: login بـ Google من غير ما تشوف الـ password
- 66التأكد من الـ JWT صح: التوقيع والـ claims والـ scopes
- 67الـ BOLA و BFLA: الـ token السليم مش معناه إن الطلب مسموح
- 68الـ RBAC و ABAC والملكية: policy واحدة بدل ifs متفرقة
- 69الـ MFA والـ recovery: التاني factor اللي بجد
- 70الـ Passkeys و WebAuthn: login من غير password وضد الـ phishing
- 71الـ Threat Modeling بـ STRIDE: فكّر زي المهاجم قبل ما تكتب code
- 72الـ SQL Injection والـ Parameterization: الـ data ما تبقاش code
- 73الـ SSRF والـ Egress: ما تخليش الـ server بتاعك يزور الشبكة الداخلية
- 74الـ Security Headers والـ TLS: كل response يقول للـ browser يحمي المستخدم إزاي
- 75توقيع الـ Webhooks والـ Replay: الـ webhook ده جاي فعلًا من Stripe؟
- 76تغيير الأسرار والـ HMAC: إزاي تغيّر مفتاح من غير ما كل حاجة تقع
- 77سلسلة التوريد والـ SBOM: إنت واثق في ألف package ما تعرفهمش؟
- 78الـ Audit والـ Privacy Logs: سجّل مين عمل إيه، من غير ما تسجّل الأسرار
- 79اختبار الأمان و OWASP ASVS: الأمن جُوّه الـ CI، مش audit آخر السنة
- 80الـ Prototype Pollution والـ Resource DoS: request واحد يخلّي الكل admin أو يوقّع الـ server
- 81الـ SLI والـ SLO والـ Error Budget: إمتى تصحّي الـ on-call وإمتى تسيبه نايم
- 82الـ Event Loop Delay والـ ELU: لما Node نفسه يتخنق
- 83الـ Worker Threads والـ CPU Profiling: الشغل التقيل بره الـ event loop، والوقت راح فين
- 84الـ Memory والـ GC والـ Leaks: الـ process اللي بيكبر لحد ما يقع
- 85الـ N+1 Queries والـ DataLoader: صفحة واحدة بمِيّتين query
- 86الـ HTTP Caching والـ Compression: أسرع request هو اللي ما بيوصلش
- 87الـ Load Testing والـ Soak Testing: الـ server بيستحمل قد إيه بجد
- 88الـ Concurrency Limits والـ Bulkheads: dependency بطيئة ما توقعش الـ app كله
- 89الـ Timeouts والـ Retries والـ Circuit Breakers: إزاي تتعامل مع dependency بطيئة أو واقعة
- 90OpenTelemetry والـ Distributed Tracing: الـ request راح فين وضاع وقته فين
- 91Docker Layers والـ Build Context: ليه الـ build بياخد دقيقة وفيه الـ .env بتاعك
- 92Multi-stage Builds و Non-root: image صغيرة ومن غير root
- 93Docker Compose والـ Networks: الـ services بتلاقي بعض إزاي
- 94Docker Volumes: الـ data بتتحفَظ فين
- 95Healthcheck و Restart و Resource Limits: running مش معناها شغّال
- 96BuildKit والـ Build Secrets: الـ token ما يدخلش الـ image
- 97Reverse Proxy و TLS: اللي واقف قدام الـ app
- 98Multi-arch Images والـ Native Modules: اشتغلت عندي
- 99CI/CD و Rollback و Canary: الـ deploy يبقى ممل
- 100Kubernetes من الأول: Pods و Deployments و Services و Probes
- 101Modular Monolith و DDD: حدود واضحة من غير network
- 102Transactional Outbox و Inbox: الـ event ما يضيعش وما يتنفذش مرتين
- 103Sagas: عملية واحدة على تلات services من غير transaction واحدة
- 104CQRS و Event Sourcing: الـ events هي الحقيقة
- 105الـ Queues والـ Brokers: BullMQ و RabbitMQ و Kafka و SQS
- 106Realtime على أكتر من instance: Redis pub/sub و presence و resume
- 107الـ Object Storage والـ Media: presigned URLs و uploads مباشرة
- 108التكامل مع الـ Email والـ Search: retries و webhooks و indexes
- 109GraphQL و gRPC في الإنتاج: contracts و DataLoader و limits و deadlines
- 110Kafka على أكتر من zone و region: الـ replication والـ ISR والـ acks والـ MirrorMaker والـ failover
- 111TypeScript و runtime boundaries: الـ types بتختفي، والـ schemas لأ
- 112ORM ولا SQL: query builders و repositories و migrations و transactions
- 113الـ Serverless من جُوّه: cold starts و freeze و timeouts و connections
- 114الـ Testing Pyramid: unit و integration و e2e على Postgres حقيقية
- 115Contract Testing و Property-Based Testing بـ fast-check
- 116الـ Payments: idempotency و webhooks و refunds و reconciliation
- 117الـ Timezones والـ Internationalization: UTC و DST والـ locales والـ plurals والفلوس
- 118الـ Privacy والـ Data Retention: consent و export و erasure و crypto shredding
- 119الـ ADRs والـ Feature Flags: القرارات المكتوبة والـ rollout من غير deploy
- 120Multi-region active-active: حل الـ conflicts بـ HLC و CRDTs
- 121Readiness و Liveness و Startup Probes: الـ pod جاهز ولا عايش؟
- 122Incident Runbooks: من الـ alert للـ postmortem