import { DOCS_URL } from 'lib/constants' import { executeQuery } from './query' import { paths } from 'api-types' import { WrappedResult } from 'lib/api/self-hosted/types' interface GetLintsOptions { headers?: HeadersInit } export async function getLints({ headers }: GetLintsOptions) { return await executeQuery({ query: enrichQuery(LINT_SQL), headers }) } export type ResponseData = paths['/platform/projects/{ref}/run-lints']['get']['responses']['200']['content']['application/json'] export const enrichQuery = (query: string) => ` -- source: dashboard -- user: ${'self host'} -- date: ${new Date().toISOString()} ${query} ` // Pulled from https://github.com/supabase/splinter/blob/main/splinter.sql const LINT_SQL = /* SQL */ `set local search_path = ''; ( with foreign_keys as ( select cl.relnamespace::regnamespace::text as schema_name, cl.relname as table_name, cl.oid as table_oid, ct.conname as fkey_name, ct.conkey as col_attnums from pg_catalog.pg_constraint ct join pg_catalog.pg_class cl -- fkey owning table on ct.conrelid = cl.oid left join pg_catalog.pg_depend d on d.objid = cl.oid and d.deptype = 'e' where ct.contype = 'f' -- foreign key constraints and d.objid is null -- exclude tables that are dependencies of extensions and cl.relnamespace::regnamespace::text not in ( 'pg_catalog', 'information_schema', 'auth', 'storage', 'vault', 'extensions' ) ), index_ as ( select pi.indrelid as table_oid, indexrelid::regclass as index_, string_to_array(indkey::text, ' ')::smallint[] as col_attnums from pg_catalog.pg_index pi where indisvalid ) select 'unindexed_foreign_keys' as name, 'Unindexed foreign keys' as title, 'INFO' as level, 'EXTERNAL' as facing, array['PERFORMANCE'] as categories, 'Identifies foreign key constraints without a covering index, which can impact database performance.' as description, format( 'Table \`%s.%s\` has a foreign key \`%s\` without a covering index. This can lead to suboptimal query performance.', fk.schema_name, fk.table_name, fk.fkey_name ) as detail, '${DOCS_URL}/guides/database/database-linter?lint=0001_unindexed_foreign_keys' as remediation, jsonb_build_object( 'schema', fk.schema_name, 'name', fk.table_name, 'type', 'table', 'fkey_name', fk.fkey_name, 'fkey_columns', fk.col_attnums ) as metadata, format('unindexed_foreign_keys_%s_%s_%s', fk.schema_name, fk.table_name, fk.fkey_name) as cache_key from foreign_keys fk left join index_ idx on fk.table_oid = idx.table_oid and fk.col_attnums = idx.col_attnums left join pg_catalog.pg_depend dep on idx.table_oid = dep.objid and dep.deptype = 'e' where idx.index_ is null and fk.schema_name not in ( '_timescaledb_cache', '_timescaledb_catalog', '_timescaledb_config', '_timescaledb_internal', 'auth', 'cron', 'extensions', 'graphql', 'graphql_public', 'information_schema', 'net', 'pgroonga', 'pgsodium', 'pgsodium_masks', 'pgtle', 'pgbouncer', 'pg_catalog', 'pgtle', 'realtime', 'repack', 'storage', 'supabase_functions', 'supabase_migrations', 'tiger', 'topology', 'vault' ) and dep.objid is null -- exclude tables owned by extensions order by fk.schema_name, fk.table_name, fk.fkey_name) union all ( select 'auth_users_exposed' as name, 'Exposed Auth Users' as title, 'ERROR' as level, 'EXTERNAL' as facing, array['SECURITY'] as categories, 'Detects if auth.users is exposed to anon or authenticated roles via a view or materialized view in schemas exposed to PostgREST, potentially compromising user data security.' as description, format( 'View/Materialized View "%s" in the public schema may expose \`auth.users\` data to anon or authenticated roles.', c.relname ) as detail, '${DOCS_URL}/guides/database/database-linter?lint=0002_auth_users_exposed' as remediation, jsonb_build_object( 'schema', n.nspname, 'name', c.relname, 'type', 'view', 'exposed_to', array_remove(array_agg(DISTINCT case when pg_catalog.has_table_privilege('anon', c.oid, 'SELECT') then 'anon' when pg_catalog.has_table_privilege('authenticated', c.oid, 'SELECT') then 'authenticated' end), null) ) as metadata, format('auth_users_exposed_%s_%s', n.nspname, c.relname) as cache_key from -- Identify the oid for auth.users pg_catalog.pg_class auth_users_pg_class join pg_catalog.pg_namespace auth_users_pg_namespace on auth_users_pg_class.relnamespace = auth_users_pg_namespace.oid and auth_users_pg_class.relname = 'users' and auth_users_pg_namespace.nspname = 'auth' -- Depends on auth.users join pg_catalog.pg_depend d on d.refobjid = auth_users_pg_class.oid join pg_catalog.pg_rewrite r on r.oid = d.objid join pg_catalog.pg_class c on c.oid = r.ev_class join pg_catalog.pg_namespace n on n.oid = c.relnamespace join pg_catalog.pg_class pg_class_auth_users on d.refobjid = pg_class_auth_users.oid where d.deptype = 'n' and ( pg_catalog.has_table_privilege('anon', c.oid, 'SELECT') or pg_catalog.has_table_privilege('authenticated', c.oid, 'SELECT') ) and n.nspname = any(array(select trim(unnest(string_to_array(current_setting('pgrst.db_schemas', 't'), ','))))) -- Exclude self and c.relname <> '0002_auth_users_exposed' -- There are 3 insecure configurations and ( -- Materialized views don't support RLS so this is insecure by default (c.relkind in ('m')) -- m for materialized view or -- Standard View, accessible to anon or authenticated that is security_definer ( c.relkind = 'v' -- v for view -- Exclude security invoker views and not ( lower(coalesce(c.reloptions::text,'{}'))::text[] && array[ 'security_invoker=1', 'security_invoker=true', 'security_invoker=yes', 'security_invoker=on' ] ) ) or -- Standard View, security invoker, but no RLS enabled on auth.users ( c.relkind in ('v') -- v for view -- is security invoker and ( lower(coalesce(c.reloptions::text,'{}'))::text[] && array[ 'security_invoker=1', 'security_invoker=true', 'security_invoker=yes', 'security_invoker=on' ] ) and not pg_class_auth_users.relrowsecurity ) ) group by n.nspname, c.relname, c.oid) union all ( with policies as ( select nsp.nspname as schema_name, pb.tablename as table_name, pc.relrowsecurity as is_rls_active, polname as policy_name, polpermissive as is_permissive, -- if not, then restrictive (select array_agg(r::regrole) from unnest(polroles) as x(r)) as roles, case polcmd when 'r' then 'SELECT' when 'a' then 'INSERT' when 'w' then 'UPDATE' when 'd' then 'DELETE' when '*' then 'ALL' end as command, qual, with_check from pg_catalog.pg_policy pa join pg_catalog.pg_class pc on pa.polrelid = pc.oid join pg_catalog.pg_namespace nsp on pc.relnamespace = nsp.oid join pg_catalog.pg_policies pb on pc.relname = pb.tablename and nsp.nspname = pb.schemaname and pa.polname = pb.policyname ) select 'auth_rls_initplan' as name, 'Auth RLS Initialization Plan' as title, 'WARN' as level, 'EXTERNAL' as facing, array['PERFORMANCE'] as categories, 'Detects if calls to \`auth.()\` in RLS policies are being unnecessarily re-evaluated for each row' as description, format( 'Table \`%s.%s\` has a row level security policy \`%s\` that re-evaluates an auth.() for each row. This produces suboptimal query performance at scale. Resolve the issue by replacing \`auth.()\` with \`(select auth.())\`. See [docs](${DOCS_URL}/guides/database/postgres/row-level-security#call-functions-with-select) for more info.', schema_name, table_name, policy_name ) as detail, '${DOCS_URL}/guides/database/database-linter?lint=0003_auth_rls_initplan' as remediation, jsonb_build_object( 'schema', schema_name, 'name', table_name, 'type', 'table' ) as metadata, format('auth_rls_init_plan_%s_%s_%s', schema_name, table_name, policy_name) as cache_key from policies where is_rls_active -- NOTE: does not include realtime in support of monitoring policies on realtime.messages and schema_name not in ( '_timescaledb_cache', '_timescaledb_catalog', '_timescaledb_config', '_timescaledb_internal', 'auth', 'cron', 'extensions', 'graphql', 'graphql_public', 'information_schema', 'net', 'pgroonga', 'pgsodium', 'pgsodium_masks', 'pgtle', 'pgbouncer', 'pg_catalog', 'pgtle', 'repack', 'storage', 'supabase_functions', 'supabase_migrations', 'tiger', 'topology', 'vault' ) and ( -- Example: auth.uid() ( qual like '%auth.uid()%' and lower(qual) not like '%select auth.uid()%' ) or ( qual like '%auth.jwt()%' and lower(qual) not like '%select auth.jwt()%' ) or ( qual like '%auth.role()%' and lower(qual) not like '%select auth.role()%' ) or ( qual like '%auth.email()%' and lower(qual) not like '%select auth.email()%' ) or ( with_check like '%auth.uid()%' and lower(with_check) not like '%select auth.uid()%' ) or ( with_check like '%auth.jwt()%' and lower(with_check) not like '%select auth.jwt()%' ) or ( with_check like '%auth.role()%' and lower(with_check) not like '%select auth.role()%' ) or ( with_check like '%auth.email()%' and lower(with_check) not like '%select auth.email()%' ) )) union all ( select 'no_primary_key' as name, 'No Primary Key' as title, 'INFO' as level, 'EXTERNAL' as facing, array['PERFORMANCE'] as categories, 'Detects if a table does not have a primary key. Tables without a primary key can be inefficient to interact with at scale.' as description, format( 'Table \`%s.%s\` does not have a primary key', pgns.nspname, pgc.relname ) as detail, '${DOCS_URL}/guides/database/database-linter?lint=0004_no_primary_key' as remediation, jsonb_build_object( 'schema', pgns.nspname, 'name', pgc.relname, 'type', 'table' ) as metadata, format( 'no_primary_key_%s_%s', pgns.nspname, pgc.relname ) as cache_key from pg_catalog.pg_class pgc join pg_catalog.pg_namespace pgns on pgns.oid = pgc.relnamespace left join pg_catalog.pg_index pgi on pgi.indrelid = pgc.oid left join pg_catalog.pg_depend dep on pgc.oid = dep.objid and dep.deptype = 'e' where pgc.relkind = 'r' -- regular tables and pgns.nspname not in ( '_timescaledb_cache', '_timescaledb_catalog', '_timescaledb_config', '_timescaledb_internal', 'auth', 'cron', 'extensions', 'graphql', 'graphql_public', 'information_schema', 'net', 'pgroonga', 'pgsodium', 'pgsodium_masks', 'pgtle', 'pgbouncer', 'pg_catalog', 'pgtle', 'realtime', 'repack', 'storage', 'supabase_functions', 'supabase_migrations', 'tiger', 'topology', 'vault' ) and dep.objid is null -- exclude tables owned by extensions group by pgc.oid, pgns.nspname, pgc.relname having max(coalesce(pgi.indisprimary, false)::int) = 0) union all ( select 'unused_index' as name, 'Unused Index' as title, 'INFO' as level, 'EXTERNAL' as facing, array['PERFORMANCE'] as categories, 'Detects if an index has never been used and may be a candidate for removal.' as description, format( 'Index \`%s\` on table \`%s.%s\` has not been used', psui.indexrelname, psui.schemaname, psui.relname ) as detail, '${DOCS_URL}/guides/database/database-linter?lint=0005_unused_index' as remediation, jsonb_build_object( 'schema', psui.schemaname, 'name', psui.relname, 'type', 'table' ) as metadata, format( 'unused_index_%s_%s_%s', psui.schemaname, psui.relname, psui.indexrelname ) as cache_key from pg_catalog.pg_stat_user_indexes psui join pg_catalog.pg_index pi on psui.indexrelid = pi.indexrelid left join pg_catalog.pg_depend dep on psui.relid = dep.objid and dep.deptype = 'e' where psui.idx_scan = 0 and not pi.indisunique and not pi.indisprimary and dep.objid is null -- exclude tables owned by extensions and psui.schemaname not in ( '_timescaledb_cache', '_timescaledb_catalog', '_timescaledb_config', '_timescaledb_internal', 'auth', 'cron', 'extensions', 'graphql', 'graphql_public', 'information_schema', 'net', 'pgroonga', 'pgsodium', 'pgsodium_masks', 'pgtle', 'pgbouncer', 'pg_catalog', 'pgtle', 'realtime', 'repack', 'storage', 'supabase_functions', 'supabase_migrations', 'tiger', 'topology', 'vault' )) union all ( select 'multiple_permissive_policies' as name, 'Multiple Permissive Policies' as title, 'WARN' as level, 'EXTERNAL' as facing, array['PERFORMANCE'] as categories, 'Detects if multiple permissive row level security policies are present on a table for the same \`role\` and \`action\` (e.g. insert). Multiple permissive policies are suboptimal for performance as each policy must be executed for every relevant query.' as description, format( 'Table \`%s.%s\` has multiple permissive policies for role \`%s\` for action \`%s\`. Policies include \`%s\`', n.nspname, c.relname, r.rolname, act.cmd, array_agg(p.polname order by p.polname) ) as detail, '${DOCS_URL}/guides/database/database-linter?lint=0006_multiple_permissive_policies' as remediation, jsonb_build_object( 'schema', n.nspname, 'name', c.relname, 'type', 'table' ) as metadata, format( 'multiple_permissive_policies_%s_%s_%s_%s', n.nspname, c.relname, r.rolname, act.cmd ) as cache_key from pg_catalog.pg_policy p join pg_catalog.pg_class c on p.polrelid = c.oid join pg_catalog.pg_namespace n on c.relnamespace = n.oid join pg_catalog.pg_roles r on p.polroles @> array[r.oid] or p.polroles = array[0::oid] left join pg_catalog.pg_depend dep on c.oid = dep.objid and dep.deptype = 'e', lateral ( select x.cmd from unnest(( select case p.polcmd when 'r' then array['SELECT'] when 'a' then array['INSERT'] when 'w' then array['UPDATE'] when 'd' then array['DELETE'] when '*' then array['SELECT', 'INSERT', 'UPDATE', 'DELETE'] else array['ERROR'] end as actions )) x(cmd) ) act(cmd) where c.relkind = 'r' -- regular tables and p.polpermissive -- policy is permissive and n.nspname not in ( '_timescaledb_cache', '_timescaledb_catalog', '_timescaledb_config', '_timescaledb_internal', 'auth', 'cron', 'extensions', 'graphql', 'graphql_public', 'information_schema', 'net', 'pgroonga', 'pgsodium', 'pgsodium_masks', 'pgtle', 'pgbouncer', 'pg_catalog', 'pgtle', 'realtime', 'repack', 'storage', 'supabase_functions', 'supabase_migrations', 'tiger', 'topology', 'vault' ) and r.rolname not like 'pg_%' and r.rolname not like 'supabase%admin' and not r.rolbypassrls and dep.objid is null -- exclude tables owned by extensions group by n.nspname, c.relname, r.rolname, act.cmd having count(1) > 1) union all ( select 'policy_exists_rls_disabled' as name, 'Policy Exists RLS Disabled' as title, 'ERROR' as level, 'EXTERNAL' as facing, array['SECURITY'] as categories, 'Detects cases where row level security (RLS) policies have been created, but RLS has not been enabled for the underlying table.' as description, format( 'Table \`%s.%s\` has RLS policies but RLS is not enabled on the table. Policies include %s.', n.nspname, c.relname, array_agg(p.polname order by p.polname) ) as detail, '${DOCS_URL}/guides/database/database-linter?lint=0007_policy_exists_rls_disabled' as remediation, jsonb_build_object( 'schema', n.nspname, 'name', c.relname, 'type', 'table' ) as metadata, format( 'policy_exists_rls_disabled_%s_%s', n.nspname, c.relname ) as cache_key from pg_catalog.pg_policy p join pg_catalog.pg_class c on p.polrelid = c.oid join pg_catalog.pg_namespace n on c.relnamespace = n.oid left join pg_catalog.pg_depend dep on c.oid = dep.objid and dep.deptype = 'e' where c.relkind = 'r' -- regular tables and n.nspname not in ( '_timescaledb_cache', '_timescaledb_catalog', '_timescaledb_config', '_timescaledb_internal', 'auth', 'cron', 'extensions', 'graphql', 'graphql_public', 'information_schema', 'net', 'pgroonga', 'pgsodium', 'pgsodium_masks', 'pgtle', 'pgbouncer', 'pg_catalog', 'pgtle', 'realtime', 'repack', 'storage', 'supabase_functions', 'supabase_migrations', 'tiger', 'topology', 'vault' ) -- RLS is disabled and not c.relrowsecurity and dep.objid is null -- exclude tables owned by extensions group by n.nspname, c.relname) union all ( select 'rls_enabled_no_policy' as name, 'RLS Enabled No Policy' as title, 'INFO' as level, 'EXTERNAL' as facing, array['SECURITY'] as categories, 'Detects cases where row level security (RLS) has been enabled on a table but no RLS policies have been created.' as description, format( 'Table \`%s.%s\` has RLS enabled, but no policies exist', n.nspname, c.relname ) as detail, '${DOCS_URL}/guides/database/database-linter?lint=0008_rls_enabled_no_policy' as remediation, jsonb_build_object( 'schema', n.nspname, 'name', c.relname, 'type', 'table' ) as metadata, format( 'rls_enabled_no_policy_%s_%s', n.nspname, c.relname ) as cache_key from pg_catalog.pg_class c left join pg_catalog.pg_policy p on p.polrelid = c.oid join pg_catalog.pg_namespace n on c.relnamespace = n.oid left join pg_catalog.pg_depend dep on c.oid = dep.objid and dep.deptype = 'e' where c.relkind = 'r' -- regular tables and n.nspname not in ( '_timescaledb_cache', '_timescaledb_catalog', '_timescaledb_config', '_timescaledb_internal', 'auth', 'cron', 'extensions', 'graphql', 'graphql_public', 'information_schema', 'net', 'pgroonga', 'pgsodium', 'pgsodium_masks', 'pgtle', 'pgbouncer', 'pg_catalog', 'pgtle', 'realtime', 'repack', 'storage', 'supabase_functions', 'supabase_migrations', 'tiger', 'topology', 'vault' ) -- RLS is enabled and c.relrowsecurity and p.polname is null and dep.objid is null -- exclude tables owned by extensions group by n.nspname, c.relname) union all ( select 'duplicate_index' as name, 'Duplicate Index' as title, 'WARN' as level, 'EXTERNAL' as facing, array['PERFORMANCE'] as categories, 'Detects cases where two ore more identical indexes exist.' as description, format( 'Table \`%s.%s\` has identical indexes %s. Drop all except one of them', n.nspname, c.relname, array_agg(pi.indexname order by pi.indexname) ) as detail, '${DOCS_URL}/guides/database/database-linter?lint=0009_duplicate_index' as remediation, jsonb_build_object( 'schema', n.nspname, 'name', c.relname, 'type', case when c.relkind = 'r' then 'table' when c.relkind = 'm' then 'materialized view' else 'ERROR' end, 'indexes', array_agg(pi.indexname order by pi.indexname) ) as metadata, format( 'duplicate_index_%s_%s_%s', n.nspname, c.relname, array_agg(pi.indexname order by pi.indexname) ) as cache_key from pg_catalog.pg_indexes pi join pg_catalog.pg_namespace n on n.nspname = pi.schemaname join pg_catalog.pg_class c on pi.tablename = c.relname and n.oid = c.relnamespace left join pg_catalog.pg_depend dep on c.oid = dep.objid and dep.deptype = 'e' where c.relkind in ('r', 'm') -- tables and materialized views and n.nspname not in ( '_timescaledb_cache', '_timescaledb_catalog', '_timescaledb_config', '_timescaledb_internal', 'auth', 'cron', 'extensions', 'graphql', 'graphql_public', 'information_schema', 'net', 'pgroonga', 'pgsodium', 'pgsodium_masks', 'pgtle', 'pgbouncer', 'pg_catalog', 'pgtle', 'realtime', 'repack', 'storage', 'supabase_functions', 'supabase_migrations', 'tiger', 'topology', 'vault' ) and dep.objid is null -- exclude tables owned by extensions group by n.nspname, c.relkind, c.relname, replace(pi.indexdef, pi.indexname, '') having count(*) > 1) union all ( select 'security_definer_view' as name, 'Security Definer View' as title, 'ERROR' as level, 'EXTERNAL' as facing, array['SECURITY'] as categories, 'Detects views defined with the SECURITY DEFINER property. These views enforce Postgres permissions and row level security policies (RLS) of the view creator, rather than that of the querying user' as description, format( 'View \`%s.%s\` is defined with the SECURITY DEFINER property', n.nspname, c.relname ) as detail, '${DOCS_URL}/guides/database/database-linter?lint=0010_security_definer_view' as remediation, jsonb_build_object( 'schema', n.nspname, 'name', c.relname, 'type', 'view' ) as metadata, format( 'security_definer_view_%s_%s', n.nspname, c.relname ) as cache_key from pg_catalog.pg_class c join pg_catalog.pg_namespace n on n.oid = c.relnamespace left join pg_catalog.pg_depend dep on c.oid = dep.objid and dep.deptype = 'e' where c.relkind = 'v' and ( pg_catalog.has_table_privilege('anon', c.oid, 'SELECT') or pg_catalog.has_table_privilege('authenticated', c.oid, 'SELECT') ) and substring(pg_catalog.version() from 'PostgreSQL ([0-9]+)') >= '15' -- security invoker was added in pg15 and n.nspname = any(array(select trim(unnest(string_to_array(current_setting('pgrst.db_schemas', 't'), ','))))) and n.nspname not in ( '_timescaledb_cache', '_timescaledb_catalog', '_timescaledb_config', '_timescaledb_internal', 'auth', 'cron', 'extensions', 'graphql', 'graphql_public', 'information_schema', 'net', 'pgroonga', 'pgsodium', 'pgsodium_masks', 'pgtle', 'pgbouncer', 'pg_catalog', 'pgtle', 'realtime', 'repack', 'storage', 'supabase_functions', 'supabase_migrations', 'tiger', 'topology', 'vault' ) and dep.objid is null -- exclude views owned by extensions and not ( lower(coalesce(c.reloptions::text,'{}'))::text[] && array[ 'security_invoker=1', 'security_invoker=true', 'security_invoker=yes', 'security_invoker=on' ] )) union all ( select 'function_search_path_mutable' as name, 'Function Search Path Mutable' as title, 'WARN' as level, 'EXTERNAL' as facing, array['SECURITY'] as categories, 'Detects functions where the search_path parameter is not set to an empty string.' as description, format( 'Function \`%s.%s\` has a role mutable search_path', n.nspname, p.proname ) as detail, '${DOCS_URL}/guides/database/database-linter?lint=0011_function_search_path_mutable' as remediation, jsonb_build_object( 'schema', n.nspname, 'name', p.proname, 'type', 'function' ) as metadata, format( 'function_search_path_mutable_%s_%s_%s', n.nspname, p.proname, md5(p.prosrc) -- required when function is polymorphic ) as cache_key from pg_catalog.pg_proc p join pg_catalog.pg_namespace n on p.pronamespace = n.oid left join pg_catalog.pg_depend dep on p.oid = dep.objid and dep.deptype = 'e' where n.nspname not in ( '_timescaledb_cache', '_timescaledb_catalog', '_timescaledb_config', '_timescaledb_internal', 'auth', 'cron', 'extensions', 'graphql', 'graphql_public', 'information_schema', 'net', 'pgroonga', 'pgsodium', 'pgsodium_masks', 'pgtle', 'pgbouncer', 'pg_catalog', 'pgtle', 'realtime', 'repack', 'storage', 'supabase_functions', 'supabase_migrations', 'tiger', 'topology', 'vault' ) and dep.objid is null -- exclude functions owned by extensions -- Search path not set to '' and not coalesce(p.proconfig, '{}') && array['search_path=""']) union all ( select 'rls_disabled_in_public' as name, 'RLS Disabled in Public' as title, 'ERROR' as level, 'EXTERNAL' as facing, array['SECURITY'] as categories, 'Detects cases where row level security (RLS) has not been enabled on tables in schemas exposed to PostgREST' as description, format( 'Table \`%s.%s\` is public, but RLS has not been enabled.', n.nspname, c.relname ) as detail, '${DOCS_URL}/guides/database/database-linter?lint=0013_rls_disabled_in_public' as remediation, jsonb_build_object( 'schema', n.nspname, 'name', c.relname, 'type', 'table' ) as metadata, format( 'rls_disabled_in_public_%s_%s', n.nspname, c.relname ) as cache_key from pg_catalog.pg_class c join pg_catalog.pg_namespace n on c.relnamespace = n.oid where c.relkind = 'r' -- regular tables -- RLS is disabled and not c.relrowsecurity and ( pg_catalog.has_table_privilege('anon', c.oid, 'SELECT') or pg_catalog.has_table_privilege('authenticated', c.oid, 'SELECT') ) and n.nspname = any(array(select trim(unnest(string_to_array(current_setting('pgrst.db_schemas', 't'), ','))))) and n.nspname not in ( '_timescaledb_cache', '_timescaledb_catalog', '_timescaledb_config', '_timescaledb_internal', 'auth', 'cron', 'extensions', 'graphql', 'graphql_public', 'information_schema', 'net', 'pgroonga', 'pgsodium', 'pgsodium_masks', 'pgtle', 'pgbouncer', 'pg_catalog', 'pgtle', 'realtime', 'repack', 'storage', 'supabase_functions', 'supabase_migrations', 'tiger', 'topology', 'vault' )) union all ( select 'extension_in_public' as name, 'Extension in Public' as title, 'WARN' as level, 'EXTERNAL' as facing, array['SECURITY'] as categories, 'Detects extensions installed in the \`public\` schema.' as description, format( 'Extension \`%s\` is installed in the public schema. Move it to another schema.', pe.extname ) as detail, '${DOCS_URL}/guides/database/database-linter?lint=0014_extension_in_public' as remediation, jsonb_build_object( 'schema', pe.extnamespace::regnamespace, 'name', pe.extname, 'type', 'extension' ) as metadata, format( 'extension_in_public_%s', pe.extname ) as cache_key from pg_catalog.pg_extension pe where -- plpgsql is installed by default in public and outside user control -- confirmed safe pe.extname not in ('plpgsql') -- Scoping this to public is not optimal. Ideally we would use the postgres -- search path. That currently isn't available via SQL. In other lints -- we have used has_schema_privilege('anon', 'extensions', 'USAGE') but that -- is not appropriate here as it would evaluate true for the extensions schema and pe.extnamespace::regnamespace::text = 'public') union all ( with policies as ( select nsp.nspname as schema_name, pb.tablename as table_name, polname as policy_name, qual, with_check from pg_catalog.pg_policy pa join pg_catalog.pg_class pc on pa.polrelid = pc.oid join pg_catalog.pg_namespace nsp on pc.relnamespace = nsp.oid join pg_catalog.pg_policies pb on pc.relname = pb.tablename and nsp.nspname = pb.schemaname and pa.polname = pb.policyname ) select 'rls_references_user_metadata' as name, 'RLS references user metadata' as title, 'ERROR' as level, 'EXTERNAL' as facing, array['SECURITY'] as categories, 'Detects when Supabase Auth user_metadata is referenced insecurely in a row level security (RLS) policy.' as description, format( 'Table \`%s.%s\` has a row level security policy \`%s\` that references Supabase Auth \`user_metadata\`. \`user_metadata\` is editable by end users and should never be used in a security context.', schema_name, table_name, policy_name ) as detail, '${DOCS_URL}/guides/database/database-linter?lint=0015_rls_references_user_metadata' as remediation, jsonb_build_object( 'schema', schema_name, 'name', table_name, 'type', 'table' ) as metadata, format('rls_references_user_metadata_%s_%s_%s', schema_name, table_name, policy_name) as cache_key from policies where schema_name not in ( '_timescaledb_cache', '_timescaledb_catalog', '_timescaledb_config', '_timescaledb_internal', 'auth', 'cron', 'extensions', 'graphql', 'graphql_public', 'information_schema', 'net', 'pgroonga', 'pgsodium', 'pgsodium_masks', 'pgtle', 'pgbouncer', 'pg_catalog', 'pgtle', 'realtime', 'repack', 'storage', 'supabase_functions', 'supabase_migrations', 'tiger', 'topology', 'vault' ) and ( -- Example: auth.jwt() -> 'user_metadata' -- False positives are possible, but it isn't practical to string match -- If false positive rate is too high, this expression can iterate qual like '%auth.jwt()%user_metadata%' or qual like '%current_setting(%request.jwt.claims%)%user_metadata%' or with_check like '%auth.jwt()%user_metadata%' or with_check like '%current_setting(%request.jwt.claims%)%user_metadata%' )) union all ( select 'materialized_view_in_api' as name, 'Materialized View in API' as title, 'WARN' as level, 'EXTERNAL' as facing, array['SECURITY'] as categories, 'Detects materialized views that are accessible over the Data APIs.' as description, format( 'Materialized view \`%s.%s\` is selectable by anon or authenticated roles', n.nspname, c.relname ) as detail, '${DOCS_URL}/guides/database/database-linter?lint=0016_materialized_view_in_api' as remediation, jsonb_build_object( 'schema', n.nspname, 'name', c.relname, 'type', 'materialized view' ) as metadata, format( 'materialized_view_in_api_%s_%s', n.nspname, c.relname ) as cache_key from pg_catalog.pg_class c join pg_catalog.pg_namespace n on n.oid = c.relnamespace left join pg_catalog.pg_depend dep on c.oid = dep.objid and dep.deptype = 'e' where c.relkind = 'm' and ( pg_catalog.has_table_privilege('anon', c.oid, 'SELECT') or pg_catalog.has_table_privilege('authenticated', c.oid, 'SELECT') ) and n.nspname = any(array(select trim(unnest(string_to_array(current_setting('pgrst.db_schemas', 't'), ','))))) and n.nspname not in ( '_timescaledb_cache', '_timescaledb_catalog', '_timescaledb_config', '_timescaledb_internal', 'auth', 'cron', 'extensions', 'graphql', 'graphql_public', 'information_schema', 'net', 'pgroonga', 'pgsodium', 'pgsodium_masks', 'pgtle', 'pgbouncer', 'pg_catalog', 'pgtle', 'realtime', 'repack', 'storage', 'supabase_functions', 'supabase_migrations', 'tiger', 'topology', 'vault' ) and dep.objid is null) union all ( select 'foreign_table_in_api' as name, 'Foreign Table in API' as title, 'WARN' as level, 'EXTERNAL' as facing, array['SECURITY'] as categories, 'Detects foreign tables that are accessible over APIs. Foreign tables do not respect row level security policies.' as description, format( 'Foreign table \`%s.%s\` is accessible over APIs', n.nspname, c.relname ) as detail, '${DOCS_URL}/guides/database/database-linter?lint=0017_foreign_table_in_api' as remediation, jsonb_build_object( 'schema', n.nspname, 'name', c.relname, 'type', 'foreign table' ) as metadata, format( 'foreign_table_in_api_%s_%s', n.nspname, c.relname ) as cache_key from pg_catalog.pg_class c join pg_catalog.pg_namespace n on n.oid = c.relnamespace left join pg_catalog.pg_depend dep on c.oid = dep.objid and dep.deptype = 'e' where c.relkind = 'f' and ( pg_catalog.has_table_privilege('anon', c.oid, 'SELECT') or pg_catalog.has_table_privilege('authenticated', c.oid, 'SELECT') ) and n.nspname = any(array(select trim(unnest(string_to_array(current_setting('pgrst.db_schemas', 't'), ','))))) and n.nspname not in ( '_timescaledb_cache', '_timescaledb_catalog', '_timescaledb_config', '_timescaledb_internal', 'auth', 'cron', 'extensions', 'graphql', 'graphql_public', 'information_schema', 'net', 'pgroonga', 'pgsodium', 'pgsodium_masks', 'pgtle', 'pgbouncer', 'pg_catalog', 'pgtle', 'realtime', 'repack', 'storage', 'supabase_functions', 'supabase_migrations', 'tiger', 'topology', 'vault' ) and dep.objid is null) union all ( select 'unsupported_reg_types' as name, 'Unsupported reg types' as title, 'WARN' as level, 'EXTERNAL' as facing, array['SECURITY'] as categories, 'Identifies columns using unsupported reg* types outside pg_catalog schema, which prevents database upgrades using pg_upgrade.' as description, format( 'Table \`%s.%s\` has a column \`%s\` with unsupported reg* type \`%s\`.', n.nspname, c.relname, a.attname, t.typname ) as detail, '${DOCS_URL}/guides/database/database-linter?lint=unsupported_reg_types' as remediation, jsonb_build_object( 'schema', n.nspname, 'name', c.relname, 'column', a.attname, 'type', 'table' ) as metadata, format( 'unsupported_reg_types_%s_%s_%s', n.nspname, c.relname, a.attname ) AS cache_key from pg_catalog.pg_attribute a join pg_catalog.pg_class c on a.attrelid = c.oid join pg_catalog.pg_namespace n on c.relnamespace = n.oid join pg_catalog.pg_type t on a.atttypid = t.oid join pg_catalog.pg_namespace tn on t.typnamespace = tn.oid where tn.nspname = 'pg_catalog' and t.typname in ('regcollation', 'regconfig', 'regdictionary', 'regnamespace', 'regoper', 'regoperator', 'regproc', 'regprocedure') and n.nspname not in ('pg_catalog', 'information_schema', 'pgsodium'))`.trim()