mirror of
https://github.com/postgres/postgres.git
synced 2026-03-03 05:40:43 -05:00
491c029dbc
Building on the updatable security-barrier views work, add the ability to define policies on tables to limit the set of rows which are returned from a query and which are allowed to be added to a table. Expressions defined by the policy for filtering are added to the security barrier quals of the query, while expressions defined to check records being added to a table are added to the with-check options of the query. New top-level commands are CREATE/ALTER/DROP POLICY and are controlled by the table owner. Row Security is able to be enabled and disabled by the owner on a per-table basis using ALTER TABLE .. ENABLE/DISABLE ROW SECURITY. Per discussion, ROW SECURITY is disabled on tables by default and must be enabled for policies on the table to be used. If no policies exist on a table with ROW SECURITY enabled, a default-deny policy is used and no records will be visible. By default, row security is applied at all times except for the table owner and the superuser. A new GUC, row_security, is added which can be set to ON, OFF, or FORCE. When set to FORCE, row security will be applied even for the table owner and superusers. When set to OFF, row security will be disabled when allowed and an error will be thrown if the user does not have rights to bypass row security. Per discussion, pg_dump sets row_security = OFF by default to ensure that exports and backups will have all data in the table or will error if there are insufficient privileges to bypass row security. A new option has been added to pg_dump, --enable-row-security, to ask pg_dump to export with row security enabled. A new role capability, BYPASSRLS, which can only be set by the superuser, is added to allow other users to be able to bypass row security using row_security = OFF. Many thanks to the various individuals who have helped with the design, particularly Robert Haas for his feedback. Authors include Craig Ringer, KaiGai Kohei, Adam Brightwell, Dean Rasheed, with additional changes and rework by me. Reviewers have included all of the above, Greg Smith, Jeff McCormick, and Robert Haas.
53 lines
1.5 KiB
C
53 lines
1.5 KiB
C
/*
|
|
* pg_rowsecurity.h
|
|
* definition of the system catalog for row-security policy (pg_rowsecurity)
|
|
*
|
|
* Portions Copyright (c) 1996-2012, PostgreSQL Global Development Group
|
|
* Portions Copyright (c) 1994, Regents of the University of California
|
|
*
|
|
*/
|
|
#ifndef PG_ROWSECURITY_H
|
|
#define PG_ROWSECURITY_H
|
|
|
|
#include "catalog/genbki.h"
|
|
|
|
/* ----------------
|
|
* pg_rowsecurity definition. cpp turns this into
|
|
* typedef struct FormData_pg_rowsecurity
|
|
* ----------------
|
|
*/
|
|
#define RowSecurityRelationId 3256
|
|
|
|
CATALOG(pg_rowsecurity,3256)
|
|
{
|
|
NameData rsecpolname; /* Policy name. */
|
|
Oid rsecrelid; /* Oid of the relation with policy. */
|
|
char rseccmd; /* One of ACL_*_CHR, or \0 for all */
|
|
|
|
#ifdef CATALOG_VARLEN
|
|
Oid rsecroles[1] /* Roles associated with policy, not-NULL */
|
|
pg_node_tree rsecqual; /* Policy quals. */
|
|
pg_node_tree rsecwithcheck; /* WITH CHECK quals. */
|
|
#endif
|
|
} FormData_pg_rowsecurity;
|
|
|
|
/* ----------------
|
|
* Form_pg_rowsecurity corresponds to a pointer to a row with
|
|
* the format of pg_rowsecurity relation.
|
|
* ----------------
|
|
*/
|
|
typedef FormData_pg_rowsecurity *Form_pg_rowsecurity;
|
|
|
|
/* ----------------
|
|
* compiler constants for pg_rowsecurity
|
|
* ----------------
|
|
*/
|
|
#define Natts_pg_rowsecurity 6
|
|
#define Anum_pg_rowsecurity_rsecpolname 1
|
|
#define Anum_pg_rowsecurity_rsecrelid 2
|
|
#define Anum_pg_rowsecurity_rseccmd 3
|
|
#define Anum_pg_rowsecurity_rsecroles 4
|
|
#define Anum_pg_rowsecurity_rsecqual 5
|
|
#define Anum_pg_rowsecurity_rsecwithcheck 6
|
|
|
|
#endif /* PG_ROWSECURITY_H */
|