update openAPI & docs

Author: quentinovega

daikoku/public/swaggers/admin-api-openapi.json

@@ -865,11 +865,18 @@
               "$ref": "#/components/schemas/UserWithPermission"
             }
           },
-          "authorizedOtoroshiGroups": {
+          "authorizedEntities": {
             "type": "array",
             "nullable": true,
             "items": {
-              "type": "string"
+              "properties": {
+                "otoroshiSettingsId": {
+                  "type": "string"
+                }, 
+                "authorizedEntities": {
+                  "$ref": "#/components/schemas/AuthorizedEntities"
+                }
+              }
             }
           },
           "apiKeyVisibility": {

daikoku/public/swaggers/admin-api-openapi.yaml

@@ -611,11 +611,16 @@ components:
           type: array
           items:
             $ref: '#/components/schemas/UserWithPermission'
-        authorizedOtoroshiGroups:
+        authorizedEntities:
           type: array
           nullable: true
           items:
-            type: string
+            properties: 
+              otoroshiSettingsId:
+                type: string
+              authorizedEntities:
+                $ref: '#/components/schemas/AuthorizedEntities'
+
         apiKeyVisibility:
           type: string
           enum:

manual/docs/02-usages/08-tenantusage/2-teams.md

@@ -2,9 +2,7 @@
 
 Go to `settings/Organizations settings` and then click `teams` on the left menu. You should see the list of existing `teams`
 
-## Add a new team
-
-Click on the `Create` button.
+`Teams` can only be updated (or deleted) by admin, mainly to update metadata or authorizedEntities (2 properties editable only by a tenant admin).
 A team needs the folowing informations :
 
 * Tenant (By default, the current tenant)
@@ -13,6 +11,7 @@ A team needs the folowing informations :
 * Team contact, an email address for a simple contact
 * Team avatar, it could be an URl or an asset from the object manager
 * Metadata, some extra informations that will be sent with the api calls with team apikeys
+* Authorized entities, a collection of otoroshi entities visible to the team, the others are not accessible.
 
 ## Update an existing team
 Hover over team's avatar and click the `update` button (Pen icon). All the informations filled during the team creation can be overwritten.

manual/static/openapi/admin-api-openapi.json

@@ -865,11 +865,18 @@
               "$ref": "#/components/schemas/UserWithPermission"
             }
           },
-          "authorizedOtoroshiGroups": {
+          "authorizedEntities": {
             "type": "array",
             "nullable": true,
             "items": {
-              "type": "string"
+              "properties": {
+                "otoroshiSettingsId": {
+                  "type": "string"
+                }, 
+                "authorizedEntities": {
+                  "$ref": "#/components/schemas/AuthorizedEntities"
+                }
+              }
             }
           },
           "apiKeyVisibility": {
@@ -1013,7 +1020,8 @@
             }
           },
           "defaultUsagePlan": {
-            "type": "string"
+            "type": "string",
+            "nullable": true
           },
           "authorizedTeams": {
             "type": "array",
@@ -1076,7 +1084,6 @@
           "documentation",
           "visibility",
           "possibleUsagePlans",
-          "defaultUsagePlan",
           "state"
         ]
       },

manual/static/openapi/admin-api-openapi.yaml

@@ -611,11 +611,16 @@ components:
           type: array
           items:
             $ref: '#/components/schemas/UserWithPermission'
-        authorizedOtoroshiGroups:
+        authorizedEntities:
           type: array
           nullable: true
           items:
-            type: string
+            properties: 
+              otoroshiSettingsId:
+                type: string
+              authorizedEntities:
+                $ref: '#/components/schemas/AuthorizedEntities'
+
         apiKeyVisibility:
           type: string
           enum:
@@ -719,6 +724,7 @@ components:
             type: string
         defaultUsagePlan:
           type: string
+          nullable: true
         authorizedTeams:
           type: array
           nullable: true
@@ -765,7 +771,6 @@ components:
         - documentation
         - visibility
         - possibleUsagePlans
-        - defaultUsagePlan
         - state
     ApiIssueTag:
       description: ApiIssueTag