tyler.durden/icingaweb2
1
0
Fork 0
mirror of https://github.com/Icinga/icingaweb2.git synced 2025-07-25 23:04:51 +02:00
Code Issues Packages Projects Releases Wiki Activity

security documentation: Cleanup permission lists

Browse Source
This commit is contained in:
Johannes Meyer 2015-06-18 15:55:58 +02:00
parent b154e13ad9
commit cf2c2c3ee0
1 changed files with 4 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
doc/security.md
View File

@ -110,11 +110,11 @@ To get you a quick start, here is an example of what a role definition could loo
[winadmin] [winadmin]
users = "jdoe, janedoe" users = "jdoe, janedoe"
groups = "admin" groups = "admin"
permissions = "config/application/*, monitoring/commands/schedule-check" permissions = "config/*, monitoring/commands/schedule-check"
monitoring/filter/objects = "host_name=*win*" monitoring/filter/objects = "host_name=*win*"
This example creates a role called **winadmin**, that grants all permissions in `config/application/*` and `monitoring/commands/schedule-check` and additionally only This example creates a role called **winadmin**, that grants all permissions in `config/*` and `monitoring/commands/schedule-check` and additionally only
allows the hosts and services that match the filter `host_name=*win*` to be displayed. The users allows the hosts and services that match the filter `host_name=*win*` to be displayed. The users
**jdoe** and **janedoe** and all members of the group **admin** will be affected **jdoe** and **janedoe** and all members of the group **admin** will be affected
by this role. by this role.
@ -142,8 +142,8 @@ all actions are **prohibited** and must be allowed explicitly by a role for any
Each action in Icinga Web 2 is denoted by a **namespaced key**, which is used to order and Each action in Icinga Web 2 is denoted by a **namespaced key**, which is used to order and
group those actions. All actions that affect the configuration of Icinga Web 2, are in a group those actions. All actions that affect the configuration of Icinga Web 2, are in a
namespace called **config**, while all configurations that affect authentication namespace called **config**, while all configurations that affect modules
are in the namespace `config/authentication` are in the namespace `config/modules`
**Wildcards** can be used to grant permission for all actions in a certain namespace. **Wildcards** can be used to grant permission for all actions in a certain namespace.
The permission `config/*` would grant permission to all configuration actions, The permission `config/*` would grant permission to all configuration actions,
@ -158,27 +158,6 @@ through a group) all permissions can simply be added together to get the users a
-------------------------------------|----------------------------------------------------------------- -------------------------------------|-----------------------------------------------------------------
* | Allow everything, including module-specific permissions * | Allow everything, including module-specific permissions
config/* | Allow all configuration actions config/* | Allow all configuration actions
config/application/* | Allow configuring IcingaWeb2
config/application/general | Allow general settings, like logging or preferences
config/application/resources | Allow changing resources for retrieving data
config/application/userbackend | Allow changing backends for retrieving available users
config/application/usergroupbackend | Allow changing backends for retrieving available groups
config/authentication/* | Allow configuring IcingaWeb2 authentication mechanisms
config/authentication/users/* | Allow all user actions
config/authentication/users/show | Allow displaying avilable users
config/authentication/users/add | Allow adding a new user to the backend
config/authentication/users/edit | Allow editing an existing user in the backend
config/authentication/users/remove | Allow removing an existing user from the backend
config/authentication/groups/* | Allow all group actions
config/authentication/groups/show | Allow displaying all available groups
config/authentication/groups/add | Allow adding a new group to the backend
config/authentication/groups/edit | Allow editing existing groups in a backend
config/authentication/groups/remove | Allow removing existing groups from the backend
config/authentication/roles/* | Allow all role actions
config/authentication/roles/add | Allow adding a new role
config/authentication/roles/show | Allow displaying available roles
config/authentication/roles/edit | Allow changing an existing role
config/authentication/roles/remove | Allow removing an existing row
config/modules | Allow enabling or disabling modules config/modules | Allow enabling or disabling modules