swarming: switch to a 'capability focused' ACL system

appengine/swarming/proto/config.proto

Index: appengine/swarming/proto/config.proto
diff --git a/appengine/swarming/proto/config.proto b/appengine/swarming/proto/config.proto
index ea5e6f3092134b0cb2a21a200b0c4fb3930f105a..cf66efef5c73f6a4d63ee42990c948c07389974d 100644
--- a/appengine/swarming/proto/config.proto
+++ b/appengine/swarming/proto/config.proto
@@ -153,11 +153,39 @@ message DimensionACLs {
 
 message AuthSettings {
   // Members of this group have full administrative access.
+  //
+  // Grants:
+  // - config view and edit
+  // - all of bot_bootstrap_group membership
+  // - all of privileged_users_group membership
   optional string admins_group = 1;

[Vadim Sh., 2017/07/25 17:02:50]

nit: \n (and in other fields). With such big multi line comments new lines
between fields will make this stuff more readable.

[M-A Ruel, 2017/07/25 18:11:39]

Done.

   // Members of this group can fetch swarming bot code and bootstrap bots.
+  //
+  // Grants:
+  // - bot create: create a token to annonymously fetch the bot code.

[Vadim Sh., 2017/07/25 17:02:50]

typo: anonymously

[M-A Ruel, 2017/07/25 18:11:39]

Done.

   optional string bot_bootstrap_group = 2;
   // Members of this group can schedule tasks and see everyone else's tasks.
+  //
+  // Grants:
+  // - cancel any task
+  // - delete or terminate any bot
+  // - all of view_all_bots_group membership
+  // - all of view_all_tasks_group membership
   optional string privileged_users_group = 3;
   // Members of this group can schedule tasks and see only their own tasks.
+  //
+  // Grants:
+  // - create a task
+  // - view and edit own task
   optional string users_group = 4;
+  // Members of this group can view all bots. This is a read-only group.
+  //
+  // Grants:
+  // - view all bots
+  optional string view_all_bots_group = 5;
+  // Members of this group can view all tasks. This is a read-only group.
+  //
+  // Grants:
+  // - view all tasks
+  optional string view_all_tasks_group = 6;
 }