Page Comparison

Page Properties

hidden	true
id	rDOC

Product Version
Report Note
Assignee	Martin

Resources & Remarks

Version 2.4 - options" ... "synchronousContentAnalysis": true (OKTO-4309)

Modification History

Name	Date	Product Version	Action
Antje	08 FEB 2021	2.4	New page properties macro.
Antje	12 FEB 2021	2020 Winter	rDOC
Agnieszka	15 FEB 2021	2020 Winter	rLANG
Martin	20 April	2021 Summer	New parameter `customMicroserviceOnDelete`

Martin: mit 2021 Autumn Alpha5 Das Password im Profile verschlüsselt gespeichert. Wird das Profile ausgelesen, wird nur das verschlüsselt Password mit einem Prefix ausgegeben. Bitte die Ausgangspassworte sorgfältig aufbewahren!
Bitte auch nochmals den Hinweis beim GET Aufruf geben.

As of Version product version 2020 Winter | component version 1.0

Request Method POST

Response Format HTTP status code

Description

Excerpt
Updates the specific 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 one profile.

The following yuuvis® roles are set per default for each tenant:

YUUVIS_DEFAULT (briefly: full access to every object via default role set)
YUUVIS_CREATE_OBJECT (briefly: allowed to create objects)
YUUVIS_MANAGE_SETTINGS (briefly: save result list column and filter configurations as standard)
YUUVIS_TENANT_ADMIN (briefly: update schema, rolse set, maintain users, ... for the tenant)
YUUVIS_SYSTEM_INTEGRATOR (briefly: update global schemata and role sets for the system, create tenants)

A user admin is created for each tenant that is used for the initial tenant administration. This user has all the above roles assigned except YUUVIS_TENANT_ADMINISTRATOR.

Settings for Keycloak can be adjusted and additional roles can be created by passing the desired values for the corresponding parameters:

section general (These set parameters can be seen in the Keycloak GUI, realm setting Themes.)
As of RC3 (tag '1.2.0-rc1):
- parameter displayNameHTML
  Define the branding on the login page. If not specified, the Keycloak realm HTML Display name will be set by default to "<div class="yuv-brand-logo">${DISPLAY_TENANT_NAME}</div>".
- parameter supportedLocales
  Set the languages that should be offered for selection in the login dialog. The default locales are en for English and de for German. Find the possible locales in the documentation of Keycloak.
- parameter defaultLocale
  Set the locale do specify the language that should be used for the invitation email. The default locale is en.
section roles:
- Define additional roles (in addition to the pre-definied role set), each of them with the title role and a description.
section user:
- Create standard users and assign roles to them. You may create technical users for administrating the schema, for example.
  As of RC3 (tag '1.2.0-rc1): If you want to invite the created user via email, set "withInvitation": "true". The default value is false.
  Attention: if "true" the email section with the parameters must be set that match the installed smtp email service.
Section email:
Set up all email keys for sending e.g. invitations for newly created users via your configured email service.
The mandatory keys are host, username and password

own tenant creation profile.

All available parameters are described here:
>> Tenant Creation Profile

Meaning of the response HTTP status codes:

HTTP Status Code	Meaning
`201 CREATED`	SuccessSuccessful, the tenant with the specified `name` has been created.
`401 UNAUTHORIZED`	The call was unauthorized.

Request Example

Panel

POST /tenant-management/api-tm/system/profile HTTP/1.1

{
     "general": {
          "displayNameHTML": "<div class=\"yuv-brand-logo\">${DISPLAY_TENANT_NAME}</div>",
          "customMicroservice": "https://myCustomMicroserviceURL",

"myCustomMicroservice

"customMicroserviceOnDelete": "https://myCustomMicroserviceOnDeleteURL",
          "supportedLocales": ["en","de","es"],
          "defaultLocale": "es"
,      },

     "email": {
        "host": "myemailservice.com",
        "port": 25,
        "fromDisplayName": "myHostName",
        "from": "myemailaddress",
        "enableSSL": true,
        "enableStartTLS": true,
        "enableAuthentication": true,
        "username": "emailserviceuser",
        "password": "

thisisaverystrongpassword

PaswordWith8Characters1Uppercase1SpecialNoUserName"
      },

     "roles": [ 
         {
             "role": "Role 1",
             "description": "Description of Role 1"
         }, ...    ],

    "user": {
       "users": [
          {

"username": "

ira1

annebraun",

"email": "

grasshoff@optimal

grasshoffbraun@optimal-systems.de",

"firstName": "

Irina

Anne",

"lastName": "

Graßhoff

Braun",

"roles": ["YUUVIS_DEFAULT"],

"password": "

thisisasecureinitialpasswordtheuserisrequestedtochangeafterfirstlogin

PaswordWith8Characters1Uppercase1SpecialNoUserName",
 			"temporaryPassword": false,
            "enabled": true

},

     ...
    ],

        "withInvitation": true
    }
}

Response Example

201 CREATED

no response body

...

Versions Compared

Old Version 42

New Version Current

Key