mirrors/postgres
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Further sepgsql documentation cleanup.

Browse Source
This commit is contained in:
Robert Haas 2011-02-03 00:23:44 -05:00
parent 4ff9dec138
commit 4c4daf6710
1 changed files with 36 additions and 144 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

176
doc/src/sgml/sepgsql.sgml
View File

@ -10,15 +10,16 @@
<para> <para>
<filename>sepgsql</> is a loadable module which supports label-based <filename>sepgsql</> is a loadable module which supports label-based
mandatory access control (MAC) based on <productname>SELinux</> security mandatory access control (MAC) based on <productname>SELinux</> security
policy. This implementation is not complete, and primarily provides policy.
protection for Data Manipulation Language statements (DML). Support for
fine-grained access control of Data Definition Language (DDL) and Data
Control Language (DCL) statements may be added in a future release.
</para> </para>
<warning>
<para> <para>
This extension won't build at all unless the installation was configured This implementation has signification limitations, and does not enforce
with <literal>--with-selinux</>. mandatory access control for all actions. See
<xref linkend="sepgsql-limitations">.
</para> </para>
</warning>
<sect2 id="sepgsql-overview"> <sect2 id="sepgsql-overview">
<title>Overview</title> <title>Overview</title>
@ -59,48 +60,18 @@
<title>Installation</title> <title>Installation</title>
<para> <para>
This module has several prerequisites. This module can only be used on <productname>Linux</productname> 2.6.28
or higher with <productname>SELinux</productname> enabled. It is not
available on any other platform, and must be explicitly enabled using
<literal>--with-selinux</>. You will also need <productname>libselinux</>
2.0.93 or higher and <productname>selinux-policy</> 3.9.13 or higher
(some distributions may backport the necessary rules into older policy
versions).
</para> </para>
<variablelist>
<varlistentry>
<term><productname>Linux kernel</productname></term>
<listitem>
<para> <para>
v2.6.28 or later with built with SELinux enabled The <command>sestatus</> command allows you to check the status of
</para> <productname>SELinux</productname>.
</listitem>
</varlistentry>
<varlistentry>
<term><productname>libselinux</productname></term>
<listitem>
<para>
v2.0.93 or later
</para>
<para>
This library provides a set of APIs to communicate with
<productname>SELinux</> in kernel.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><productname>selinux-policy</productname></term>
<listitem>
<para>
v3.9.13 or later
</para>
<para>
The default security policy provides a set of access control rules.
Some distributions may backport necessary rules to older policy versions.
</para>
</listitem>
</varlistentry>
</variablelist>
<para>
<productname>sepgsql</> needs <productname>SELinux</> being
available on the platform. You can check the current setting using
<command>sestatus</>.
<screen> <screen>
$ sestatus $ sestatus
SELinux status: enabled SELinux status: enabled
@ -115,41 +86,25 @@ Policy from config file: targeted
</para> </para>
<para> <para>
At compile time, pass the <literal>--with-selinux</> option to To use this module, you must add include <literal>sepgsql</>
the <command>configure</> script to enable this module. in <xref linkend="guc-shared-preload-libraries">. The module will not
function if loaded in any other manner. Once the module is loaded, you
<screen> should execute <filename>sepgsql.sql</filename> in each database.
$ ./configure --enable-debug --enable-cassert --with-selinux This will install functions needed for security label management, and
$ make assign initial security labels.
$ make install
</screen>
</para> </para>
<para> <para>
Following <command>initdb</>, add <literal>'$libdir/sepgsql'</> The following instructions that assume your installation is under the
to <xref linkend="guc-shared-preload-libraries"> in <filename>/usr/local/pgsql</> directory. Adjust the paths shown below as
the <filename>postgresql.conf</>. Note that <productname>sepgsql</>
must be loaded at server startup.
</para>
<para>
Next, load the <filename>sepgsql.sql</filename> script for each database.
It installs functions for security label management, and attempts to assign
initial labels to the target objects.
</para>
<para>
The following instruction assumes your installation is under the
<filename>/usr/local/pgsql</> directory, and the database cluster is in
<filename>/usr/local/pgsql/data</>. Adjust the paths shown below as
appropriate for your installaton. appropriate for your installaton.
</para> </para>
<screen> <screen>
$ initdb -D $PGDATA $ initdb
$ vi $PGDATA/postgresql.conf $ vi $PGDATA/postgresql.conf
$ for DBNAME in template0 template1 postgres; do $ for DBNAME in template0 template1 postgres; do
postgres --single -F -O -c exit_on_error=true -D $PGDATA $DBNAME \ postgres --single -F -O -c exit_on_error=true $DBNAME \
< /usr/local/pgsql/share/contrib/sepgsql.sql > /dev/null < /usr/local/pgsql/share/contrib/sepgsql.sql > /dev/null
done done
</screen> </screen>
@ -317,77 +272,15 @@ $ restorecon -R /usr/local/pgsql/
A new database object basically inherits the security label of the parent A new database object basically inherits the security label of the parent
object, except when the security policy has special rules known as object, except when the security policy has special rules known as
type-transition rules, in which case a different label may be applied. type-transition rules, in which case a different label may be applied.
The meaning of the term "parent object" varies by object class, as follows. For schemas, the parent object is the current database; for columns, it
is the corresponding table; for tables, sequences, views, and functions,
it is the containing schema.
</para> </para>
<variablelist>
<varlistentry>
<term>schema</term>
<listitem>
<para>
The parent object is the current database.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>table</term>
<listitem>
<para>
The parent object is the containing schema.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>column</term>
<listitem>
<para>
The parent object is the table.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>sequence</term>
<listitem>
<para>
The parent object is the containing schema.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>view</term>
<listitem>
<para>
The parent object is the containing schema.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>function</term>
<listitem>
<para>
The parent object is the containing schema.
</para>
</listitem>
</varlistentry>
</variablelist>
</sect3> </sect3>
<sect3> <sect3>
<title>DML Permissions</title> <title>DML Permissions</title>
<para>
This section introduces what permissions shall be checked on DML;
<literal>SELECT</>, <literal>INSERT</>, <literal>UPDATE</> and
<literal>DELETE</>.
</para>
<para>
DML statements are used to reference or modify contents within
the specified database objects; such as tables or columns.
The access rights of the client are checked on all the objects
mentioned in the given statement, and the kind of privileges checked
depend on the class of the object and the type of access.
</para>
<para> <para>
For tables, <literal>db_table:select</>, <literal>db_table:insert</>, For tables, <literal>db_table:select</>, <literal>db_table:insert</>,
<literal>db_table:update</> or <literal>db_table:delete</> is <literal>db_table:update</> or <literal>db_table:delete</> is
@ -461,7 +354,6 @@ UPDATE t1 SET x = 2, y = md5sum(y) WHERE z = 100;
</para> </para>
<para> <para>
Here are a few more corner cases.
The default database privilege system allows database superusers to The default database privilege system allows database superusers to
modify system catalogs using DML commands, and reference or modify modify system catalogs using DML commands, and reference or modify
toast tables. These operations are prohibited when toast tables. These operations are prohibited when
@ -545,13 +437,13 @@ postgres=# SELECT cid, cname, show_credit(cid) FROM customer;
<sect3> <sect3>
<title>Miscellaneous</title> <title>Miscellaneous</title>
<para> <para>
In this version, we reject the <xref linkend="sql-load"> command across We reject the <xref linkend="sql-load"> command across the board, because
the board, because any module loaded could easily circumvent security any module loaded could easily circumvent security policy enforcement.
policy enforcement.
</para> </para>
</sect3> </sect3>
</sect2> </sect2>
<sect2 id="sepgsql-limitations"> <sect2 id="sepgsql-limitations">
<title>Limitations</title> <title>Limitations</title>
@ -649,7 +541,7 @@ postgres=# SELECT cid, cname, show_credit(cid) FROM customer;
<sect2 id="sepgsql-author"> <sect2 id="sepgsql-author">
<title>Author</title> <title>Author</title>
<para> <para>
KaiGai Kohei (<email>kaigai@ak.jp.nec.com</email>) KaiGai Kohei <email>kaigai@ak.jp.nec.com</email>
</para> </para>
</sect2> </sect2>
</sect1> </sect1>