These endpoints can be used for role, group and user management for a tenant and to create and delete tenants.
This API is part of the Tenant Management Endpoints provided by the TENANT-MANAGEMENT Service and expects the corresponding requirements.
A Swagger-UI supports calling the API endpoints manually for testing: https://<domain>/tenant-management/api/swagger-ui.html.
To use these endpoints, you must have the required role YUUVIS_SYSTEM_INTEGRATOR. This means that you must have specific authorizations.
| HTTP Method as of product version | Purpose | Response Format | Description |
|---|---|---|---|
Manage Tenant Creation Profile | |||
| GET 2020 Winter | Retrieve the Keycloak System Settings | JSON | Retrieves the top-level representation of the identity provider Keycloak. |
| POST 2020 Winter | Update the Profile | HTTP status code | Updates the tenant creation profile that is used while creating a tenant of a customer with all the information that should be set up, e.g., additional roles, users, schema and client settings. Each SaaS application has its own tenant creation profile. |
| GET 2020 Winter | Retrieve the Profile | JSON | Retrieves the profile data to be used when creating new tenants. Reads the tenant creation profile. |
Manage Tenants | |||
| POST 2020 Winter | Create a Tenant | HTTP status code | Creates a new tenant with the values for the corresponding parameters specified in JSON format. Required settings for Keycloak and yuuvis® Momentum core are passed as well as custom (= product application) settings. |
| PUT 2020 Winter | Update the Data of a Tenant | HTTP status code | Update the data of the tenant specified by |
| GET 2020 Winter | Retrieve the Tenant data | JSON | Retrieves the top-level representation of the Keycloak realm specified by |
| GET 2020 Winter | Retrieve the Data of all Tenants | JSON | Retrieves the top-level representation of all realms. It will not include nested information like User and Client representations. Reads the list of all tenants. |
| DELETE 2020 Winter | Delete a Tenant | JSON | Deletes the specified |
| PATCH 2021 Summer | Update a Tenant | HTTP status code | Update a new tenant with the values for the corresponding parameters specified in JSON format. |
| GET 2020 Winter | Retrieve the Number of Users | TXT | Retrieves the number of all users of the specified |
| POST 2020 Winter | Create a User | JSON | Creates a new user with the given properties for the specified tenant. |
| PUT 2020 Winter | Update the Data of a User | HTTP status code | Update the data of the user specified by |
GET | Request a List of Users | JSON | Retrieves a list of all users of the specified |
| GET 2020 Winter | Retrieve the Data of a User | JSON | Retrieves the data of the user specified by |
| DELETE 2020 Winter | Delete a User | HTTP status code | Deletes the user specified by |
| GET 2020 Winter | Retrieve the Roles | JSON | Gets all roles of the specified |
| POST 2021 Autumn | Create a Role | JSON | Creates a new role for the specified tenant with the properties specified in JSON format in the request body. |
| DELETE 2021 Autumn | Delete a Role | JSON | Error rendering macro 'excerpt-include' : No link could be created for 'DELETE /tenant-management/api/system/tenants/{tenant}/role/{name}'. /tenant-management/api/system/tenants/{tenant}/role/{name} |
| GET 2021 Autumn | Retrieve the Groups | JSON | Retrieves all groups of the specified |
| POST 2021 Autumn | Create a Group | JSON | Creates a new group with the given properties for the specified tenant. |
| PUT 2021 Autumn | Update a Group | JSON | Updates the data of the group specified by id that is given for the specified tenant. |
| DELETE 2021 Autumn | Delete a Group | HTTP status code | Deletes the group specified by |
| GET 2021 Summer | Retrieve the Current Metrics | JSON | Reads the current metrics of the specified tenant./tenant-management/api/system/tenants/{tenant}/metrics |