Overview
The Users Manager is a simple GUI app to allow Syndeia Cloud administrators to manager users in Syndeia Cloud. Specifically it will allow you to:
- List (get) users,
- Create (add) users,
- Update permissions,
- Update permissions in bulk,
- Disable/Enable users,
- Reset user passwords
Minimum Requirements
You must have a web browser capable of running Ecmascript ("Javascript") v6+ , ex: Chrome v76+, Firefox v77+, or Edge v77+ installed
Usage
1. To launch the Users Manager, launch a web browser and navigate to http(s)://
<your_syndeia_cloud_FQDN>:
<port>/user-management
, where <your_syndeia_cloud_FQDN> = your admin portal URL, ex: mycompany.domain.com and <port> = 9000 | 9443 (for HTTPS).
Note, you can also navigate to the root URL and once logged in, click on the Users icon on the left sidebar.
2. Login with a Syndeia Cloud user that has an Admin Role, ex: super.user
. You should see a list of users enumerated, or a page similar to the following:
Note, a Syndeia Cloud administrator is user that has Role = Admin and should (at a minimum) have the one or more of the following permissions:
USER_CREATE
USER_READ
USER_MODIFY
USER_REMOVE
To create (add) a new user
3. Click the Add a user button
4. Fill out the form as required.
The following is a description of the Permissions that are currently available:
Permission Value | Description |
---|---|
| Create Syndeia Project container permission |
| Syndeia Project container modification permission |
CONTAINER_DELETE | Syndeia Project container deletion permission |
| Create repository permission |
| Repository modification permission |
| Repository deletion permission |
| Create (repository, container, artifact or relation) type permission |
| (Repository, container, artifact or relation) Type modification permission |
| (Repository, container, artifact or relation) Type deletion permission |
| Create user permission |
| User read permission |
| User modification permission |
| User remove permission |
| Artifact & relation write permission |
| Read permission for artifacts, relations, containers, and repositories |
Note, currently this form does not show the READ permission, we do not recommend removing this permission directly via the API if any others are enabled.
(for definitions of the concepts repository, container, artifact, and relation, see the conceptual model)
The following is a description of the possible Role value combinations:
Role Value | Description |
---|---|
Admin | Admin Role- allows access to the User Management page |
User | User Role- doesn't have access to the User Management page |
Admin, User | Possible (legal) but unused, currently indeterminate meaning |
5. Click Save to create (add) a new user (or Cancel to cancel).
To Update permissions
6. Click on the specified username and you should get a form window with a set of attributes / fields you can update for that user:
7. Update the desired attributes / fields.
To see a description of each permission, see how To create (add) a new user
8. Click Save to update or (or Cancel to cancel).
To Update permissions in bulk
6. Click on the checkboxes next to each username you wish to update you should get a form window with a set of attributes / fields you can update for that user:
7. Update the desired attributes / fields.
To see a description of each permission, see how To create (add) a new user
8. Click Save to update or (or Cancel to cancel).
To disable a user
9. Click on the specified username and you should get the Update user page.
10. Click the Disable user button on the left. You should get another page asking for confirmation:
11. Click Disable User to disable the user (or Cancel to cancel).
To enable a user
12. Click on the specified username and you should get the Update user page.
13. Click the Enable user button on the left. You should get another page asking for confirmation and to set the new password:
14. Type the new password then click Enable User to enable the user (or Cancel to cancel).
To reset user passwords
12. Click on the specified username and you should get the Update user page.
13. Click on the Reset Password button You should get a another page with a prompt for the new password:
Note, Reset Password is considered an admin-level operation that requires the USER_READ
& USER_MODIFY
permissions. This is distinct from the Change Password operation which does not require any permission and only applies to one's own password (see REST API for more details).
14. In the New Password field, enter the new password.
15. Click Submit to reset to the new password (or Cancel to cancel).