From 2b4638f6bb4e1e1cc543608fc90328124ebfaf17 Mon Sep 17 00:00:00 2001
From: Angira Kekteeva <kira@nspcc.ru>
Date: Mon, 31 Jan 2022 13:50:41 +0300
Subject: [PATCH] [#336] Update default session token rules

Signed-off-by: Angira Kekteeva <kira@nspcc.ru>
---
 authmate/authmate.go | 13 ++++++++++---
 docs/authmate.md     | 20 +++++++++++++++++---
 2 files changed, 27 insertions(+), 6 deletions(-)

diff --git a/authmate/authmate.go b/authmate/authmate.go
index 05e0442..37e921a 100644
--- a/authmate/authmate.go
+++ b/authmate/authmate.go
@@ -396,9 +396,16 @@ func buildContext(rules []byte) ([]*session.ContainerContext, error) {
 		return sessionCtxs, nil
 	}
 
-	sessionCtx := session.NewContainerContext()
-	sessionCtx.ForPut()
-	return []*session.ContainerContext{sessionCtx}, nil
+	sessionCtxPut := session.NewContainerContext()
+	sessionCtxPut.ForPut()
+
+	sessionCtxDelete := session.NewContainerContext()
+	sessionCtxDelete.ForDelete()
+
+	sessionCtxEACL := session.NewContainerContext()
+	sessionCtxEACL.ForSetEACL()
+
+	return []*session.ContainerContext{sessionCtxPut, sessionCtxDelete, sessionCtxEACL}, nil
 }
 
 func buildBearerToken(key *keys.PrivateKey, table *eacl.Table, lifetime lifetimeOptions, gateKey *keys.PublicKey) (*token.BearerToken, error) {
diff --git a/docs/authmate.md b/docs/authmate.md
index e4cb328..918eb51 100644
--- a/docs/authmate.md
+++ b/docs/authmate.md
@@ -87,7 +87,7 @@ NhLQpDnerpviUWDF77j5qyjFgavCmasJ4p (simple signature contract):
 To issue a secret means to create a Bearer and (optionally) Session tokens and
 put them as an object into a container on the NeoFS network.
 
-By default, the tool creates a container with a name `auth-container` and ACL 
+By default, the tool creates a container with a name the same as container ID in NeoFS and ACL 
 0x3c8c8cce (all operations are forbidden for `OTHERS` and `BEARER` user groups, 
 except for `GET`). 
 
@@ -128,17 +128,31 @@ it will be auto-generated with values:
 }
 ```
 
-Rules for session tokens can be set via param `session-rules` (json-string and file path allowed), the default value is:
+Rules for session tokens can be set via param `session-rules` (json-string and file path allowed).
+
+If the parameter `session-rules` is not set, `authmate` creates and puts three session tokens: 
 ```
 [
   {
     "verb": "PUT",
     "wildcard": true,
     "containerID": null
-  }
+  },
+  {
+    "verb": "DELETE",
+    "wildcard": true,
+    "containerID": null
+  },
+  {
+    "verb": "SETEACL",
+    "wildcard": true,
+    "containerID": null
+  },
 ]
 ```
 
+If you want to allow the user to create buckets you **must** put two session tokens with `PUT` and `SETEACL` rules.
+
 If `session-rules` are set, but `create-session-token` is not, no session
 token will be created.