summaryrefslogtreecommitdiffstats
path: root/doc/server/plugins/misc
diff options
context:
space:
mode:
authorChris St. Pierre <chris.a.st.pierre@gmail.com>2013-08-19 09:37:59 -0400
committerChris St. Pierre <chris.a.st.pierre@gmail.com>2013-08-19 09:37:59 -0400
commit6e3d93ca09048bbda6f2dd0119aaa576ed3bb743 (patch)
tree089cc93a8eb7c26215c300a306ad2e227eba3259 /doc/server/plugins/misc
parentebfdc702566ca59f8bf44e49c973d54073bdea14 (diff)
downloadbcfg2-6e3d93ca09048bbda6f2dd0119aaa576ed3bb743.tar.gz
bcfg2-6e3d93ca09048bbda6f2dd0119aaa576ed3bb743.tar.bz2
bcfg2-6e3d93ca09048bbda6f2dd0119aaa576ed3bb743.zip
Core: Added default ACLs
Since we're exposing more stuff via XML-RPC, this adds a default, fairly restrictive ACL plugin if no other ClientACLs plugin is loaded. This makes us secure by default.
Diffstat (limited to 'doc/server/plugins/misc')
-rw-r--r--doc/server/plugins/misc/acl.txt33
1 files changed, 33 insertions, 0 deletions
diff --git a/doc/server/plugins/misc/acl.txt b/doc/server/plugins/misc/acl.txt
index 45780bef8..226b56a44 100644
--- a/doc/server/plugins/misc/acl.txt
+++ b/doc/server/plugins/misc/acl.txt
@@ -200,3 +200,36 @@ could also do something like ``*.toggle_debug`` to allow a host to
enable or disable debugging for all plugins.
No other bash globbing is supported.
+
+Examples
+========
+
+The :ref:`default ACL list <server-access-control>` can be described
+in ``ip.xml`` fairly simply:
+
+.. code-block:: xml
+
+ <ACL>
+ <Allow address="127.0.0.1" method="*.*"/>
+ <Allow address="127.0.0.1" method="*"/>
+ <Deny method="*.*"/>
+ <Deny method="*_debug"/>
+ <Deny method="get_statistics"/>
+ <Allow method="*"/>
+ </ACL>
+
+A basic configuration that is still very secure but perhaps more
+functional could be given in ``metadata.xml``:
+
+.. code-block:: xml
+
+ <ACL>
+ <Group name="bcfg2-server">
+ <Allow method="*.*"/>
+ <Allow method="*"/>
+ </Group>
+ <Deny method="*.*"/>
+ <Deny method="*_debug"/>
+ <Deny method="get_statistics"/>
+ <Allow method="*"/>
+ </ACL>