Skip to content

Commit

Permalink
Add USER_ENDPOINTS_ENABLED to helm chart values and documentation (#4876
Browse files Browse the repository at this point in the history
)

Signed-off-by: Thomas Quandt <[email protected]>
  • Loading branch information
thquad authored and richard-cox committed Apr 16, 2021
1 parent 9f0ed4d commit 0f13b56
Show file tree
Hide file tree
Showing 6 changed files with 14 additions and 2 deletions.
1 change: 1 addition & 0 deletions deploy/kubernetes/console/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -78,6 +78,7 @@ The following table lists the configurable parameters of the Stratos Helm chart
|console.userInviteSubject|Email subject of the user invitation message||
|console.techPreview|Enable/disable Tech Preview features|false|
|console.apiKeysEnabled|Enable/disable API key-based access to Stratos API (disabled, admin_only, all_users)|admin_only|
|console.userEndpointsEnabled|Enable/disable user endpoints or let only admins view and manage user endpoints (disabled, admin_only, enabled)|disabled|
|console.ui.listMaxSize|Override the default maximum number of entities that a configured list can fetch. When a list meets this amount additional pages are not fetched||
|console.ui.listAllowLoadMaxed|If the maximum list size is met give the user the option to fetch all results|false|
|console.localAdminPassword|Use local admin user instead of UAA - set to a password to enable||
Expand Down
2 changes: 2 additions & 0 deletions deploy/kubernetes/console/templates/deployment.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -288,6 +288,8 @@ spec:
value: {{ default "false" .Values.console.techPreview | quote }}
- name: API_KEYS_ENABLED
value: {{ default "admin_only" .Values.console.apiKeysEnabled | quote }}
- name: USER_ENDPOINTS_ENABLED
value: {{ default "disabled" .Values.console.userEndpointsEnabled | quote }}
- name: HELM_CACHE_FOLDER
value: /helm-cache
{{- if .Values.console.ui }}
Expand Down
5 changes: 5 additions & 0 deletions deploy/kubernetes/console/values.schema.json
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,11 @@
"enum": ["disabled", "admin_only", "all_users"],
"description": "Enable API keys for admins, all users or nobody"
},
"userEndpointsEnabled": {
"type": "string",
"enum": ["disabled", "admin_only", "enabled"],
"description": "Enable, disable or let only admins view user endpoints"
},
"autoRegisterCF": {
"type": ["string", "null"]
},
Expand Down
3 changes: 3 additions & 0 deletions deploy/kubernetes/console/values.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,9 @@ console:
# Enable/disable API key-based access to Stratos API
apiKeysEnabled: admin_only

# Enable/disable user endpoints
userEndpointsEnabled: disabled

ui:
# Override the default maximum number of entities that a configured list can fetch. When a list meets this amount additional pages are not fetched
listMaxSize:
Expand Down
1 change: 1 addition & 0 deletions website/docs/deploy/kubernetes/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,6 +79,7 @@ The following table lists the configurable parameters of the Stratos Helm chart
|console.templatesConfigMapName|Name of config map that provides the template files for user invitation emails||
|console.userInviteSubject|Email subject of the user invitation message||
|console.techPreview|Enable/disable Tech Preview features|false|
|console.userEndpointsEnabled|Enable/disable user endpoints or let only admins view and manage user endpoints (disabled, admin_only, enabled)|disabled|
|console.ui.listMaxSize|Override the default maximum number of entities that a configured list can fetch. When a list meets this amount additional pages are not fetched||
|console.ui.listAllowLoadMaxed|If the maximum list size is met give the user the option to fetch all results|false|
|console.localAdminPassword|Use local admin user instead of UAA - set to a password to enable||
Expand Down
4 changes: 2 additions & 2 deletions website/docs/endpoints/cf/user-endpoints.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,15 +11,15 @@ Stratos provides a way for users to create endpoints without the need to be an a

In order to enable User Endpoints support in Stratos:

1. The environment variable `USER_ENDPOINTS_ENABLED` must be set
1. The environment variable `USER_ENDPOINTS_ENABLED` or helm chart value `console.userEndpointsEnabled` must be set
2. The UAA client used by Stratos needs an additional scope `stratos.endpointadmin`
3. Users need to have the `stratos.endpointadmin` group attached to them

Once all steps have been completed, user within the `stratos.endpointadmin` group are allowed to create endpoints. Endpoints created by users are only visible to their respective user and all admins.

## Environment variable

`USER_ENDPOINTS_ENABLED` can be set to three different states:
`USER_ENDPOINTS_ENABLED` or helm chart value `console.userEndpointsEnabled` can be set to three different states:

1. `disabled` (default) will disable this feature. Neither admins nor users will see user endpoints.
2. `admin_only` will hide user endpoints from users. Admins can still see all endpoints created by users.
Expand Down

0 comments on commit 0f13b56

Please sign in to comment.