PostgreSQL row level security (RLS) ļauj piesaistīt tabulai noteikumu, piemēram, "tikai rindas, kurās tenant_id atbilst pašreizējam nomniekam", un PostgreSQL to piemēro katram vaicājumam. Daudznomnieku SaaS tas pārnes izolāciju no "katrs izstrādātājs atceras WHERE tenant_id = ?" uz pašu datubāzi. Viens aizmirsts filtrs atskaitē vairs nenopludina cita klienta datus.
RLS ir uzticama, bet tai ir izņēmumi, kas pieķer komandas: tabulu īpašnieki, superlietotāji, skati un sesijas iestatījumi savienojumu pūlā. Tālāk: strādājoša nomnieku politika, apiešanas noteikumi, kā auditēt esošu datubāzi un kas mainās lielās tabulās.
Kā RLS darbojas divās minūtēs
- Tā ir izslēgta, līdz to ieslēdzat. Politikām nav efekta, līdz palaižat
ALTER TABLE ... ENABLE ROW LEVEL SECURITY, kā norādaCREATE POLICYdokumentācija. - Ieslēgta bez politikas nozīmē nevienu rindu. Saskaņā ar rindu drošības dokumentāciju, ja RLS ir ieslēgta un neviena politika neattiecas, tiek izmantota noklusējuma aizlieguma politika, un nekas nav redzams vai maināms.
USINGfiltrē esošās rindas,WITH CHECKpārbauda jaunās.USINGnosaka, kuras rindas vaicājums var redzēt, atjaunināt vai dzēst.WITH CHECKnosaka, kuras rindasINSERTvaiUPDATEdrīkst ierakstīt. Ja norādāt tikaiUSING, tas tiek izmantots abiem.- Politikas apvienojas. Atļaujošās politikas, kas ir noklusējums, tiek apvienotas ar
OR. Ierobežojošās tiek apvienotas arAND. Tāpēc viena pārāk plaša atļaujošā politika atver tabulu neatkarīgi no tā, ko saka pārējās.
Nomnieku izolācijas politika
Izplatītais SaaS modelis ir viena datubāzes loma lietotnei un sesijas iestatījums, kas nes pašreizējo nomnieku. PostgreSQL pieņem jebkuru divdaļīgu iestatījuma nosaukumu, piemēram, app.tenant_id, kā pielāgotu vietturētāja mainīgo, un current_setting(name, true) atgriež NULL, nevis kļūdu, ja tas nav iestatīts.
BEGIN;
SET LOCAL lock_timeout = '5s';
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);
ALTER TABLE invoices ENABLE ROW LEVEL SECURITY;
ALTER TABLE invoices FORCE ROW LEVEL SECURITY; -- apply to the table owner too
COMMIT;
Dažas detaļas ir svarīgas:
- Izveidojiet politiku pirms RLS ieslēgšanas, vienā transakcijā. Ieslēdzot vispirms, tabula pāriet uz noklusējuma aizliegumu, un lietotne redz tukšus rezultātus, līdz politika pastāv.
nullif(..., '')ir apzināts. Mūsu pieredzē iestatījums, kas sesijā iestatīts agrāk, pēc transakcijas beigām var atgriezties kā tukša virkne, nevis NULL, un''::bigintizraisa kļūdu. Arnulliftrūkstošs nomnieks vienkārši neatbilst nekam.FORCE ROW LEVEL SECURITYattiecas arī uz īpašnieku. Dokumentācija saka, ka tabulu īpašnieki parasti apiet RLS. Ja jūsu lietotne pieslēdzas kā loma, kurai pieder tabulas, kas ir ļoti izplatīti, politika bezFORCEneko nedara.
Lietotne tad iestata nomnieku katras transakcijas sākumā:
BEGIN;
SELECT set_config('app.tenant_id', '42', true); -- true = this transaction only
SELECT id, total FROM invoices WHERE status = 'open';
COMMIT;
Savienojumu pūli un nomnieka iestatījums
Šeit RLS iestatījumi visbiežāk noiet greizi. Ar PgBouncer transakciju režīmā viena klienta secīgas transakcijas var izpildīties dažādos servera savienojumos, un viens servera savienojums apkalpo daudzus klientus. Sesijas līmeņa SET app.tenant_id tāpēc var palikt savienojumā un attiekties uz nākamā klienta transakciju.
Izmantojiet set_config(..., true) vai SET LOCAL, ko dokumentācija apraksta kā spēkā esošu tikai pašreizējā transakcijā, un iestatiet to katrā transakcijā. Padariet "nomnieks nav iestatīts" par neatbilstību nevienai rindai, kā augstāk, lai trūkstošs izsaukums aizvērtos droši. Mūsu PgBouncer rokasgrāmata sīkāk apraksta pūla režīmus.
app.tenant_id. RLS ar sesijas iestatījumu jūs aizsargā pret lietotnes kļūdām, piemēram, trūkstošu filtru, nevis pret uzbrucēju, kas var palaist patvaļīgu SQL kā lietotnes loma. Ja tas ir daļa no jūsu draudu modeļa, izmantojiet atsevišķas datubāzes lomas katram nomniekam vai pārbaudiet nomnieku SECURITY DEFINER funkcijā.Kas apiet RLS
- Superlietotāji un
BYPASSRLSlomas to apiet vienmēr. Turiet abus tālu no lietotnes lomas. - Tabulu īpašnieki to apiet, ja vien tabulai nav
FORCE ROW LEVEL SECURITY. - Skati pēc noklusējuma darbojas kā to īpašnieks.
CREATE VIEWdokumentācija saka, ka pamattabulām tiek piemērotas skata īpašnieka politikas. Ja skatu izveidoja superlietotājs vai tabulas īpašnieks, skats atgriež visu nomnieku rindas. Kopš PostgreSQL 15 skatu var pārslēgt uz izsaucēja tiesībām un politikām:ALTER VIEW open_invoices SET (security_invoker = true); - Visas tabulas operācijas, piemēram,
TRUNCATEunREFERENCES, nav pakļautas rindu drošībai. - Ierobežojumu pārbaudes unikālām un ārējām atslēgām vienmēr apiet RLS. Dokumentācija brīdina, ka tas var nopludināt informāciju: ieraksts, kas neizdodas ar dublētas atslēgas kļūdu, pasaka lietotājam, ka rinda ar šo vērtību pastāv citā nomniekā. Izvairieties no globāli unikālām biznesa atslēgām, kas kaut ko atklāj, vai iekļaujiet tajās
tenant_id.
Ievērojiet arī, ka INSERT ... ON CONFLICT DO UPDATE pārbauda rindas pret tabulas SELECT politikām un izraisa kļūdu, nevis klusi izlaiž. Tāpēc upsert vaicājumiem vajag SELECT politiku papildus INSERT un UPDATE.
Esošas datubāzes audits
-- Which tables have RLS, and is it forced?
SELECT c.oid::regclass AS table_name, c.relrowsecurity, c.relforcerowsecurity
FROM pg_class c
JOIN pg_namespace n ON n.oid = c.relnamespace
WHERE c.relkind IN ('r', 'p')
AND n.nspname NOT IN ('pg_catalog', 'information_schema')
ORDER BY c.relrowsecurity, 1;
-- Which roles skip RLS entirely?
SELECT rolname FROM pg_roles WHERE rolsuper OR rolbypassrls;
-- What the policies actually say
SELECT tablename, policyname, permissive, roles, cmd, qual, with_check
FROM pg_policies ORDER BY tablename;
Meklējiet nomnieku tabulas ar relrowsecurity = false, tabulas, ko izmanto īpašnieka loma bez relforcerowsecurity, negaidītus dalībniekus apiešanas sarakstā un skatus, ko izveidojušas privileģētas lomas. Tad testējiet kā īstā lietotnes loma: iestatiet nomnieku A, mēģiniet lasīt, atjaunināt un ievietot nomnieka B rindas, un iekļaujiet testu CI. Mūsu PostgreSQL drošības stiprināšanas kontrolsaraksts aptver lomu iestatījumus ap to.
Kas mainās lielās datubāzēs
- Politika ir daļa no katra vaicājuma. Indeksējiet tabulas ar
tenant_idkā pirmo kolonnu un arEXPLAINpārbaudiet, ka nomnieka nosacījums parādās kā indeksa nosacījums, nevis kā filtrs pēc daudzu nomnieku skenēšanas. - Turiet politiku izteiksmes vienkāršas. Politika ar apakšvaicājumu, piemēram, dalības uzmeklēšanu citā tabulā, tiek izvērtēta kā daļa no katra vaicājuma, kas skar tabulu. Vienkārša vienādība pret iestatījumu ir lēta; savienojums nav. Ja vajag dalības loģiku, nosakiet nomnieku vienreiz lietotnē vai funkcijā un saglabājiet to iestatījumā.
- Sekojiet vaicājumu plāniem ar ne-leakproof funkcijām. Dokumentācija saka, ka politiku nosacījumi tiek piemēroti pirms lietotāja nosacījumiem, izņemot funkcijas un operatorus, kas atzīmēti kā
LEAKPROOF. Mūsu pieredzē tas var mainīt filtru secību un dažreiz plānu, tāpēc salīdziniet smagāko vaicājumu plānus ar RLS un bez tās. - Nevienmērīgi nomnieki jātestē atsevišķi. Kopīgā tabulā, kur vienam nomniekam pieder liela daļa rindu, labākais plāns lielajam nomniekam var atšķirties no labākā plāna mazajiem. Testējiet abus ar produkcijas izmēra datiem.
- Rezerves kopijām jāredz visas rindas.
pg_dumppēc noklusējuma iestatarow_securityuzoffun neizdodas ar kļūdu, ja loma nevar apiet RLS, un tas ir tas, ko vēlaties: klusi daļēja rezerves kopija būtu sliktāka. Veidojiet rezerves kopijas kā loma arBYPASSRLSvai kā īpašnieks. - Arī loģiskajai replikācijai vajag tiesības. PostgreSQL 15 laidiena piezīmēs teikts, ka tikai superlietotāji, lomas ar
BYPASSRLSun tabulu īpašnieki var replicēt tabulās ar rindu drošības politikām. Plānojiet abonementa īpašnieku pirms migrācijas, nevis tās laikā. - RLS ieviešana darbojošā sistēmā. Ieslēdziet to pa tabulai, īsās transakcijās ar
lock_timeout, un izvietojiet lietotnes izmaiņu, kas iestata nomnieku, pirms ieslēdzat politiku. Sekojiet vaicājumiem, kas pēkšņi atgriež nulli rindu; tas ir noklusējuma aizliegums, kas jums saka, ka kāds koda ceļš neiestata nomnieku.
Galvenās atziņas
- RLS darbojas tikai pēc
ENABLE ROW LEVEL SECURITY, un bez atbilstošas politikas neviens neko neredz. - Izmantojiet
FORCE ROW LEVEL SECURITY, ja lietotne pieslēdzas kā tabulas īpašnieks. - Iestatiet nomnieku katrā transakcijā ar
set_config(..., true), īpaši aiz PgBouncer, un padariet trūkstošu nomnieku par neatbilstību nevienai rindai. - Superlietotāji,
BYPASSRLSlomas, īpašnieka skati,TRUNCATEun ierobežojumu pārbaudes apiet politikas. - Indeksējiet ar
tenant_idpirmo, turiet politikas vienkāršas un salīdziniet plānus ar ieslēgtu RLS. - Veidojiet rezerves kopijas kā loma, kas apiet RLS;
pg_dumpneizdodas, nevis izveido daļēju kopiju.