Merge branch 'label-permissions' into 'master'

Label permissions

* Update label permission docs
* Add authorisation to labels via API

See merge request !1020

doc/permissions/permissions.md

@@ -23,6 +23,7 @@ If a user is a GitLab administrator they receive all permissions.
 | Add tags                              |         |            | ✓           | ✓        | ✓      |
 | Write a wiki                          |         |            | ✓           | ✓        | ✓      |
 | Manage issue tracker                  |         |            | ✓           | ✓        | ✓      |
+| Manage labels                         |         |            | ✓           | ✓        | ✓      |
 | Create new milestones                 |         |            |             | ✓        | ✓      |
 | Add new team members                  |         |            |             | ✓        | ✓      |
 | Push to protected branches            |         |            |             | ✓        | ✓      |

lib/api/labels.rb

@@ -24,6 +24,7 @@ module API
       # Example Request:
       #   POST /projects/:id/labels
       post ':id/labels' do
+        authorize! :admin_label, user_project
         required_attributes! [:name, :color]
         attrs = attributes_for_keys [:name, :color]
@@ -51,6 +52,7 @@ module API
       # Example Request:
       #   DELETE /projects/:id/labels
       delete ':id/labels' do
+        authorize! :admin_label, user_project
         required_attributes! [:name]
         label = user_project.find_label(params[:name])
@@ -71,6 +73,7 @@ module API
       # Example Request:
       #   PUT /projects/:id/labels
       put ':id/labels' do
+        authorize! :admin_label, user_project
         required_attributes! [:name]
         label = user_project.find_label(params[:name])